华为云用户手册

请求示例 将外部文件https://files.rcsb.org/download/1TQN.pdb转为SDF格式。 https://{endpoint}/v1/{project_id}/drug-common/toolkit/formart-converter { "file" : { "source" : "EXTRANET", "url" : "https://files.rcsb.org/download/1TQN.pdb" }, "in_format" : "PDB", "out_format" : "SDF" }

响应示例 状态码： 200 格式转换后文件内容。 REMARK 1 CREATED WITH OPENMM 7.7, 2023-10-31 CRYST1 48.140 48.140 135.230 90.00 90.00 90.00 P 1 1 ATOM 1 N ALA A 1 35.884 42.999 47.573 1.00 0.00 N ATOM 2 H ALA A 1 35.251 42.514 48.472 1.00 0.00 H ATOM 3 H2 ALA A 1 34.961 43.642 47.135 1.00 0.00 H ATOM 4 H3 ALA A 1 36.444 43.875 48.190 1.00 0.00 H ATOM 5 CA ALA A 1 36.605 42.605 46.370 1.00 0.00 C ATOM 6 HA ALA A 1 36.266 43.206 45.396 1.00 0.00 H ATOM 7 C ALA A 1 36.452 41.114 46.099 1.00 0.00 C ATOM 8 O ALA A 1 36.341 40.696 44.945 1.00 0.00 O ... HETATM 32 C4 UNL Z 1 -1.619 0.123 -1.621 +0.00 +0.00 C HETATM 33 C5 UNL Z 1 -0.461 0.209 -0.648 +0.00 -0.00 C HETATM 34 C6 UNL Z 1 0.464 1.262 -0.731 +0.00 +0.00 C HETATM 35 C7 UNL Z 1 1.530 1.346 0.178 +0.00 +0.00 C HETATM 36 C9 UNL Z 1 1.653 0.391 1.191 +0.00 +0.00 C HETATM 37 C10 UNL Z 1 0.748 -0.676 1.263 +0.00 +0.00 C HETATM 38 C11 UNL Z 1 -0.302 -0.765 0.348 +0.00 +0.00 C HETATM 39 C8 UNL Z 1 2.511 2.436 -0.027 +0.00 +0.00 C HETATM 40 O2 UNL Z 1 3.062 3.028 0.891 +0.00 -0.00 O HETATM 41 C12 UNL Z 1 2.682 0.463 2.236 +0.00 +0.00 C HETATM 42 O4 UNL Z 1 3.273 -0.478 2.728 +0.00 -0.01 O HETATM 43 O3 UNL Z 1 2.796 1.722 2.692 +0.00 -0.01 O HETATM 44 H12 UNL Z 1 3.751 1.920 2.595 +0.00 +0.00 H TER ENDMDL

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/backups/{backup_id}/paths 表1 路径参数 参数 是否必选 参数类型 描述 backup_id 是 String 归档ID 最小长度：1 最大长度：128 eihealth_project_id 是 String 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Integer 总数 resources Array of StorageResourceRsp objects 存储资源列表 表4 StorageResourceRsp 参数 参数类型 描述 spec SpecDto object 规格信息 size Long 使用量 charge_mode String 计费模式 create_time String 购买时间 status String 状态 表5 SpecDto 参数 参数类型 描述 code String 规格编号 最大长度：64 name String 规格名称 最大长度：64

响应示例 状态码： 200 OK { "count" : 1, "resources" : [ { "spec" : { "code" : "code", "name" : "name" }, "size" : 1024, "charge_mode" : 2, "create_time" : "2021-02-01T14:25:50Z", "status" : "Deploying" } ]}

