# 查询迁移 - ShowMigrateStatus
#### 功能介绍
查询迁移结果
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbr/cbr_04_0017.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v3/migrates
表1Query参数 
| 参数          | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| all_regions | 否    | Boolean | **参数解释：** 是否查询其他区域结果 **约束限制：** 不涉及 **取值范围：** -true：触发 -false：不触发 **默认取值：** true |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数             | 参数类型                                                                                                   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| status         | String                                                                                                 | **参数解释：** 租户迁移状态 **取值范围：** - success: 成功   - failed: 异常   - migrating: 迁移中    |
| project_status | Array of [DomainMigrateProjectStatus] objects | 项目迁移状态                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   
 表3DomainMigrateProjectStatus 
| 参数           | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| 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**
```
{
  "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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。