操作场景
在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两 种获取方式：
● 调用API获取项目ID
● 从控制台获取项目ID
调用 API 获取项目 ID
项目ID可以通过调用查询指定条件下的项目列表API获取。
获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM 的终端节点，可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。
响应示例如下，其中projects下的“id”即为项目ID。
{ "projects": [ {
"domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false,
"parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "project_name",
"description": "", "links": { "next": null, "previous": null,
"self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99"
},
"id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true
} ], "links": { "next": null, "previous": null,
"self": "https://www.example.com/v3/projects"
} }
从控制台获取项目 ID
从控制台获取项目ID的步骤如下：
1. 登录管理控制台。
2. 鼠标悬停在右上角的用户名，选择下拉列表中的“我的凭证”。
在“API凭证”页面的项目列表中查看项目ID。
图7-1 查看项目 ID
A 修订记录
发布时间 更新点
2021-05-28 第十七次正式发布。
更新错误码。
2021-02-25 第十六次正式发布。
优化错误码内容。
优化API v2（推荐）内容。
2020-12-28 第十五次正式发布。
优化API v2（推荐）、错误码内容。
2020-09-15 第十四次正式发布。
新增API v2（推荐）内容。
2019-11-30 第十三次正式发布。
● 在创建任务中，优化object_key、list_file与task_type对应关系说 明。
● 在历史错误码中，新增错误码：S3M.0088。
2019-10-30 第十二次正式发布。
在终端节点中，更新OMS的Endpoint。
2019-08-31 第十一次正式发布。
● 在创建任务的请求参数中，增加参数bandwidth_policy。
● 增加修改流量控制策略一节。
● 在查询某个租户的所有任务的响应参数中，增加参数 bandwidth_policy。
● 在查询指定ID的任务的响应参数中，增加参数 bandwidth_policy。
● 在历史错误码中，增加错误码TRF.0013、TRF.0014、TRF.0301、
S3M.0083~S3M.0087。
发布时间 更新点
2019-04-29 第十次正式发布。
● 在创建任务的请求参数中，增加参数auto_restore。
● 在查询某个租户的所有任务的响应参数中，增加参数 auto_restore。
● 在查询指定ID的任务的响应参数中，增加参数auto_restore。
● 在历史错误码中，增加错误码S3M.0082、TRF.0063、TRF.0064。
2019-04-17 第九次正式发布。
● 在认证鉴权中，更新Token认证的内容。
● 在终端节点中，更新OMS的Endpoint。
● 在API示例中，参数thread_num更新取值。
● 在创建任务中，参数region、topicUrn增加说明。
● 在创建任务中，源端cloud_type参数增加取值
“HuaweiCloud”。
● 在创建任务中，dst_node数据结构的参数object_key修正为必 选。
● 在创建任务中，参数authentication_type、authentication_key 更新描述。
● 在创建任务中，参数enable_failed_object_recording更新描述。
● 在查询某个租户的所有任务中，参数authentication_type更新描 述。
● 在历史错误码中，增加错误码S3M.0168、S3M.0169、TRF.
0160。
2019-01-22 第八次正式发布。
在创建任务中，参数path更新描述。
2018-12-21 第七次正式发布。
● 在创建任务中，参数obs_bucket增加说明。
● 在创建任务中，参数protocol增加http取值。
● 在创建任务中，参数migrate_since更新描述。
● 在历史错误码中，错误码S3M.0081更新错误信息。
2018-09-30 第六次正式发布。
● 优化文档整体架构。
● 新增查询API版本接口。
● 源端cloud_type参数增加取值KingsoftCloud。
● task_type参数增加取值prefix。
● object_key参数增加废弃说明。
● 在API说明章节增加失败对象重传参数。
● 增加错误码：S3M.0079、S3M.0080、S3M.0081、S3M.0162、
S3M.0163、S3M.0167、S3M.0256、TRF.0012、TRF.0159。
发布时间 更新点
2018-08-09 第五次正式发布。
● 新增任务创建接口传入参数migrate_since, source_cdn, task_type。
● 新增任务查询接口响应参数source_cdn, task_type。
2018-06-06 第四次正式发布。
● 增加错误状态码406。
● 将object_key数据结构的参数名称“Keys”修改为“keys”。
2018-03-02 第三次正式发布。
● 增加错误码TRF.0158。
● 增加查询配额的接口。
2018-01-15 第二次正式发布。
修改源端cloud_type参数说明。
2017-09-15 第一次正式发布。