
# 获取指定ID的任务信息
#### 功能介绍
获取DDM任务中心指定ID的任务信息。
#### 接口约束
无。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DDM&api=ListEngines)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
- URL格式 GET /v3/{project_id}/jobs/{job_id}
  
- 参数说明
  表1路径参数 
  | 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                        |
  |:---|:---|:---|:---|
  | project_id  | 是    | String | 租户在某一region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ddm/ddm_api_01_0063.html)。 |
  | instance_id | 是    | String | DDM实例ID。                                                                                                                                                  |
     
  
  
 
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                     |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务的"获取用户Token"接口来获取。 |
   
#### 请求示例
获取指定ID的任务信息。
```
GET https://{endpoint}/v3/{project_id}/jobs/{job_id}
```
#### 响应消息
- 正常响应参数说明
  表3响应Body参数 
  | 参数  | 参数类型                                                                           | 描述     |
  |:---|:---|:---|
  | job | [JobInfo] object | 工作流信息。 |
     
   表4JobInfo 
  | 参数           | 参数类型                                                    | 描述                                                                                                          |
  |:---|:---|:---|
  | id           | String                                                  | 任务ID。                                                                                                       |
  | name         | String                                                  | 任务名称。                                                                                                       |
  | status       | String                                                  | 任务执行状态。 取值：值为"Running"，表示任务正在执行。值为"Completed"，表示任务执行成功。值为"Failed"，表示任务执行失败。 |
  | created_time | String                                                  | 创建时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。   |
  | end_time     | String                                                  | 结束时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。    |
  | process      | String                                                  | 任务执行进度。 执行中状态才返回执行进度，例如"60%"，表示任务执行进度为60%，否则返回""。                         |
  | instance     | [Instance] object | 执行任务的实例信息。                                                                                                  |
     
   表5Instance 
  | 参数   | 参数类型   | 描述    |
  |:---|:---|:---|
  | id   | String | 实例ID。 |
  | name | String | 实例名称。 |
     
  
- 正常响应示例
  ```
  {
      "job": {
          "id": "31b8ae23-c687-4d80-b7b4-42a66c9bb886",
          "name": "CreateInstance",
          "status": "Running",
          "created_time": "2018-08-06T10:41:14+0000",
          "end_time": "2018-08-06T16:41:14+0000",
          "process": "60%",
          "instance": {
              "id": "a48e43ff268f4c0e879652d65e63d0fbin09",
              "name": "DDM-test"
          }
      }
  }
  ```
  

- 异常响应 请参见[异常请求结果](https://support.huaweicloud.com/api-ddm/ddm_api_01_0059.html)。
  
 
#### 状态码
- 正常 200
  
- 异常 请参见[状态码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0060.html)。
  
 
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。
