文档首页/ 云备份 CBR/ API参考/ API/ 项目/ 查询迁移 - ShowMigrateStatus
更新时间:2026-07-21 GMT+08:00
分享

查询迁移 - ShowMigrateStatus

功能介绍

查询迁移结果

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v3/migrates

表1 Query参数

参数

是否必选

参数类型

描述

all_regions

Boolean

参数解释:

是否查询其他区域结果

约束限制:

不涉及

取值范围:

-true:触发

-false:不触发

默认取值:

true

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

status

String

参数解释:

租户迁移状态

取值范围:

  • success: 成功

  • failed: 异常

  • migrating: 迁移中

project_status

Array of DomainMigrateProjectStatus objects

项目迁移状态

表3 DomainMigrateProjectStatus

参数

参数类型

描述

status

String

参数解释:

租户迁移状态

取值范围:

  • success: 成功

  • failed: 异常

  • migrating: 迁移中

project_id

String

参数解释:

项目ID

取值范围:

不涉及

project_name

String

参数解释:

项目名称

取值范围:

不涉及

region_id

String

参数解释:

区域ID

取值范围:

不涉及

progress

Integer

参数解释:

迁移进度

取值范围:

0-100

fail_code

Integer

参数解释:

失败错误码(仅当项目状态为失败时才有该参数)。

取值范围:

不涉及

fail_reason

String

参数解释:

失败原因(仅当项目状态为失败时才有该参数)

取值范围:

不涉及

请求示例

GET https://{endpoint}/v3/migrates

响应示例

状态码:200

OK

{
  "status" : "failed",
  "project_status" : [ {
    "status" : "failed",
    "progress" : 1,
    "project_id" : "fe1431a61f4242dd87e548f8f42ec0b4",
    "project_name" : "cn-north-7",
    "region_id" : "cn-north-7",
    "fail_code" : 4002,
    "fail_reason" : "An error occurred when converting models: dictionary keys changed during iteration."
  }, {
    "status" : "success",
    "progress" : 100,
    "project_id" : "bccd81411c254e6890fe88d2f2ce406b",
    "project_name" : "cn-north-7-virtual",
    "region_id" : "cn-north-7"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档