查询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任务的返回结果

表4 CpiTaskData
参数	参数类型	描述
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	用户已开启的自定义属性集合

表5 CpiResult
参数	参数类型	描述
header	String	蛋白质FASTA标题
fasta	String	蛋白质FASTA序列
prop_names	Array of strings	分子ADMET属性名列表
result	Array of CpiResultItem objects	返回CPI的模型结果
custom_props	Array of CustomProp objects	用户已开启的自定义属性集合

表6 CpiResultItem
参数	参数类型	描述
smiles	String	分子SMILES表达式
props	Array of objects	分子ADMET属性值列表
score	Number	分子与蛋白质的打分

表7 CustomProp
参数	参数类型	描述
id	String	自定义属性的ID（API侧）最小长度：1 最大长度：64
prop_definition	PropDefinition object	属性定义的元信息

表8 PropDefinition
参数	参数类型	描述
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	模型推理是否呈现置信区间

表9 ValueRange
参数	参数类型	描述
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 ]
    } ]
  }
}