# 查询分子搜索任务
#### 功能介绍
通过分子搜索任务ID查询分子搜索任务状态及结果。
#### URI
GET /v1/{project_id}/task/search/{task_id}
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| project_id | 是    | String | 华为云项目id  |
| task_id    | 是    | String | 分子搜索任务ID |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户 token |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数        | 参数类型                                                                 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| status    | String                                                               | 异步任务的状态：等待中、运行中、已完成、失败 枚举值： - **waiting**  - **running**  - **finished**  - **failed**   |
| task_data | [SearchTaskData] object | 分子搜索任务的请求体                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| result    | [SearchResult] object     | 分子搜索任务的返回结果                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   
 表4SearchTaskData 
| 参数        | 参数类型             | 描述                                                                                                              |
|:---|:---|:---|
| smiles    | String           | 分子SMILES表达式                                                                                                     |
| databases | Array of strings | 搜索使用到的数据库集合                                                                                                     |
| top_n     | Integer          | 期望最大返回条目数（排序后取Top） 最小值：**1** 最大值：**1000** |
   
 表5SearchResult 
| 参数         | 参数类型                                                                               | 描述           |
|:---|:---|:---|
| smiles     | String                                                                             | 分子SMILES表达式  |
| databases  | Array of strings                                                                   | 搜索使用到的数据库集合  |
| top_n      | Integer                                                                            | 期望返回的条目数     |
| prop_names | Array of strings                                                                   | 分子ADMET属性名列表 |
| query      | [query] object                                 | 初始查询分子的属性信息  |
| result     | Array of [SearchResultItem] objects | 查询结果列表       |
   
 表6query 
| 参数     | 参数类型             | 描述           |
|:---|:---|:---|
| smiles | String           | 分子SMILES表达式  |
| props  | Array of objects | 分子ADMET属性值列表 |
   
 表7SearchResultItem 
| 参数     | 参数类型             | 描述           |
|:---|:---|:---|
| smiles | String           | 分子SMILES表达式  |
| source | String           | 分子所属的数据库来源   |
| score  | Float            | 分子与查询分子的相似度  |
| props  | Array of objects | 分子ADMET属性值列表 |
   
#### 请求示例
无
#### 响应示例
**状态码： 200**
分子搜索任务查询成功响应
```
{ 
  "status" : "finished", 
  "result" : { 
    "smiles" : "c1ccccc1", 
    "databases" : [ "drug_space_x", "drug_bank" ], 
    "top_n" : 100, 
    "prop_names" : [ "formula", "ab", "acute_toxicity_rule", "bace" ], 
    "query" : { 
      "smiles" : "c1ccccc1", 
      "props" : [ "C6H6", "base", 0, 0.128335 ] 
    }, 
    "result" : [ { 
      "smiles" : "c1ccccc1", 
      "source" : "drug_bank", 
      "score" : 0.388029, 
      "props" : [ "C6H6", "base", 0, 0.128335 ] 
    }, { 
      "smiles" : "C1CCCCC1", 
      "source" : "drug_bank:drug_space_x", 
      "score" : 0.388029, 
      "props" : [ "C6H12", "base", 0, 0.163034 ] 
    } ] 
  } 
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | 分子搜索任务查询成功响应 |
| 404 | 分子搜索任务ID不存在  |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-eihealth/eihealth_33_00310.html)。