响应示例 状态码： 200 OK { "count" : 2, "projects" : [ { "id" : "fce1376b-72f9-4d15-9f95-9b533cb96fd1", "name" : "demo-project-1", "creator" : "demo-user", "role" : "Admin", "size" : 1123243536, "status" : "ACTIVE", "tags" : [ "tag1" ], "description" : "This is demo project 1", "create_time" : "2020-09-10T10:07:17Z", "update_time" : "2020-09-10T10:07:17Z" }, { "id" : "fce1376b-72f9-4d15-9f95-9b533cb96fd2", "name" : "demo-project-2", "creator" : "demo-user", "role" : "Admin", "size" : 1123243536, "status" : "TO_BE_DELETED", "tags" : [ "tag1" ], "description" : "This is demo project 2", "create_time" : "2020-09-10T10:07:17Z", "update_time" : "2020-09-10T10:07:17Z", "delete_time" : "2020-09-10T10:07:17Z" } ]}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Integer 个数 projects Array of ProjectRsp objects 项目详情列表 表4 ProjectRsp 参数 参数类型 描述 id String 项目id name String 项目名称 creator String 项目所有者 role String 当前用户在该项目上的角色 size Long 项目桶存储量 status String 项目状态 tags Array of strings 标签列表 description String 项目描述 create_time String 项目创建时间 update_time String 项目更新时间 delete_time String 请求删除时间 is_core Boolean 核心项目标记

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/nextflow/workflows 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 表2 Query参数 参数 是否必选 参数类型 描述 name 否 String 流程名称 最小长度：1 最大长度：56

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 workflows Array of NextflowWorkflowListDto objects 当前页的流程列表 count Integer 所查询类型的流程总数 表5 NextflowWorkflowListDto 参数 参数类型 描述 id String 流程id name String 流程名称 description String 描述信息 labels Array of strings 流程标签 create_time String 创建流程时间 update_time String 更新流程时间 creator String 创建用户名称 source_project_name String 源项目名称 source_resource_id String 源资源id

响应示例 状态码： 200 OK { "workflows" : [ { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "name" : "demo-workflow", "description" : "description", "labels" : [ "labelA", "labelB" ], "create_time" : "2021-01-30T02:34:36Z", "update_time" : "2021-01-30T02:53:26Z", "creator" : "test-01", "source_project_name" : "src", "source_resource_id" : "src-id" } ], "count" : 1}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 idle_time Integer 空置时间 threshold Integer 缩容阈值 delay_after_add Integer 扩容后多久再次判断缩容 delay_after_delete Integer 节点删除后多久再次判断缩容 delay_after_failure Integer 缩容失败后多久再次判断缩容 max_nodes_batch_deletion Integer 缩容并发数 check_interval Integer 检查间隔

