# 查询CPI任务
#### 功能介绍
通过CPI任务ID查询CPI任务状态及结果。
#### URI
GET /v1/{project_id}/task/cpi/{task_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| project_id | 是    | String | 华为云项目id |
| task_id    | 是    | String | CPI任务ID |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户 token |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数        | 参数类型                                                                                        | 描述                                                                                  |
|:---|:---|:---|
| status    | String                                                                                      | 异步任务的状态：等待中、运行中、已完成、失败 枚举值： - **waiting** - **running** - **finished** - **failed** |
| task_data | [CpiTaskData] object | CPI任务的请求体                                                                           |
| result    | [CpiResult] object     | CPI任务的返回结果                                                                          |
   
 表4CpiTaskData 
| 参数           | 参数类型                                                                                                | 描述                                  |
|:---|:---|:---|
| header       | String                                                                                              | 蛋白质FASTA标题 最小长度：**0** 最大长度：**128**  |
| fasta        | String                                                                                              | 蛋白质FASTA序列 最小长度：**4** 最大长度：**2048** |
| smiles_list  | Array of strings                                                                                    | 分子SMILES表达式列表                       |
| threshold    | Float                                                                                               | 打分阈值，分值必须大于该阈值才会返回                  |
| num_results  | Integer                                                                                             | 期望最大返回条目数（排序后取Top）                  |
| custom_props | Array of [CustomProp] objects | 用户已开启的自定义属性集合                       |
   
 表5CpiResult 
| 参数           | 参数类型                                                                                                      | 描述            |
|:---|:---|:---|
| header       | String                                                                                                    | 蛋白质FASTA标题    |
| fasta        | String                                                                                                    | 蛋白质FASTA序列    |
| prop_names   | Array of strings                                                                                          | 分子ADMET属性名列表  |
| result       | Array of [CpiResultItem] objects | 返回CPI的模型结果    |
| custom_props | Array of [CustomProp] objects       | 用户已开启的自定义属性集合 |
   
 表6CpiResultItem 
| 参数     | 参数类型             | 描述           |
|:---|:---|:---|
| smiles | String           | 分子SMILES表达式  |
| props  | Array of objects | 分子ADMET属性值列表 |
| score  | Number           | 分子与蛋白质的打分    |
   
 表7CustomProp 
| 参数              | 参数类型                                                                                              | 描述                                    |
|:---|:---|:---|
| id              | String                                                                                            | 自定义属性的ID（API侧） 最小长度：**1** 最大长度：**64** |
| prop_definition | [PropDefinition] object | 属性定义的元信息                              |
   
 表8PropDefinition 
| 参数                    | 参数类型                                                                                      | 描述                                           |
|:---|:---|:---|
| id                    | String                                                                                    | 属性业务侧ID 最小长度：**1** 最大长度：**128**              |
| name                  | String                                                                                    | 属性名称 最小长度：**1** 最大长度：**32**                  |
| type                  | String                                                                                    | 属性类型 枚举值： - **binary** - **numerical**       |
| description           | String                                                                                    | 属性具体描述信息 最小长度：**0** 最大长度：**256**             |
| value_range           | [ValueRange] object | 属性有效值域区间                                     |
| optimal_range         | [ValueRange] object | 属性最优值域区间                                     |
| warning_range         | [ValueRange] object | 属性欠佳值域区间                                     |
| style                 | String                                                                                    | 模型参数呈现类型 枚举值： - **number** - **probability** |
| confidential_interval | Boolean                                                                                   | 模型推理是否呈现置信区间                                 |
   
 表9ValueRange 
| 参数              | 参数类型    | 描述       |
|:---|:---|:---|
| lower           | Number  | 值域下限     |
| lower_inclusive | Boolean | 是否包含值域下限 |
| upper           | Number  | 值域上限     |
| upper_inclusive | Boolean | 是否包含值域上限 |
   
#### 请求示例
查询一个CPI任务
```
GET https://{endpoint}/v1/{project_id}/task/cpi/{task_id}
```
#### 响应示例
**状态码： 200**
CPI任务查询成功响应
```
{
  "status" : "finished",
  "result" : {
    "header" : "T1030 BibA, 273 residues",
    "fasta" : "DQELGKQSRRSQDIIKSLGFLSSDQKDILVKSISSSKDSQLILKFVTQATQLNNAESTKAKQMAQNDVALIKNISPEVLEEYKEKIQRASTKSQVDEFVAEAKKVVNSNKET",
    "custom_props" : [ {
      "id" : "3b2dce64-c244-11ed-acf5-0255ac100017",
      "prop_definition" : {
        "id" : "c4c07032d1934671a0dfe3bd10416eea",
        "name" : "custom_prop_name",
        "type" : "numerical",
        "description" : "custom_prop_description"
      }
    } ],
    "prop_names" : [ "formula", "ab", "acute_toxicity_rule", "bace", "3b2dce64-c244-11ed-acf5-0255ac100017", "3b2dce64-c244-11ed-acf5-0255ac100017_std" ],
    "result" : [ {
      "smiles" : "c1ccccc1",
      "score" : 0.388029,
      "props" : [ "C6H6", "base", 0, 0.128335, 0.43, 0.28 ]
    }, {
      "smiles" : "C1CCCCC1",
      "score" : 0.304194,
      "props" : [ "C6H12", "base", 0, 0.163034, 0.43, 0.28 ]
    } ]
  }
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | CPI任务查询成功响应 |
| 404 | CPI任务ID不存在  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-eihealth/ErrorCode.html)。