# 查询迁移项目列表
#### 功能介绍
查询迁移项目列表。创建迁移项目之后，调用该接口，根据项目名称，获取项目ID。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=UGO&api=ListMigrationProjects)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
GET /v1/{project_id}/migration-projects
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                              |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ugo/ugo_05_0025.html)。 |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                                              |
|:---|:---|:---|:---|
| offset | 否    | Integer | 分页查询的偏移量。 最小值：**0** 最大值：**99** 缺省值：**0**    |
| limit  | 否    | Integer | 每页显示的条目数量。 最小值：**1** 最大值：**100** 缺省值：**10** |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 从IAM服务获取的用户Token。 |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数                 | 参数类型                                                            | 描述          |
|:---|:---|:---|
| migration_projects | Array of [表5] objects | 当前页的迁移项目列表。 |
| total_count        | Integer                                                         | 迁移项目总数。     |
   
 表5MigrationProject 
| 参数                       | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| migration_project_id     | Integer | 迁移项目ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| migration_project_name   | String  | 迁移项目名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| evaluation_project_id    | Integer | 评估项目ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| evaluation_project_name  | String  | 评估项目名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| migration_project_status | String  | 迁移项目状态。 枚举值： - **READY**  - **NOT_READY**                                                                                                                                                                                                                                                                   |
| permission_check_status  | String  | 目标库权限检查状态。 枚举值： - **SUCCESS** **成功**  - **FAILED** **失败**  - **WAITING** **等待**  - **PENDING** **告警**  - **IGNORE** **忽略**   |
| resource_id              | String  | 资源ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| created_time             | String  | 创建时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| updated_time             | String  | 更新时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
#### 请求示例
获取迁移项目列表。
```
POST https://{endpoint}/v1/0ac6eb2c8000d2ee2fd9c006dededbe6/migration-projects?offset=0&limit=2
```
#### 响应示例
**状态码： 200**
请求成功。
```
{ 
  "migration_projects" : [ { 
    "migration_project_id" : 243, 
    "migration_project_name" : "OPEN_API_MIGRATION", 
    "evaluation_project_id" : 191, 
    "evaluation_project_name" : "OPEN_API_EVALUATION", 
    "migration_project_status" : "READY", 
    "permission_check_status" : "SUCCESS", 
    "resource_id" : "28c045f5-7941-4a2c-85d2-8587334bcacc", 
    "created_time" : "2022-06-20T06:38:52Z", 
    "updated_time" : "2022-06-20T06:38:52Z" 
  }, { 
    "migration_project_id" : 242, 
    "migration_project_name" : "ugo_test", 
    "evaluation_project_id" : 191, 
    "evaluation_project_name" : "OPEN_API_EVALUATION", 
    "migration_project_status" : "READY", 
    "permission_check_status" : "SUCCESS", 
    "resource_id" : "19596ba7-8680-47dd-a67a-d567d7535601", 
    "created_time" : "2022-06-20T04:11:13Z", 
    "updated_time" : "2022-06-20T04:11:13Z" 
  } ], 
  "total_count" : 8 
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 请求成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ugo/ugo_05_0024.html)。