响应示例 状态码： 200 OK { "basic_info" : { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "name" : "demo-job", "labels" : [ "labelA", "labelB" ], "status" : "FINISHED", "type" : "OPTIMIZATION", "create_time" : "2021-01-30T02:34:36Z", "start_time" : "2021-01-30T02:34:37Z", "finish_time" : "2021-01-30T02:53:26Z", "failed_message" : "null", "user_name" : "demo-user-name", "output_dir" : "job-analysis/job-name", "expect_charge_num" : 1, "real_charge_num" : 1 }, "smiles" : "string", "num_trials" : 500, "binding_site" : { "name" : "binding_name", "receptor" : { "source" : "PRIVATE", "url" : "project:/test.pdb" }, "engine" : "DSDP", "bounding_box" : { "center" : [ 0, 0, 0 ], "size" : [ 500, 500, 500 ] }, "remove_ion" : false, "remove_water" : false, "remove_ligand" : true }, "weak_constraints" : [ { "name" : "eye_corrosion", "type" : "bool", "bool" : true } ], "strong_constraints" : [ { "name" : "sascore", "type" : "range", "range" : [ 0, 1 ] } ], "cluster_result" : { "method" : "hiq_mc", "output_dir" : "project://bucket/path/to/task/dir/", "status" : "finished", "failed_reasons" : [ { "reason" : "failed reason" }, { "count" : 1 } ] }}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 basic_info DrugJobDto object 作业基本信息。 smiles String 分子SMILES表达式。 最小长度：1 最大长度：512 molecule_file DrugFile object 分子文件。 num_trials Integer 生成分子数量。 最小值：0 最大值：5000 binding_site BindSiteDto object 结合位点。 binding_sites Array of BindSiteDto objects 受体列表和受体是二选一的关系，受体列表优先级最高。 数组长度：0 - 2 weak_constraints Array of WeakConstraintDto objects 弱约束集合。 strong_constraints Array of StrongConstraintDto objects 强约束集合。 sampler_mixin_weight Float 初始化采样权重。 base_model BaseModel object 基模型。 models Array of BasicDrugModel objects 模型列表。 cluster_result ClusterJobRsp object 聚类结果信息。 表4 DrugJobDto 参数 参数类型 描述 id String 作业id。 name String 作业的名称，取值范围：[1,63]，允许大小写字母、数字、以及特殊字符中划线(-)。 labels Array of strings 作业标签。 status String 作业状态。 type String 作业类型。 create_time String 作业创建时间。 finish_time String 作业结束时间。 start_time String 作业开始时间。 failed_message String 失败提示，当作业执行失败时会返回。 user_name String 创建任务的用户名称。 output_dir String 作业结果输出目录。 expect_charge_num Double 预估功能调用消耗次数。 real_charge_num Double 实际功能调用消耗次数。 progress Progress object 作业进度信息。 upstream_job_info String 上游作业信息。 表5 Progress 参数 参数类型 描述 overall Float 整体进度。 estimated_finish_time Long 预计结束时间，毫秒。 表6 DrugFile 参数 参数类型 描述 source String 受体的数据源：外部网络数据（如R CS B在线数据库）、用户私有数据中心、承载租户公共数据（含样例/公共库）。 枚举值： EXTRANET PRIVATE PUBLIC RAW url String 文件URL，当数据源为外部网络数据时为https地址；用户私有数据中心为项目路径、公共数据场景为obs地址。 最小长度：1 最大长度：2000 format String 文件格式，支持PDB、SDF、MOL2、SMI，仅数据源为RAW时提供。 最小长度：1 最大长度：6 data String 文件原始数据，仅数据源为RAW时提供。 最小长度：0 最大长度：10000000 表7 BindSiteDto 参数 参数类型 描述 name String 靶点名称，只能设置为target1或者target2。 最小长度：1 最大长度：128 receptor ReceptorDrugFile object 受体文件。 engine String 对接引擎，支持DSDP、AUTODOCK_VINA。 缺省值：AUTODOCK_VINA 最小长度：0 最大长度：15 docking_type String 对接类型，支持BLIND_DOCKING、POCKET_DOCKING。 缺省值：POCKET_DOCKING 最小长度：0 最大长度：15 bounding_box BoundingBoxDto object 结合口袋，包含口袋中心位置和尺寸大小。 remove_ion Boolean 去除受体中的离子。 缺省值：true remove_water Boolean 去除受体中的水分子。 缺省值：true remove_ligand Boolean 去除受体中的配体分子。 缺省值：true add_hydrogen Boolean 增加氢原子。 缺省值：false 表8 ReceptorDrugFile 参数 参数类型 描述 source String 受体的数据源：外部网络数据（如RCSB在线数据库）、用户私有数据中心、承载租户公共数据（含样例/公共库）。 枚举值： EXTRANET PRIVATE PUBLIC RAW url String 文件URL，当数据源为外部网络数据时为https地址；用户私有数据中心为项目路径、公共数据场景为obs地址。 最小长度：1 最大长度：2000 format String 文件格式，仅支持PDB，仅数据源为RAW时提供。 最小长度：1 最大长度：6 data String 文件原始数据，仅数据源为RAW时提供。 最小长度：0 最大长度：10000000 表9 BoundingBoxDto 参数 参数类型 描述 center Array of floats 口袋中心坐标； x, y, z轴的坐标。 最小值：-9999999 最大值：99999999 数组长度：3 - 3 size Array of floats 口袋尺寸大小； x, y, z轴的大小。 最小值：2 最大值：500 数组长度：3 - 3 padding Float 填充。 最小值：0 最大值：20 表10 WeakConstraintDto 参数 参数类型 描述 id String 自定义模型id，仅弱约束为模型时填写。 最小长度：1 最大长度：128 name String 属性名称。 最小长度：1 最大长度：128 type String 属性约束类型。 枚举值： bool range struct minimize maximize interaction bool Boolean 属性约束类型bool的参数。 range Array of floats 属性约束类型range的参数。 最小值：-9999 最大值：9999 数组长度：2 - 2 struct StructureConstraintParamsDto object 结构约束参数。 quantiles Array of floats 属性约束类型minimize和maximize的参数。 最小值：0.0 最大值：1.0 数组长度：2 - 2 interaction InteractionConstraintDto object 相互作用力约束参数。 表11 StrongConstraintDto 参数 参数类型 描述 id String 自定义模型id，仅强约束为模型时填写。 最小长度：1 最大长度：128 name String 属性名称。 最小长度：1 最大长度：128 type String 属性约束类型。 枚举值： bool range struct interaction bool Boolean 属性约束类型bool的参数。 range Array of floats 属性约束类型range的参数。 最小值：-9999 最大值：9999 数组长度：2 - 2 struct StructureConstraintParamsDto object 结构约束参数。 interaction InteractionConstraintDto object 相互作用力约束参数。 表12 StructureConstraintParamsDto 参数 参数类型 描述 structs Array of strings 子结构SMILES。 最小长度：1 最大长度：120 数组长度：1 - 8 exclusive Boolean 是否排除子结构。 operator String 多个子结构之间的逻辑关系。 枚举值： or and 表13 InteractionConstraintDto 参数 参数类型 描述 interactions Array of Interaction objects 相互作用力列表。 数组长度：1 - 8 exclusive Boolean 是否排除指定的约束作用力。 operator String 多个作用力之间的逻辑关系。 枚举值： or and 表14 Interaction 参数 参数类型 描述 binding_site String 靶点，只支持target1或target2。 最小长度：1 最大长度：128 type String 相互作用力类型：氢键、疏水作用、盐桥、π-π堆积、π-阳离子。 枚举值： hydrogen_bond hydrophobic_action salt_bridge pi_stacking pi_cation amino_acid String 氨基酸。 最小长度：4 最大长度：16 表15 BaseModel 参数 参数类型 描述 id String 基模型id。 缺省值：pangu-drug-model 最小长度：1 最大长度：128 name String 基模型名称。 缺省值：pangu-drug-model 最小长度：1 最大长度：128 表16 BasicDrugModel 参数 参数类型 描述 id String 模型ID。 task_id String 任务ID。 name String 模型名称。 creator String 模型创建者。 type String 模型类型。 value_range ValueRange object 区间上下限，仅回归型存在。 description String 模型描述信息。 表17 ValueRange 参数 参数类型 描述 lower Float 区间下限，仅回归型存在。 upper Float 区间上限，仅回归型存在。 表18 ClusterJobRsp 参数 参数类型 描述 method String 分子聚类方法。 output_dir String 分子聚类输出结果。 status String 作业结果信息。 failed_reasons Array of FailedReasonRecord objects 部分失败原因和数量。 表19 FailedReasonRecord 参数 参数类型 描述 reason String 失败原因。 count Integer 失败数量。

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-jobs/optimization/{job_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 eihealth_project_id 是 String 平台项目ID。 最小长度：1 最大长度：128 job_id 是 String 作业id。 最小长度：1 最大长度：128

响应示例 状态码： 200 OK { "path" : "2022|02|21|eiHealth-project_CloudTrace_cn-north-7_2022-02-21T02-31-09Z_a45fc9849d217b43.json.gz", "name" : "eiHealth-project_CloudTrace_cn-north-7_2022-02-21T02-31-09Z_a45fc9849d217b43.json.gz", "type" : "FILE", "size" : 438, "create_time" : "2022-02-21T02:31:09Z", "download_url" : "https://aos-eihealth-for-trace-***/***60.json.gz"}

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/project-traces/{path} 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 path 是 String 审计日志全路径（路径） 最小长度：1 最大长度：2000

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-jobs/pocket-mol-design/{job_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 eihealth_project_id 是 String 平台项目ID。 最小长度：1 最大长度：128 job_id 是 String 作业id。 最小长度：1 最大长度：128

响应示例 状态码： 200 OK { "basic_info" : { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "name" : "demo-job", "labels" : [ "labelA", "labelB" ], "status" : "FINISHED", "type" : "POCKE_MOL_DESIGN", "start_time" : "2021-01-30T02:34:36Z", "create_time" : "2021-01-30T02:34:36Z", "finish_time" : "2021-01-30T02:53:26Z", "failed_message" : "null", "user_name" : "demo-user-name", "output_dir" : "job-analysis/job-name", "expect_charge_num" : 1, "real_charge_num" : 1 }, "receptor" : { "file" : { "source" : "PRIVATE", "url" : "project:/dir/file" } }, "ligands" : [ { "source" : "PRIVATE" }, { "url" : "project:/dir/file" } ], "cluster_result" : { "method" : "hiq_mc", "output_dir" : "project://bucket/path/to/task/dir/", "status" : "finished", "failed_reasons" : [ { "reason" : "failed reason" }, { "count" : 1 } ] }}

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/notebooks/{notebook_id}/token 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：1 最大长度：128 notebook_id 是 String notebook id 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/jobs/{job_id}/events 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：1 最大长度：128 job_id 是 String 作业id 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限， 获取Token 接口响应消息头中X-Subject-Token的值即为Token。 X-Language 否 String Locale语言类型，zh_cn返回中文，en_us返回英文 缺省值：en_us 最小长度：1 最大长度：10

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Integer 条数 events Array of JobEventRsp objects 作业事件列表 表4 JobEventRsp 参数 参数类型 描述 action_name String 执行动作名称 count Integer 作业启动事件发生次数 first_timestamp String 作业启动事件首次上报时间 last_timestamp String 作业启动事件末次上报时间 message String 作业启动事件详细信息 reason String 作业启动事件状态 type String 作业启动事件类型

响应示例 状态码： 200 OK { "count" : 1, "events" : [ { "action_name" : "create", "count" : 1, "first_timestamp" : "2021-01-30T02:34:36Z", "last_timestamp" : "2021-01-30T02:34:36Z", "message" : "创建k8s Job对象 app1-1-0-093a002fa000217 成功", "reason" : "创建成功##SuccessfulCreate", "type" : "Normal" } ]}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 任务状态。 result LigandSimilarityGraphTaskResultDto object 配体相似度图任务结果。 表4 LigandSimilarityGraphTaskResultDto 参数 参数类型 描述 pairs Array of LigandSimilarityGraphTaskResultPairDto objects 配体相似度图任务结果对列表。 数组长度：1 - 100 表5 LigandSimilarityGraphTaskResultPairDto 参数 参数类型 描述 ligands Array of strings 两个配体名称。 最小长度：1 最大长度：32 数组长度：2 - 2 success Boolean 相似度计算是否成功。 similarity Float 配体对之间的相似度。 最小值：0 最大值：1 reason String 相似度计算失败的理由。 最小长度：1 最大长度：512

响应示例 状态码： 200 查询配体相似性图计算任务成功响应。 { "status" : "finished", "result" : { "pairs" : [ { "success" : true, "ligands" : [ "FXR_74", "ligand" ], "similarity" : 0, "reason" : null } ] }}

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 dev_user_pool Boolean notebook是否使用专属资源池 has_dev Boolean 是否 集成开发环境 has_drug Boolean 是否部署药物虚拟筛选 has_encryption_button Boolean 是否显示加密按钮 deploy_mode String 医疗智能体 部署模式 enable_cold_archive Boolean 是否支持归档类型存储 public_bucket_path String 医疗智能体公共数据桶https路径

响应示例 状态码： 200 OK { "dev_user_pool" : false, "has_dev" : false, "has_drug" : false, "has_encryption_button" : false, "deploy_mode" : "basic", "enable_cold_archive" : true, "public_bucket_path" : "https://bucket.obs.cn-north-4.myhuawei.com"}

响应示例 状态码： 200 OK { "id" : "aa78f595-5acb-4be8-b277-229be335633a", "name" : "Docking Summary", "title" : "Docking Summary", "category" : "WORKFLOW", "labels" : [ "molecular docking", "drug discovery", "smallMolecularChemicals" ], "vendor_id" : "00000000000000000000000000000000", "version" : { "version" : "1.0.0", "publisher" : " EIHealth ", "description" : "", "summary" : "summary", "license" : "", "status" : "NORMAL", "create_time" : "2021-09-07T05:44:28Z", "update_time" : "2021-09-07T05:44:28Z" }, "create_time" : "2021-09-07T05:44:28Z", "update_time" : "2021-09-07T05:44:28Z"}

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-common/ligand/similarity-graph/{task_id} 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 eihealth_project_id 是 String 平台项目ID。 最小长度：1 最大长度：128 task_id 是 String 任务ID，通过创建任务接口取得。 最小长度：1 最大长度：128

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 id String 资产id name String 资产名 title String 资产展示名 category String 类别 labels Array of strings 资产标签列表 vendor_id String 供应商id version VersionRsp object 资产版本信息 create_time String 创建时间 update_time String 更新时间 表4 VersionRsp 参数 参数类型 描述 version String 资产版本号 publisher String 发布者 description String 资产长描述 summary String 资产短描述 license String 许可证 status String 资产状态 failed_reason String 资产发布失败原因 labels Array of strings 资产标签列表 picture String 资产封面图访问链接 create_time String 创建时间 update_time String 更新时间