华为云用户手册

请求示例 创建分子对接作业，作业名称为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 引擎，默认为AUTODOCK_VINA。 缺省值：AUTODOCK_VINA 最小长度：0 最大长度：15 表4 CreateDrugJobBasicInfo 参数 是否必选 参数类型 描述 name 是 String 作业的名称，取值范围：[5,64]，允许大小写字母、数字、空格、下划线(_)和中划线(-),只能以数字或字母开头。 最小长度：5 最大长度：64 labels 否 Array of strings 标签，取值范围[0,5]，单个标签最大长度32字符，支持中文、字母、数字、空格、下划线和中划线，且不能以空格开头或者结尾。 最小长度：1 最大长度：32 数组长度：0 - 5 表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 表6 ReceptorDrugFile 参数 是否必选 参数类型 描述 source 是 String 受体的数据源：外部网络数据（如R CS B在线数据库）、用户私有数据中心、承载租户公共数据（含样例/公共库）。 枚举值： 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 LigandDto 参数 是否必选 参数类型 描述 ligand 是 DrugFile object 配体文件。 count 是 Integer 计算个数。 最小值：1 最大值：1000000 表9 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-jobs/pocket-mol-design 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 eihealth_project_id 是 String 平台项目ID。 最小长度：1 最大长度：128

请求示例 创建靶点口袋发现作业，作业名称为demo-job， 受体文件为project:/dir/file，小分子片段文件为project:/dir/file，自定义属性预测id为xxxxxx，分子量约束为200-600，预期的最大输出为5000个。 https://{endpoint}/v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-jobs/pocket-mol-design { "basic_info" : { "name" : "demo-job", "labels" : [ "labelA" ] }, "receptor" : { "file" : { "source" : "PRIVATE", "url" : "project:/dir/file" }, "bounding_box" : { "center" : [ 0, 0, 0 ], "size" : [ 10, 10, 10 ], "padding" : 10 }, "remove_water" : false, "remove_ion" : false }, "ligands" : [ { "source" : "PRIVATE", "url" : "project:/dir/file" } ], "model_ids" : [ "xxxxxx" ], "molecular_weight" : [ 200, 600 ] }

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

