# 查询系统任务详情 - ListSystemTasks
#### 功能介绍
本接口用于查询异步任务详情。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DGC/doc?api=ListSystemTasks)中调试该接口，支持自动认证鉴权。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dataartsstudio/abcd.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
- URI格式 GET /v1/{project_id}/system-tasks/{task_id}
  

- 参数说明
  表1URI参数说明 
  | 参数名        | 是否必选 | 参数类型   | 说明                                                                                                                   |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 项目编号，获取方法请参见[项目ID和账号ID](https://support.huaweicloud.com/api-dataartsstudio/projectid_accountid.html)。                |
  | task_id    | 是    | String | 任务ID，获取方法请参见[导入作业 - ImportJob](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0090.html)的响应参数。 |
     
  
 
#### 请求参数
表2请求Header参数 
| 参数名       | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| workspace | 否    | String | 工作空间id。获取方法请参见[实例ID和工作空间ID](https://support.huaweicloud.com/api-dataartsstudio/dataartsstudio_02_0350.html)。 - 如果不设置该参数，默认查询default工作空间下的数据。  - 如果需要查询其他工作空间的数据，需要带上该消息头。 说明： - 多个DataArts Studio实例需要指定工作空间。  - 当工作空间里面没有default工作空间时，工作空间为必填参数，否则会报错。      |
   
#### 响应参数
表3参数说明 
| 参数名        | 是否必选 | 参数类型            | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| id         | 是    | String          | 任务ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| name       | 是    | String          | 任务名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| startTime  | 是    | Long            | 开始时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| endTime    | 否    | Long            | 结束时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| lastUpdate | 是    | Long            | 更新时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| status     | 是    | String          | 状态： - RUNNING  - SUCCESSFUL  - FAILED   |
| projectId  | 否    | String          | 项目编号。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| subtasks   | 否    | List\<SubTask\> | 子任务，参考[表4]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
 表4SubTask参数说明 
| 参数名        | 是否必选 | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| id         | 是    | String | 子任务ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| name       | 是    | String | 子任务名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| lastUpdate | 是    | Long   | 更新时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| status     | 是    | String | 状态： - RUNNING  - SUCCESSFUL  - FAILED   |
| taskId     | 否    | String | 任务消息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   
#### 请求示例
查询导出作业的任务。
```
GET /v1/b384b9e9ab9b4ee8994c8633aabc9505/systemTasks/008aae2e675d3bcb01675d40ab3f0005
```
#### 响应示例
- 成功响应
  ```
  {
      "endTime": 1544777083000,
      "id": "008aae2e67abe2ff0167abe3a28f0000",
      "lastUpdate": 1544777083000,
      "name": "从路径[obs://aaaaa/job_batch.zip]导入作业。",
      "projectId": "b384b9e9ab9b4ee8994c8633aabc9505",
      "startTime": 1544777081000,
      "status": "SUCCESSFUL",
      "subtasks": [
          {
              "id": "008aae2e67abe2ff0167abe3a7e70002",
              "lastUpdate": 1544777083000,
              "name": "导入作业[job_batch]。",
              "status": "SUCCESSFUL",
              "taskId": "008aae2e675d3bcb01675d40ab3f0005"
          }
      ]
  }
  ```
  
- 失败响应 HTTP状态码 400
  ```
  {
      "error_code":"DLF.20810",
      "error_msg":"Task[008aae2e675d3bcb01675d40ab3f0005] does not exist"
  }
  ```