华为云用户手册

响应示例 状态码： 201 CREATED 创建分子生成作业成功。 { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1" } 创建分子生成作业成功，当前运行作业数已达配额限制，此作业会等待。 { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "limit_concurrency" : 50 }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限， 获取Token 接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 basic_info 是 CreateDrugJobBasicInfo object 作业基本信息。 smiles_list 否 Array of strings 分子表达式列表。 最小长度：1 最大长度：512 数组长度：10 - 10000 molecule_file 否 DrugFile object 分子文件，分子表达式列表和分子文件二选一，分子文件优先级最高。 binding_sites 否 Array of BindSiteDto objects 靶点列表。 数组长度：0 - 2 weak_constraints 否 Array of WeakConstraintDto objects 弱约束集合。 数组长度：0 - 10 strong_constraints 否 Array of StrongConstraintDto objects 强约束集合。 数组长度：0 - 5 base_model_id 否 String 基模型id。 缺省值：pangu-drug-model 最小长度：0 最大长度：128 model_ids 否 Array of strings 模型id列表。 最小长度：1 最大长度：128 数组长度：0 - 10 num_trials 否 Integer 生成分子数量。 最小值：0 最大值：5000 缺省值：5000 表4 CreateDrugJobBasicInfo 参数 是否必选 参数类型 描述 name 是 String 作业的名称，取值范围：[5,64]，允许大小写字母、数字、空格、下划线(_)和中划线(-),只能以数字或字母开头。 最小长度：5 最大长度：64 labels 否 Array of strings 标签，取值范围[0,5]，单个标签最大长度32字符，支持中文、字母、数字、空格、下划线和中划线，且不能以空格开头或者结尾。 最小长度：1 最大长度：32 数组长度：0 - 5 upstream_job_info 否 String 上游作业信息。 最小长度：1 最大长度：10240 表5 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 表6 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 表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 doubles 口袋中心坐标； x, y, z轴的坐标。 最小值：-9999999 最大值：99999999 数组长度：3 - 3 size 是 Array of floats 口袋尺寸大小； x, y, z轴的大小。 最小值：2 最大值：500 数组长度：3 - 3 padding 否 Float 填充。 最小值：0 最大值：20 表9 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 相互作用力约束参数。 表10 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 相互作用力约束参数。 表11 StructureConstraintParamsDto 参数 是否必选 参数类型 描述 structs 是 Array of strings 子结构SMILES。 最小长度：1 最大长度：120 数组长度：1 - 8 exclusive 是 Boolean 是否排除子结构。 operator 否 String 多个子结构之间的逻辑关系。 枚举值： or and 表12 InteractionConstraintDto 参数 是否必选 参数类型 描述 interactions 是 Array of Interaction objects 相互作用力列表。 数组长度：1 - 8 exclusive 是 Boolean 是否排除指定的约束作用力。 operator 否 String 多个作用力之间的逻辑关系。 枚举值： or and 表13 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

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

响应示例 状态码： 201 CREATED 创建自由能微扰作业成功。 { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1" } 创建自由能微扰作业成功，当前运行作业数已达配额限制，此作业会等待。 { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "limit_concurrency" : 50 }

请求示例 创建自由能微扰作业，作业名称为demo-job，受体文件为project:/dir/file，配体分别为GLY:A:514和UNK1，路径图的中心配体为GLY:A:514，配体对分别为GLY:A:514和DrugBank:UNK1，预平衡步数为5000，平衡步数为50000，时间步长为0.002，lambda的个数为20。 https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-jobs/fep { "basic_info" : { "name" : "demo-job", "labels" : [ "labelA" ] }, "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 } }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 basic_info 是 CreateDrugJobBasicInfo object 创建药物作业基本信息。 receptor 是 ReceptorDrugFile object 受体文件。 add_membrane 否 Boolean 是否加膜处理。 缺省值：false ligands 是 Array of LigandPreviewDto objects 配体列表。 数组长度：2 - 101 graph 是 FepGraphDto object 路径图。 params 是 FepParamDto object FEP设置参数。 表4 CreateDrugJobBasicInfo 参数 是否必选 参数类型 描述 name 是 String 作业的名称，取值范围：[5,64]，允许大小写字母、数字、空格、下划线(_)和中划线(-),只能以数字或字母开头。 最小长度：5 最大长度：64 labels 否 Array of strings 标签，取值范围[0,5]，单个标签最大长度32字符，支持中文、字母、数字、空格、下划线和中划线，且不能以空格开头或者结尾。 最小长度：1 最大长度：32 数组长度：0 - 5 upstream_job_info 否 String 上游作业信息。 最小长度：1 最大长度：10240 表5 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 表6 LigandPreviewDto 参数 是否必选 参数类型 描述 index 是 Integer 配体索引（从0起编号）。 最小值：0 最大值：99 file 是 DrugFile object 配体文件。 name 是 String 配体名称，若无名称则自动命名，格式为UNK+索引（从1起编号）。 最小长度：1 最大长度：32 smiles 是 String 分子SMILES表达式。 最小长度：1 最大长度：512 表7 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 表8 FepGraphDto 参数 是否必选 参数类型 描述 center_id 是 String 中心配体名称。 最小长度：1 最大长度：32 pairs 是 Array of SimilarityDto objects 配体对列表。 数组长度：1 - 100 表9 SimilarityDto 参数 是否必选 参数类型 描述 ligand_ids 是 Array of strings 配体对。 最小长度：1 最大长度：32 数组长度：2 - 2 表10 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

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

请求示例 添加收藏分子类型。 https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/favorites { "type" : "MOLECULE", "resource_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "resource_type" : "OPTIMIZATION", "resource_name" : "demo-resource", "display_info" : "{\"smiles\":\"c1ccccc1\",\"molecule_name\":\"AA-173/40757587\"}", "location_info" : "{\"receptor_idx\":\"1\",\"result_idx\":\"1\"}" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 type 是 String 收藏类型。 最小长度：1 最大长度：16 resource_id 是 String 收藏的资源ID。 最小长度：1 最大长度：128 resource_name 是 String 收藏的资源名称，正则匹配中文，英文字母和数字及下划线。 最小长度：1 最大长度：128 resource_type 是 String 收藏的资源类型，正则匹配英文字母和数字及下划线。 最小长度：1 最大长度：128 display_info 是 String 展示信息。 最小长度：1 最大长度：65535 location_info 是 String 定位信息。 最小长度：1 最大长度：65535

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

请求示例 创建模型，模型名称为model_name，类型为二分型，上传项目桶中file/test.csv的模型数据，打开共享开关。 https://{endpoint}/v1/{project_id}/drug-models { "name" : "model_name", "type" : "binary", "description" : "simple model", "file" : { "url" : "project:/file/test.csv", "source" : "private" }, "shareable" : true }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 模型名称，取值范围：[5,32]，允许大小写字母、数字、下划线(_)、中划线(-)和空格,只能以字母开头。 最小长度：5 最大长度：32 description 否 String 模型描述信息。 最小长度：0 最大长度：1024 type 是 String 模型类型。 枚举值： binary numerical file 是 ModelFile object 模型数据来源。 shareable 否 Boolean 是否打开组织共享。 缺省值：false base_model_id 否 String 基模型id。 缺省值：pangu-drug-model 最小长度：1 最大长度：128 表4 ModelFile 参数 是否必选 参数类型 描述 source 是 String 模型数据文件来源。 枚举值： public private url 是 String 文件URL，用户私有数据中心为项目路径、公共数据场景为obs地址。 最小长度：1 最大长度：2000 eihealth_project_id 否 String 模型文件所在项目id，仅文件为数据中心时填写。 最小长度：1 最大长度：128

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 smiles 是 String 分子SMILES表达式。 最小长度：1 最大长度：1024 scaffold 否 String 分子骨架smiles表达式。 最小长度：1 最大长度：512 size 否 Integer 尺寸。 最小值：0 最大值：5000 缺省值：320 height 否 Integer svg高度。 最小值：0 最大值：5000 缺省值：0 width 否 Integer svg宽度。 最小值：0 最大值：5000 缺省值：0 alerts 否 String 高亮子结构编号。 最小长度：0 最大长度：5000 ncols 否 Integer 显示的列数。 最小值：0 最大值：100000 缺省值：0 bgopacity 否 Float 背景透明度。 最小值：0 最大值：1 缺省值：0.0 bgcolor 否 String 背景颜色。 最小长度：0 最大长度：64 fgcolor 否 String 前景色。 最小长度：0 最大长度：64 ccolor 否 String 碳颜色。 最小长度：0 最大长度：64 ncolor 否 String 氮颜色。 最小长度：0 最大长度：64 ocolor 否 String 氧颜色。 最小长度：0 最大长度：64

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 mode 是 String 创建配体相似度图的模式：中心模式、自由模式。 枚举值： CENTER FREE ligands 是 Array of CreateLigandSimilarityGraphLigandDto objects 配体列表。 数组长度：2 - 101 表4 CreateLigandSimilarityGraphLigandDto 参数 是否必选 参数类型 描述 name 是 String 配体分子唯一名字，受体中的建议使用"{氨基酸}:{链}:{编号}"。 最小长度：1 最大长度：32 smiles 是 String 分子SMILES表达式。 最小长度：1 最大长度：512 main 否 Boolean 配体是否为主要配体，在中心模式下，必须指定1个主要配体。 缺省值：false

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

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 smiles 是 String 分子SMILES表达式。 最小长度：1 最大长度：512

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 ligand_file 是 DrugFile object 配体文件。 preview_count 否 Integer 预览数量，若分子数量大于预览数量，则超出预览数量部分只做计数。 最小值：0 最大值：1000 缺省值：100 count_limit 否 Integer 计数上限，若分子数量大于计数上限，则终止计数并在结果中标明计数不完整（has_more=true），计数数量应不小于preview_count。 最小值：0 最大值：1000000 缺省值：1000 generate_3d 否 Boolean 是否生成3D构象，默认为true。 缺省值：true 表4 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

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 receptor_file 是 ReceptorDrugFileReq object 受体文件。 ligand_file 否 DrugFile object 配体文件。 name 否 String 小分子名称。 最小长度：0 最大长度：128 表4 ReceptorDrugFileReq 参数 是否必选 参数类型 描述 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 add_hydrogen 否 Boolean 增加氢原子。 缺省值：true 表5 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

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

请求示例 创建数据库，数据库名称为database_name，选择css集群，上传项目桶中file/test.csv的数据库数据，设置列名为SMILES和NAME，打开共享开关。 https://{endpoint}/v1/{project_id}/drug/drug-database { "name" : "database_name", "css_id" : "2f042ad4-6aca-11ed-b7f6-fa163e504fdd", "description" : "simple database", "file" : { "source" : "PRIVATE", "url" : "project:/file/test.csv", "eihealth_project_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1" }, "columns" : [ "SMILES", "NAME" ], "shareable" : true }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 数据库名称，长度为5-32个字符，首位需以小写英文字母开头，仅可以使用小写字母、数字、下划线“_”和中划线“-”。 最小长度：5 最大长度：32 description 否 String 数据库描述。 最小长度：0 最大长度：1024 css_id 是 String css集群id。 最小长度：1 最大长度：128 file 是 DatabaseFile object 数据库文件。 columns 是 Array of strings 数据文件列名。 最小长度：1 最大长度：128 数组长度：2 - 12 shareable 否 Boolean 是否打开组织共享。 缺省值：false 表4 DatabaseFile 参数 是否必选 参数类型 描述 source 是 String 数据库文件来源。 枚举值： public private url 是 String 文件URL，用户私有数据中心为项目路径、公共数据场景为obs地址。 最小长度：1 最大长度：2000 eihealth_project_id 否 String 数据库文件所在项目id，仅文件为数据中心时填写。 最小长度：1 最大长度：128

请求示例 创建分子对接作业，作业名称为demo-job， 受体文件为project:/dir/file，口袋中心位置的值为[0,0,0]，口袋尺寸大小为[10,10,10]，去除受体的水分子。 https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-jobs/docking { "basic_info" : { "name" : "demo-job", "labels" : [ "labelA" ] }, "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 } ] }

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 basic_info 是 CreateDrugJobBasicInfo object 创建药物作业基本信息。 receptors 是 Array of DockingReceptorDto objects 受体文件列表。 数组长度：1 - 20 ligands 是 Array of LigandDto objects 配体文件列表，当前仅支持1个。 数组长度：1 - 1 engine 否 String 引擎，支持DSDP、AUTODOCK_VINA、SIMILAR_DOCKING。 缺省值：AUTODOCK_VINA 最小长度：0 最大长度：15 表4 CreateDrugJobBasicInfo 参数 是否必选 参数类型 描述 name 是 String 作业的名称，取值范围：[5,64]，允许大小写字母、数字、空格、下划线(_)和中划线(-),只能以数字或字母开头。 最小长度：5 最大长度：64 labels 否 Array of strings 标签，取值范围[0,5]，单个标签最大长度32字符，支持中文、字母、数字、空格、下划线和中划线，且不能以空格开头或者结尾。 最小长度：1 最大长度：32 数组长度：0 - 5 upstream_job_info 否 String 上游作业信息。 最小长度：1 最大长度：10240 表5 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时提供。 表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 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 表8 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 表9 LigandDto 参数 是否必选 参数类型 描述 ligand 是 DrugFile object 配体文件。 count 是 Integer 计算个数。 最小值：1 最大值：1000000 表10 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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 spec_code 是 String 规格编码 最小长度：1 最大长度：128 disk_space 否 Integer 磁盘存储空间，该字段暂不生效 最小值：40 最大值：1000 disk_encrypt 是 Boolean 磁盘是否加密

请求示例 插入数据单条数据，列column1、column2、column3的值分别为1000、str2、1.1 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/databases/{database_id}/data/insert { "column_values" : [ { "column" : "column1", "value" : "1000" }, { "column" : "column2", "value" : "str2" }, { "column" : "column3", "value" : "1.1" } ] }

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