# 查询分片变更任务详情V3
#### 功能介绍
查询分片变更任务详情
#### URI
GET /v3/{project_id}/instances/{instance_id}/databases/{db_name}/migration/jobs/{job_id}
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                   |
|:---|:---|:---|:---|
| project_id  | 是    | String | 租户在某一region下的project ID。                                                             |
| instance_id | 是    | String | DDM实例ID。                                                                             |
| db_name     | 是    | String | 逻辑库名称。                                                                               |
| job_id      | 是    | String | 任务流ID。参数获取，参见[分片变更预校验](https://support.huaweicloud.com/api-ddm/MigrateLogicDb.html)。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                         |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数                     | 参数类型                                                                                              | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| instance_name          | String                                                                                            | 实例名称。                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| original_shard_num     | Integer                                                                                           | 变更前逻辑库总分片数。                                                                                                                                                                                                                                                                                                                                                                                                                            |
| after_shard_num        | Integer                                                                                           | 变更后逻辑库总分片数。                                                                                                                                                                                                                                                                                                                                                                                                                            |
| original_dn_info_list  | Array of [MigrateDnInfoOpenResponse] objects | 变更前数据节点列表。                                                                                                                                                                                                                                                                                                                                                                                                                             |
| after_dn_info_list     | Array of [MigrateDnInfoOpenResponse] objects | 变更后数据节点列表。                                                                                                                                                                                                                                                                                                                                                                                                                             |
| switch_route_is_manual | Boolean                                                                                           | 切换策略是否手动。 - 手动切换策略：true  - 自动切换策略：false   |
| auto_switch_begin_time | String                                                                                            | 自动切换开始时间。（hh:mm:ss格式，例如17:00:00）                                                                                                                                                                                                                                                                                                                                                                                                       |
| auto_switch_end_time   | String                                                                                            | 自动切换结束时间。（hh:mm:ss格式，例如18:00:00）                                                                                                                                                                                                                                                                                                                                                                                                       |
| node_id_for_migrate    | String                                                                                            | 分片变更的节点。                                                                                                                                                                                                                                                                                                                                                                                                                               |
| is_exclusive           | Boolean                                                                                           | 是否是独占式。 - 独占式：true  - 非独占式：false                  |
   
 表4MigrateDnInfoOpenResponse 
| 参数               | 参数类型   | 描述       |
|:---|:---|:---|
| dn_instance_id   | String | rds实例id。 |
| dn_instance_name | String | rds实例名称。 |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误消息。 |
   
**状态码：500**
表6响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误消息。 |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
```
{
  "instance_name": "UTS-src",
  "original_shard_num": 8,
  "after_shard_num": 9,
  "original_dn_info_list": [
    {
      "dn_instance_id": "7edae0250ebc464897bd92b8d3e8b769in01",
      "dn_instance_name": "UTS-rds-src"
    }
  ],
  "after_dn_info_list": [
    {
      "dn_instance_id": "7edae0250ebc464897bd92b8d3e8b769in01",
      "dn_instance_name": "UTS-rds-src"
    }
  ],
  "switch_route_is_manual": true,
  "auto_switch_begin_time": "",
  "auto_switch_end_time": "",
  "node_id_for_migrate": "0c12161a26a4426c9bc72efe4ff05224no09",
  "is_exclusive": false
}
```
**状态码：400**
bad request
```
{
  "error_msg" : "Parameter error.",
  "error_code" : "DBS.280001"
}
```
**状态码：500**
server error
```
{
  "error_msg" : "Parameter error.",
  "error_code" : "DBS.280001"
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | ok           |
| 400 | bad request  |
| 500 | server error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。