华为云用户手册

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

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

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 数据对象（目录，文件）总数量 datas Array of DataSummaryRsp objects 数据对象列表 next_marker String 下一页开始标签 表5 DataSummaryRsp 参数 参数类型 描述 path String 对象全路径（项目名称:/路径） name String 名称 type String 枚举值： FILE FOLDER size Long 大小 缺省值：0 create_time String 创建时间 allowed_operate Boolean 可操作标记 缺省值：true deletable Boolean 可删除标记 缺省值：true

响应示例 状态码： 200 OK { "count" : 1, "datas" : [ { "path" : "test-project-id:/db_test1.txt", "name" : "db_test1.txt", "type" : "FILE", "size" : 1024, "create_time" : "2021-02-01T14:25:34Z", "allowed_operate" : true, "deletable" : true } ], "next_marker" : "text-01" }

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/datas 表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 path 否 String 指定文件夹（项目名称:/路径） 最小长度：0 最大长度：2000 search_key 否 String 查询关键词 最小长度：0 最大长度：2000 sort_dir 否 String 降序或升序（分别对应desc和asc，默认为desc） 缺省值：desc sort_key 否 String 排序字段（支持type，create_time） marker 否 String 开始标签 最小长度：0 最大长度：2000

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 role 是 String 角色类型：管理员(ADMIN)、操作者(OPERATOR) 枚举值： ADMIN OPERATOR

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

基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在医疗智能体平台控制台的我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone） 一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 华为云的区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 父主题： 使用前必读

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

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Integer 桶个数 buckets Array of ProjectBucketRsp objects 桶列表 表4 ProjectBucketRsp 参数 参数类型 描述 eihealth_project_id String 项目编号 eihealth_project_name String 项目名称 type String 桶类型(real:项目桶,quote:引用桶) quote_root Boolean 是否引用桶根路径

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 apps Array of AppListDto objects 应用列表 count Integer 应用总条数 表5 AppListDto 参数 参数类型 描述 id String 应用id name String 应用名称 version String 应用版本 summary String 应用简述 description String 应用描述 labels Array of strings 应用标签 create_time String 创建应用时间 update_time String 更新应用时间 user_name String 创建应用的用户名 source_project_name String 源项目名称 source_resource_id String 源资源id icon String 图标base64编码

响应示例 状态码： 200 OK { "apps" : [ { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "name" : "demo-app", "version" : "1.0.0", "summary" : "summary", "description" : "description", "labels" : [ "labelA", "labelB" ], "create_time" : "2021-01-30T02:34:36Z", "update_time" : "2021-01-30T02:53:26Z", "user_name" : "gwj-test-01" } ], "count" : 1 }

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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 overwrite 否 Boolean 执行策略（true：全部覆盖，false：全部跳过，默认为true） 缺省值：true sub_paths 是 Array of strings 复制的路径集 最小长度：1 最大长度：2000 数组长度：0 - 50 target_folder 否 String 目标文件夹 最小长度：0 最大长度：2000

请求示例 复制项目数据，使用覆盖模式，复制到目标目录为test。 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/datas/clone { "overwrite" : true, "sub_paths" : [ "folder1/", "folder2/test.txt" ], "target_folder" : "test/" }

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

URI GET /v1/{project_id}/eihealth-projects/{eihealth_project_id}/project-traces 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 华为云项目ID，您可以从获取项目ID中获取。 最小长度：1 最大长度：128 eihealth_project_id 是 String 平台项目ID，您可以在平台单击所需的项目名称，进入项目设置页面查看。 最小长度：1 最大长度：128 表2 Query参数 参数 是否必选 参数类型 描述 path 是 String 指定文件夹（路径） 最小长度：0 最大长度：2000 limit 否 Integer 限制量，单次查询总量，必须由数字组成，默认为100，取值范围[1,1000] 最小值：1 最大值：1000 缺省值：100 offset 否 Integer 偏移量，查询起始偏移，必须由数字组成，默认为0，取值范围[0,100000000] 最小值：0 最大值：100000000 缺省值：0

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 count Long 数据对象（目录，文件）总数量 datas Array of TraceDataRsp objects 数据对象列表 bucket_size Long 桶存量 表5 TraceDataRsp 参数 参数类型 描述 path String 对象全路径（项目名称:/路径） name String 名称 type String 枚举值： FILE FOLDER size Long 大小 缺省值：0 create_time String 创建时间 download_url String 下载链接

响应示例 状态码： 200 OK { "count" : 10, "datas" : [ { "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" } ], "bucket_size" : 1111 }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 X-Force 否 Boolean 是否强制停止作业 表3 请求Body参数 参数 是否必选 参数类型 描述 ids 是 Array of strings 批量操作作业id列表 最小长度：1 最大长度：128 数组长度：1 - 50

请求示例 批量取消作业，取消如下两个作业，默认强制终止模式。 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/jobs/batch-terminate { "ids" : [ "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "baabcb56-5bb6-11eb-8a0d-fa163e3ddba2" ] }

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

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 [数组元素] Array of BatchOperateJobRsp objects OK 表5 BatchOperateJobRsp 参数 参数类型 描述 id String 作业id status String 批量操作作业的结果 枚举值： SUCCEEDED FAILED message String 操作结果失败信息，仅在操作失败时会返回 状态码： 207 表6 响应Body参数 参数 参数类型 描述 [数组元素] Array of BatchOperateJobRsp objects MULTI_STATUS 表7 BatchOperateJobRsp 参数 参数类型 描述 id String 作业id status String 批量操作作业的结果 枚举值： SUCCEEDED FAILED message String 操作结果失败信息，仅在操作失败时会返回

响应示例 状态码： 200 OK [ { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "status" : "SUCCEEDED", "message" : "string" } ] 状态码： 207 MULTI_STATUS [ { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "status" : "SUCCEEDED", "message" : "string" }, { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba2", "status" : "FAILED", "message" : "string" } ]

请求示例 插入数据单条数据，列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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 column_values 是 Array of ColumnValueDto objects 列及对应值列表 数组长度：1 - 100 表4 ColumnValueDto 参数 是否必选 参数类型 描述 column 是 String 列名 最小长度：1 最大长度：63 value 否 String 该列对应的值 最小长度：0 最大长度：1073741824

响应示例 状态码： 200 OK { "jobs" : [ { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "name" : "demo-job", "description" : "description", "priority" : 0, "timeout" : 1440, "output_dir" : "/job", "status" : "SUCCEEDED", "create_time" : "2021-01-30T02:34:36Z", "finish_time" : "2021-01-30T02:53:26Z", "user_name" : "gwj-test-01", "tool_info" : { "tool_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "tool_name" : "demo-workflow", "tool_version" : "1.0.0", "tool_type" : "workflow" }, "still_running_tasks" : [ "task1", "task2" ] } ], "count" : 1 }