华为云用户手册

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 basic_info DrugJobDto object 作业基本信息。 smiles_list Array of strings 分子表达式列表。 最小长度：1 最大长度：512 数组长度：10 - 10000 molecule_file DrugFile object 分子文件，分子表达式列表和分子文件二选一，分子文件优先级最高。 num_trials Integer 生成分子数量。 最小值：0 最大值：5000 initial_dataset_size Integer 初始化数据集的分子数目。当为-1时，表示分子数目未知。 最小值：-1 最大值：100000 binding_sites Array of BindSiteDto objects 靶点列表。 数组长度：0 - 2 weak_constraints Array of WeakConstraintDto objects 弱约束集合。 数组长度：0 - 16 strong_constraints Array of StrongConstraintDto objects 强约束集合。 数组长度：0 - 5 base_model BaseModel object 基模型。 models Array of BasicDrugModel objects 模型列表。 表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 doubles 口袋中心坐标； 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 区间上限，仅回归型存在。

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-jobs/generation/{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" : "OPTIMIZATION", "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" : { "source" : "PRIVATE", "url" : "project:/dir/file" }, "ligands" : [ { "name" : "GLY:A:514", "smiles" : "C1CCCCC1", "index" : 0, "file" : { "source" : "RAW", "format" : "PDB", "data" : "MODEL1.xxxxxxx.END" } }, { "name" : "UNK1", "smiles" : "c1ccccc1", "index" : 0, "file" : { "source" : "PRIVATE", "url" : "project:/dir/file" } } ], "graph" : { "center_id" : "GLY:A:514", "pairs" : [ { "ligand_ids" : [ "GLY:A:514", "DrugBank:UNK1" ] } ] }, "params" : { "num_pre_equilibrium_steps" : 50000, "num_equilibrium_steps" : 500000, "timestep_size" : 0.002, "num_lambda" : 20 }, "job_result" : { "total_count" : 10, "failed_count" : 1 } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 basic_info DrugJobDto object 作业基本信息。 receptor ReceptorDrugFile object 受体文件。 add_membrane Boolean 是否加膜处理。 缺省值：false ligands Array of LigandPreviewDto objects 配体列表。 graph FepGraphDto object 路径图。 params FepParamDto object FEP设置参数。 job_result JobResult object 作业结果信息。 part_failed_reason Array of FailedReasonRecord objects 部分失败原因和数量。 表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 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 表7 LigandPreviewDto 参数 参数类型 描述 index Integer 配体索引（从0起编号）。 最小值：0 最大值：99 file DrugFile object 配体文件 name String 配体名称，若无名称则自动命名，格式为UNK+索引（从1起编号）。 最小长度：1 最大长度：32 smiles String 分子SMILES表达式。 最小长度：1 最大长度：512 表8 DrugFile 参数 参数类型 描述 source String 受体的数据源：外部网络数据（如RCSB在线数据库）、用户私有数据中心、承载租户公共数据（含样例/公共库）。 枚举值： 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 表9 FepGraphDto 参数 参数类型 描述 center_id String 中心配体名称。 最小长度：1 最大长度：32 pairs Array of SimilarityDto objects 配体对列表。 数组长度：1 - 100 表10 SimilarityDto 参数 参数类型 描述 ligand_ids Array of strings 配体对。 最小长度：1 最大长度：32 数组长度：2 - 2 表11 FepParamDto 参数 参数类型 描述 pre_equilibrium_time Float 预平衡时长，单位ps，范围为0-200，不包含0，默认为100ps。 最小值：0 最大值：200.0 equilibrium_time Float 平衡时长，单位ns，范围为0-10，不包含0，默认为1ns。 最小值：0 最大值：10.0 num_pre_equilibrium_steps Integer 预平衡步数，默认为50000。 最小值：1 最大值：200000 num_equilibrium_steps Integer 平衡步数，默认为500000。 最小值：1 最大值：10000000 timestep_size Float 时间步长，单位ps，取值范围：大于0，小于等于0.005。 最小值：0.001 最大值：0.005 缺省值：0.002 num_lambda Integer lambda个数。 最小值：2 最大值：30 缺省值：20 表12 JobResult 参数 参数类型 描述 total_count Integer 输入总数。 failed_count Integer 失败个数。 sub_tasks_duration Array of floats 子任务运行时长（秒）。 数组长度：1 - 30 表13 FailedReasonRecord 参数 参数类型 描述 reason String 失败原因。 count Integer 失败数量。

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

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

响应示例 状态码： 200 OK { "maximum" : { "value" : 17, "row_number" : 102, "column_name" : "Mpro", "row_name" : "AZD-5991" }, "minimum" : { "value" : 17, "row_number" : 102, "column_name" : "Mpro", "row_name" : "AZD-5991" } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 maximum ExtremumDto object study作业最值信息 minimum ExtremumDto object study作业最值信息 表4 ExtremumDto 参数 参数类型 描述 value Double 最值 row_number Long 最值所在的行数 column_name String 最值所在的列名 row_name String 最值所在的行名

响应参数 状态码： 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" }

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

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

响应示例 状态码： 200 查询配体文件预览任务成功响应。 { "status" : "finished", "result" : { "count" : 2000, "has_more" : true, "ligands" : [ { "index" : 0, "name" : "UNK1", "success" : true, "smiles" : "CC(=O)N[C@@H](Cc1ccc(CC(=O)O)c(C(=O)O)c1)C(=O)N[C@H]1CCCCN(Cc2ccc(-c3ccccc3)cc2)C1=O", "formula" : "C33H35N3O7", "is_3d" : false, "structure" : { "format" : "PDB", "compressed" : true, "data" : "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" }, "reason" : null }, { "index" : 1, "name" : "UNK2", "success" : true, "smiles" : "COc1ccc(-c2cc(=O)c3c(O)cc(O[C@@H]4O[C@H](CO[C@@H]5O[C@@H](C)[C@H](O)[C@@H](O)[C@H]5O)[C@@H](O)[C@H](O)[C@H]4O)cc3o2)cc1O", "formula" : "C28H32O15", "is_3d" : false, "structure" : { "format" : "PDB", "compressed" : true, "data" : "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" }, "reason" : null } ] } }

响应示例 状态码： 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", "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 }, "receptors" : [ { "receptor" : { "source" : "PRIVATE", "url" : "project:/dir/file" }, "bounding_box" : { "center" : [ 0, 0, 0 ], "size" : [ 10, 10, 10 ] }, "remove_water" : true, "remove_ion" : false, "remove_ligand" : false } ], "ligands" : [ { "ligand" : { "source" : "PRIVATE", "url" : "project:/dir/file" }, "count" : 100 } ], "engine" : "AUTODOCK_VINA", "job_result" : { "total_count" : 10, "failed_count" : 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 作业基本信息。 receptors Array of DockingReceptorDto objects 受体文件列表。 数组长度：1 - 20 ligands Array of LigandDto objects 配体文件列表，当前仅支持1个。 数组长度：1 - 1 engine String 引擎，支持DSDP、AUTODOCK_VINA、SIMILAR_DOCKING。 job_result JobResult object 作业结果信息。 part_failed_reason Array of FailedReasonRecord 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 DockingReceptorDto 参数 参数类型 描述 receptor ReceptorDrugFile object 受体文件。 bounding_box BoundingBoxDto object 结合口袋，包含口袋中心位置和尺寸大小。 remove_ion Boolean 去除受体中的离子。 缺省值：true remove_water Boolean 去除受体中的水分子。 缺省值：true remove_ligand Boolean 去除受体中的配体分子。 缺省值：true add_hydrogen Boolean 增加氢原子。 缺省值：false docking_type String 对接类型，支持BLIND_DOCKING、POCKET_DOCKING。 缺省值：POCKET_DOCKING 最小长度：0 最大长度：15 reference_file ReferenceLigandFile object 模板配体文件，仅引擎为SIMILAR_DOCKING时提供。 表7 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 表8 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 表9 ReferenceLigandFile 参数 参数类型 描述 source String 受体的数据源：外部网络数据（如RCSB在线数据库）、用户私有数据中心、承载租户公共数据（含样例/公共库） 枚举值： EXTRANET PRIVATE PUBLIC RAW url String 文件URL，当数据源为外部网络数据时为https地址，为用户私有数据中心时为项目路径，为公共数据场景时为obs地址。 最小长度：1 最大长度：2000 format String 文件格式，支持PDB、SDF、MOL2、SMI、CSV等，仅数据源为RAW时提供。 最小长度：1 最大长度：6 data String 文件原始数据，仅数据源为RAW时提供。 最小长度：0 最大长度：10000000 表10 LigandDto 参数 参数类型 描述 ligand DrugFile object 配体文件。 count Integer 计算个数。 最小值：1 最大值：1000000 表11 DrugFile 参数 参数类型 描述 source String 受体的数据源：外部网络数据（如RCSB在线数据库）、用户私有数据中心、承载租户公共数据（含样例/公共库）。 枚举值： 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 表12 JobResult 参数 参数类型 描述 total_count Integer 输入总数。 failed_count Integer 失败个数。 表13 ClusterJobRsp 参数 参数类型 描述 method String 分子聚类方法。 output_dir String 分子聚类输出结果。 status String 作业结果信息。 failed_reasons Array of FailedReasonRecord objects 部分失败原因和数量。 表14 FailedReasonRecord 参数 参数类型 描述 reason String 失败原因。 count Integer 失败数量。

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

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

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 data_delete Boolean 项目级删除策略（true：允许项目数据删除操作，false：不允许删除操作，默认为true） data_download Boolean 项目级下载策略（true：允许项目数据下载操作，false：不允许下载操作，默认为true） data_encrypted Boolean 项目级加密策略（true：允许项目 数据加密 操作，false：不允许加密操作，默认为false） data_share Boolean 项目级分享策略（true：允许项目数据拷贝/引用操作，false：不允许拷贝/引用操作，默认为true）

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

响应示例 状态码： 200 OK { "complete_data" : [ "demo" ], "running_data" : [ "demo" ], "creator" : "creator", "source_project_id" : "fce1376b-72f9-4d15-9f95-9b533cb988ab", "source_project_name" : "source-project", "id" : "94116a6b-1945-4581-b64c-2cea712988ab", "name" : "DataDelete-20210421093037", "sources" : [ "demo" ], "create_time" : "2021-04-21T09:30:37Z", "end_time" : "2021-04-21T09:30:37Z", "status" : "SUCCEED", "destinations" : [ "demo" ], "type" : "DELETE_DATA", "failed_reason" : "failed reason" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 complete_data Array of strings 已完成的数据列表 running_data Array of strings 正在执行的数据列表 creator String 数据作业创建者 source_project_id String 非本项目操作场景下源项目名称 source_project_name String 非本项目操作场景下源项目名称 id String 数据作业ID name String 数据作业名称 sources Array of strings 数据列表 create_time String 数据作业创建时间 end_time String 数据作业结束时间 status String 数据作业状态 destinations Array of strings 数据列表 type String 数据作业类型 failed_reason String 数据作业失败原因 additions String 附加信息

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

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 path String 对象全路径（项目名称:/路径） name String 名称 type String 枚举值： FILE FOLDER size Long 大小 缺省值：0 create_time String 创建时间 content String 文件内容 download_url String 下载链接 allowed_operate Boolean 可操作标记 缺省值：true deletable Boolean 可删除标记 缺省值：true

响应示例 状态码： 200 OK { "path" : "test-project-id:/test.txt", "name" : "db_test1.txt", "type" : "FILE", "size" : 1024, "create_time" : "2021-02-01T14:25:34Z", "download_url" : "https://www.hhh.com/db_test1.txt", "allowed_operate" : true }

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

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

响应示例 状态码： 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", "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 }, "receptors" : [ { "source" : "PRIVATE", "url" : "project:/dir/file" } ], "ligands" : [ { "file" : { "source" : "PRIVATE", "url" : "project:/dir/file" }, "count" : 10000 } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 basic_info DrugJobDto object 作业基本信息。 receptors Array of 表14-14 objects 受体文件列表。 数组长度：1 - 100 ligands Array of 表14-15 objects 小分子。 数组长度：1 - 1 表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 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 表7 MoleculeFileDto 参数 参数类型 描述 file 表14-16 object 分子文件。 count Integer 分子个数。 最小值：1 最大值：1000000 表8 MoleculeFile 参数 参数类型 描述 source String 文件来源，支持用户私有数据中心、公共数据和源数据。 最小长度：1 最大长度：8 url String 文件URL，用户私有数据中心为项目路径、公共数据场景为obs地址。 最小长度：1 最大长度：2000 format String 文件格式，支持PDB、SDF、MOL2、SMI，仅数据源为RAW时提供。 最小长度：1 最大长度：6 data String 文件原始数据，仅数据源为RAW时提供。 最小长度：0 最大长度：10000000