响应示例 状态码： 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 }, "smiles" : "c1ccccc1", "params" : { "top_n" : 50, "max_search_depth" : 5, "time_limit" : 30, "max_prediction_per_product" : 20 } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 basic_info DrugJobDto object 作业基本信息。 smiles String 分子SMILES表达式。 最小长度：1 最大长度：512 params SynthesisParamDto 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 作业进度信息。 表5 Progress 参数 参数类型 描述 overall Float 整体进度。 estimated_finish_time Long 预计结束时间，毫秒。 表6 SynthesisParamDto 参数 参数类型 描述 top_n Integer 期望最大返回条目数（排序后取TopN）。 最小值：1 最大值：50 max_search_depth Integer 预测路径的最大深度。 最小值：3 最大值：12 time_limit Integer 搜索最大时间，单位:分钟。 最小值：5 最大值：60 max_prediction_per_product Integer 每个产物的最大反应数量。 最小值：2 最大值：20

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-jobs/synthesis/{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 { "count" : 1, "jobs" : [ { "id" : "56e0f1b0-ac10-46a5-8fa7-b26831d7d488", "name" : "demo-job", "description" : "description", "status" : "COMPLETED", "has_ignore_failed_tasks" : false, "create_time" : "2021-01-30T02:34:36Z", "finish_time" : "2021-01-30T02:53:26Z", "user_name" : "demo-user", "workflow_name" : "demo-workflow", "workflow_id" : "56e0f1b0-ac10-46a5-8fa7-b26831d7d488" } ] }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 jobs Array of NextflowJobListDto objects 作业列表 count Integer 作业总数 表5 NextflowJobListDto 参数 参数类型 描述 id String 作业id name String 作业的名称，取值范围：[1,63]，允许大小写字母、数字、以及特殊字符中划线(-) description String 作业的描述,取值范围：输入字符最大长度为255 labels Array of strings 作业标签 status String 作业状态 has_ignore_failed_tasks Boolean 是否包含已被忽略的失败tasks create_time String 作业创建时间 finish_time String 作业结束时间 failed_message String 失败提示，当作业执行失败时会返回 failed_reason String 失败原因，当作业执行失败时会返回 user_name String 创建任务的用户名称 workflow_name String 流程名称 workflow_id String 流程id

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/nextflow/jobs 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_id 是 String 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：1 最大长度：128 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 限制量，单次查询总量，必须由数字组成，默认为100，取值范围[1,1000] 最小值：1 最大值：1000 缺省值：100 offset 否 Integer 偏移量，查询起始偏移，必须由数字组成，默认为0，取值范围[0,100000000] 最小值：0 最大值：100000000 缺省值：0 sort_dir 否 String 排序规则 目前默认时间降序 缺省值：DESC sort_key 否 String 排序规则 目前默认时间降序，支持根据status job_name 否 String 作业名称 最小长度：1 最大长度：128 labels 否 Array 标签列表 最小长度：1 最大长度：32 数组长度：0 - 5 status 否 String 作业运行状态 取值（SUBMITTED|RUNNING|COMPLETED|FAILED|CANCELLED|UNKNOWN） workflow_name 否 String workflow名称 最小长度：1 最大长度：128 user_name 否 String 作业创建者 最小长度：1 最大长度：128 create_start_time 否 Long 最小创建时间 最小值：1000000000000 最大值：9999999999999 create_end_time 否 Long 最大创建时间 最小值：1000000000000 最大值：9999999999999 finish_start_time 否 Long 最小结束时间 最小值：1000000000000 最大值：9999999999999 finish_end_time 否 Long 最大结束时间 最小值：1000000000000 最大值：9999999999999

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" : "POCKETDETECTION", "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 }, "params" : { "timestep_size" : 0.001, "num_minimization_steps" : 20000, "pre_equilibrium_time" : 100, "pocket_detection_time" : 50, "num_surface_points" : 30, "probe_radius" : 1.4 }, "receptor" : { "source" : "PRIVATE", "url" : "project:/dir/file" }, "ligand" : { "source" : "PRIVATE", "url" : "project:/dir/file" } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 basic_info DrugJobDto object 作业基本信息。 receptor ReceptorDrugFile object 受体文件。 ligand ProbeDrugFile object 探针文件。 params PocketDetectionParamDto 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 作业进度信息。 表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 ProbeDrugFile 参数 参数类型 描述 source String 受体的数据源：外部网络数据（如RCSB在线数据库）、用户私有数据中心、承载租户公共数据（含样例/公共库）。 枚举值： EXTRANET PRIVATE PUBLIC RAW url String 文件URL，当数据源为外部网络数据时为https地址；用户私有数据中心为项目路径、公共数据场景为obs地址。 最小长度：1 最大长度：2000 format String 文件格式，支持PDB、SDF、MOL2，仅数据源为RAW时提供。 最小长度：1 最大长度：6 data String 文件原始数据，仅数据源为RAW时提供。 最小长度：0 最大长度：10000000 表8 PocketDetectionParamDto 参数 参数类型 描述 timestep_size Double 时间步长，单位ps。 最小值：0.001 最大值：0.002 缺省值：0.002 num_minimization_steps Integer 最小化步数。 最小值：5000 最大值：50000 缺省值：20000 pre_equilibrium_time Integer 预平衡时长，单位ps。 最小值：20 最大值：200 缺省值：100 pocket_detection_time Integer 口袋发现时长，单位ns。 最小值：20 最大值：50 缺省值：50 num_surface_points Integer 表面原子离散点数量。 最小值：10 最大值：50 缺省值：20 probe_radius Double 探针半径，单位A 最小值：1.4 最大值：5 缺省值：1.4

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/drug-jobs/pocket-detection/{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 { "count" : 15, "assets" : [ { "id" : "aa78f595-5acb-4be8-b277-229be335633a", "category" : "WORKFLOW", "name" : "Docking Summary", "title" : "Docking Summary", "labels" : [ "molecular docking", "drug discovery", "smallMolecularChemicals" ], "picture" : "https://eihealth.obs.cn-north-4.huawei.com:443/assets/metadata/picture.png", "vendor_id" : "00000000000000000000000000000000", "versions" : [ { "version" : "1.0.0", "publisher" : " EIHealth ", "description" : "", "summary" : "summary", "license" : "", "status" : "NORMAL", "failed_reason" : "internal error", "labels" : [ "molecular docking", "drug discovery", "smallMolecularChemicals" ], "picture" : "https://eihealth.obs.cn-north-4.huawei.com:443/assets/metadata/picture.png", "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", "stars" : 0, "subscribes" : 1 } ] }

URI GET /v1/{project_id}/assets 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 表2 Query参数 参数 是否必选 参数类型 描述 categories 否 String 资产类别，支持IMAGE/APP/WORKFLOW/DATASET，支持查询多个，以','分割 最小长度：0 最大长度：2000 key_word 否 String 关键字，支持在资产名、资产标题、短描述、长描述中搜索 最小长度：0 最大长度：2000 labels 否 String 标签，支持查询多个，以','分割 最小长度：0 最大长度：2000 limit 否 Integer 返回记录限制 最小值：1 最大值：1000 缺省值：100 offset 否 Integer 偏移量 最小值：0 最大值：100000000 缺省值：0 publishers 否 String 发布者，支持查询多个，以','分割 最小长度：0 最大长度：2000 scope 是 String 查询范围，支持PUBLIC/INTERNAL/SELF 最小长度：1 最大长度：128 vendor_ids 否 String 供应商，支持查询多个，以','分割 最小长度：0 最大长度：2000

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Integer 资产总数 assets Array of GetAssetRsp objects 资产列表 表5 GetAssetRsp 参数 参数类型 描述 id String 资产id category String 类别 name String 资产名 title String 资产展示名 labels Array of strings 资产标签列表 picture String 资产封面图访问链接 vendor_id String 供应商id versions Array of VersionRsp objects 资产版本号列表 create_time String 创建时间 update_time String 更新时间 stars Integer 收藏数 subscribes Integer 订阅数 表6 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 更新时间

请求示例 测试 CSS 资源连通性，选择id为2f042ad4-6aca-11ed-b7f6-fa163e504fdd的CSS资源，集群管理员为admin，密码为user_pwd。 https://{endpoint}/v1/{project_id}/drug/css-clusters { "css_id" : "2f042ad4-6aca-11ed-b7f6-fa163e504fdd", "user_name" : "admin", "user_pwd" : "user_pwd" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 css_id 是 String 集群id。 最小长度：1 最大长度：128 user_name 是 String 集群用户账号。 最小长度：4 最大长度：32 user_pwd 是 String 集群用户密码，长度限制为[8,32]。 最小长度：8 最大长度：32

响应示例 状态码： 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 }, "molecule_file" : { "source" : "PRIVATE", "url" : "project:/dir/file" }, "num_trials" : 500, "binding_sites" : [ { "name" : "binding_name", "receptor" : { "source" : "PRIVATE", "url" : "project:/test.pdb" }, "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 ] } ] }

响应参数 状态码： 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 实际功能调用消耗次数。 progressProgress Progress object 作业进度信息。 表5 Progress 参数 参数类型 描述 overall Float 整体进度。 estimated_finish_time Long 预计结束时间，毫秒。 表6 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 表7 BindSiteDto 参数 参数类型 描述 name String 靶点名称，只能设置为target1或者target2。 最小长度：1 最大长度：128 receptor ReceptorDrugFile object 受体文件 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

方案架构 该解决方案基于华为云 函数工作流 FunctionGraph、 对象存储服务 OBS资源一键式部署，帮用户快速实现视频转GIF动图。解决方案架构图如下： 图1 方案架构图 部署该方案中需要使用的资源： 创建两个对象存储服务 OBS桶，一个用于上传视频触发函数工作流， 一个用于存储视频转GIF动图文件。 函数工作流 FunctionGraph，用于调用 媒体处理 MPC云服务的相关接口，实现视频转GIF动图功能，并将视频对应的GIF上传至指定的目标OBS桶。 使用媒体处理 MPC云服务，由函数工作流调用其新建转动图相关接口创建任务，实现对原视频转换GIF。 通过 统一身份认证 服务 IAM 的委托功能，将账号Region内对象存储服务 OBS的操作权限委托给函数工作流服务 FunctionGraph。

快速部署 本章节主要帮助用户快速部署“视频转GIF动图”解决方案。 表1 参数说明 参数名称 类型 是否可选 参数解释 默认值 functiongraph_name string 必填 函数工作流 FunctionGraph名称，不支持重名。取值范围：长度为2-57个字符，可包含字母、数字、_（下划线）和-（中划线），以字母开头。 converting-video-to-gif-demo video_input_bucket string 必填 视频输入OBS桶名称，全局唯一。取值范围：1~63个字符，以小写字母或数字开头，仅支持小写字母、数字、中划线（-）。 空 gif_output_bucket string 必填 GIF动图输出OBS桶名称，全局唯一。取值范围：1~63个字符，以小写字母或数字开头，仅支持小写字母、数字、中划线（-）。 空 gif_frame_rate string 必填 动图帧率。取值范围：1~75区间中的整数。 15 gif_width string 必填 动图的宽。取值范围：0，-1或[32,3840]之间2的倍数。如设置为0，则取原始视频的宽，此时gif_height只能取0。如设置为-1，则宽根据高来自适应，此时变量gif_height不能取-1或0。 0 gif_height string 必填 动图的高。取值范围：0，-1或[32,2160]之间2的倍数。如设置为0，则取原始视频的高，此时gif_width只能取0。如设置为-1，则高根据宽来自适应，此时变量gif_width不能取-1或0。 0 gif_start_time string 必填 源视频中需要截取GIF的开始时间。取值范围：大于等于0的整数。单位：秒。注意：开始时间不能超过视频时长，超过视频时长则不生成gif。 0 gif_end_time string 必填 源视频中需要截取GIF的结束时间。取值范围：大于0的整数。单位：秒。注意：（1、结束时间不能超过视频时长，如超过视频时长，在视频中截取GIF的结束时间为视频时长。2、GIF时长最大为60秒，即截取GIF的结束时间和开始时间最大差值60秒。）。 30 登录华为云解决方案实践，选择“视频转GIF动图”，单击“一键部署”，跳转至解决方案创建资源栈界面。 图1 解决方案实施库 在选择模板界面中，单击“下一步”。 图2 选择模板 在配置参数界面中，参考表1完成自定义参数填写，单击“下一步”。 图3 配置参数 在资源设置界面中，在权限委托下拉框中选择“rf_admin_trust”委托（可不选），单击“下一步”。 图4 资源栈设置 在配置确认界面中，单击“创建执行计划”。 图5 配置确认 在弹出的创建执行计划框中，自定义填写执行计划名称，单击“确定”。 图6 创建执行计划 单击“部署”，并且在弹出的执行计划确认框中单击“执行”。 图7 执行计划 图8 执行计划确认 待“事件”中出现“Apply required resource success”，表示该解决方案已经部署完成。 图9 部署完成 父主题： 实施步骤

资源和成本规划 该解决方案主要部署如下资源，以下费用仅供参考，具体请参考华为云官网价格详情，实际收费以账单为准。 表1 成本预估（仅供参考） 华为云服务 计费说明 每月花费（调用100万次） 函数工作流 FunctionGraph 区域：华北-北京四 产品：函数 请求次数： 0-100万次： 0元/100万次 100万次以上 ： 1.33元/100万次 计量时间： 0-400,000 GB/秒： 0元/GB-秒 400,000 GB/秒以上 ：0.00011108元/GB-秒 具体费用参考表左侧计费说明 对象存储服务 OBS 区域：华北-北京四 存储空间：数据存储（多AZ存储） 默认存储类别：标准存储 桶策略：私有 请求费用：0.0100元/万次 存储空间：0.0990元/GB/月 流量费用： 公网流出流量 / 00:00-08:00（闲时）0.2500元/GB 公网流出流量 / 08:00-24:00（忙时）0.5000元/GB 费用包括存储空间、请求费用、流量费用两部分，具体请参考OBS计费详情。 费用包括存储空间、请求费用、流量费用三部分，详细请参考每月账单。 合计 - 函数工作流费用+OBS费用

给rf_admin_trust委托添加IAM Agency Management FullAcces权限（可选） 打开“统一身份认证”菜单 图12 统一身份认证菜单 进入“委托”菜单，选择rf_admin_trust委托 图13 委托列表 进入“授权记录”菜单，单击“授权”按钮 图14 授权记录 在搜索框输入IAM Agency Management FullAcces，勾选过滤出来的记录，单击下一步，并确认完成权限的配置 图15 配置IAM Agency Management FullAcces策略 配置好后的情况：rf_admin_trust委托拥有Tenant Administrator和IAM Agency Management FullAccess权限 图16 授权记录列表

创建rf_admin_trust委托（可选） 进入华为云官网，打开控制台管理界面，鼠标移动至个人账号处，打开“统一身份认证”菜单 图1 控制台管理界面 图2 统一身份认证菜单 进入“委托”菜单，搜索“rf_admin_trust”委托 图3 委托列表 如果委托存在，则不用执行接下来的创建委托的步骤 如果委托不存在时执行接下来的步骤创建委托 单击步骤2界面中的“创建委托”按钮，在委托名称中输入“rf_admin_trust”，委托类型选择“云服务”，输入“ RFS ”，单击“下一步” 图4 创建委托 在搜索框中输入”Tenant Administrator”并勾选搜索结果，单击“下一步”。 图5 选择策略 选择“所有资源”，并单击下一步完成配置 图6 设置授权范围 “委托”列表中出现“rf_admin_trust”委托则创建成功 图7 委托列表