# 获取子任务实例信息
#### 功能介绍
获取子任务实例信息
#### URI
GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/jobs/{job_id}/tasks/{task_name}/instances
表1路径参数 
| 参数                  | 是否必选 | 参数类型   | 描述                                                                                                                   |
|:---|:---|:---|:---|
| eihealth_project_id | 是    | String | 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：**1** 最大长度：**128**                                                           |
| job_id              | 是    | String | 作业id 最小长度：**1** 最大长度：**128**                                                                                         |
| project_id          | 是    | String | 华为云项目ID，您可以从[获取项目ID](https://support.huaweicloud.com/api-eihealth/eihealth_33_0044.html)中获取。 最小长度：**1** 最大长度：**128** |
| task_name           | 是    | String | 子任务名称 最小长度：**1** 最大长度：**128**                                                                                        |
表2Query参数 
| 参数         | 是否必选 | 参数类型   | 描述                                         |
|:---|:---|:---|:---|
| task_index | 否    | String | 子任务的并发序号 缺省值：**0** 最小长度：**1** 最大长度：**128** |
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                         |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，[获取Token](https://support.huaweicloud.com/api-eihealth/eihealth_33_0010.html)接口响应消息头中X-Subject-Token的值即为Token。 |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数        | 参数类型                                                                             | 描述      |
|:---|:---|:---|
| count     | Integer                                                                          | 实例个数    |
| instances | Array of [TaskInstanceRsp] objects | 实例响应结构体 |
   
 表5TaskInstanceRsp 
| 参数       | 参数类型                                                                                   | 描述            |
|:---|:---|:---|
| status   | [TaskInstanceStatusRsp] object     | 实例状态信息        |
| metadata | [TaskInstanceMetadataRsp] object | 实例元数据信息       |
| spec     | [TaskInstanceSpecRsp] object         | 实例cpu和内存使用率信息 |
   
 表6TaskInstanceStatusRsp 
| 参数                 | 参数类型                                                                                                           | 描述       |
|:---|:---|:---|
| phase              | String                                                                                                         | 实例执行状态   |
| pod_ip             | String                                                                                                         | 实例IP     |
| host_ip            | String                                                                                                         | 实例所在节点IP |
| host_name          | String                                                                                                         | 计算节点的名称  |
| start_time         | String                                                                                                         | 实例创建时间   |
| container_statuses | Array of [TaskInstanceContainerStatusRsp] objects | 实例状态信息   |
   
 表7TaskInstanceContainerStatusRsp 
| 参数            | 参数类型    | 描述   |
|:---|:---|:---|
| restart_count | Integer | 重启次数 |
   
 表8TaskInstanceMetadataRsp 
| 参数        | 参数类型   | 描述   |
|:---|:---|:---|
| name      | String | 实例名称 |
| namespace | String | 命名空间 |
   
 表9TaskInstanceSpecRsp 
| 参数         | 参数类型                                                                                                         | 描述      |
|:---|:---|:---|
| containers | Array of [TaskInstanceSpecContainersRsp] objects | 实例详情响应体 |
   
 表10TaskInstanceSpecContainersRsp 
| 参数        | 参数类型                                                                                                 | 描述         |
|:---|:---|:---|
| resources | [TaskInstanceSpecConResourceRsp] object | task实例规格信息 |
   
 表11TaskInstanceSpecConResourceRsp 
| 参数       | 参数类型                                                                                                     | 描述        |
|:---|:---|:---|
| limits   | [TaskInstanceSpecConResLimitRsp] object     | task资源限制值 |
| requests | [TaskInstanceSpecConResRequestRsp] object | task资源需求值 |
   
 表12TaskInstanceSpecConResLimitRsp 
| 参数     | 参数类型   | 描述     |
|:---|:---|:---|
| cpu    | String | CPU限制值 |
| memory | String | 内存限制值  |
   
 表13TaskInstanceSpecConResRequestRsp 
| 参数     | 参数类型   | 描述     |
|:---|:---|:---|
| cpu    | String | CPU申请值 |
| memory | String | 内存申请值  |
   
#### 请求示例
无
#### 响应示例
**状态码： 200**
OK
```
{
  "count" : 0,
  "instances" : [ {
    "status" : {
      "phase" : "Failed",
      "pod_ip" : "192.168.0.1",
      "host_ip" : "192.168.0.1",
      "host_name" : "health-f789d9c5-e8e6-44e7-84fb-8e234bba1cee",
      "start_time" : "2021-01-30T02:34:36Z",
      "container_statuses" : [ {
        "restart_count" : 0
      } ]
    },
    "metadata" : {
      "name" : "string",
      "namespace" : "default"
    },
    "spec" : {
      "containers" : [ {
        "resources" : {
          "limits" : {
            "cpu" : "string",
            "memory" : "string"
          },
          "requests" : {
            "cpu" : "string",
            "memory" : "string"
          }
        }
      } ]
    }
  } ]
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-eihealth/ErrorCode.html)。