华为云用户手册

响应示例 状态码： 200 分子生成任务查询成功响应 { "status" : "finished", "result" : { "name" : "87ba6b54-2288-4a5d-90a2-3db01c22a9d2", "num_rounds" : 10, "num_expected" : 1000, "num_strong_constraints" : 0, "num_weak_constraints" : 5, "custom_props" : [ { "id" : "3b2dce64-c244-11ed-acf5-0255ac100017", "prop_definition" : { "id" : "c4c07032d1934671a0dfe3bd10416eea", "name" : "custom_prop_name", "type" : "numerical", "description" : "custom_prop_description" } } ], "prop_names" : [ "formula", "ab", "acute_toxicity_rule", "bace", "3b2dce64-c244-11ed-acf5-0255ac100017", "3b2dce64-c244-11ed-acf5-0255ac100017_std" ], "result" : [ { "smiles" : "c1ccccc1", "num_fulfilled_weak_constraints" : 3, "score" : 0.388029, "props" : [ "C6H6", "base", 0, 0.128335, 0.65, 0.88 ] }, { "smiles" : "C1CCCCC1", "num_fulfilled_weak_constraints" : 2, "score" : 0.304194, "props" : [ "C6H12", "base", 0, 0.163034, 0.65, 0.88 ] } ], "initial_dataset_size" : 2, "weak_constraints" : [ { "name" : "mw", "type" : "range", "range" : [ 100, 600 ] }, { "name" : "nhet", "type" : "range", "range" : [ 0, 15 ] }, { "name" : "fsp3", "type" : "range", "range" : [ 0.07317, null ] }, { "name" : "qedmean", "type" : "maximize" }, { "name" : "sascore", "type" : "minimize", "quantiles" : [ 0.1, 0.9 ] } ], "strong_constraints" : [ { "name" : "mw", "type" : "range", "range" : [ 100, 600 ] } ], "binding_site" : null } }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 status String 异步任务的状态：等待中、运行中、已完成、失败 枚举值： waiting running finished failed task_data GenerationTaskData object 分子生成任务的请求体 result GenerationResult object 分子生成任务的返回结果 表4 GenerationTaskData 参数 参数类型 描述 num_trials Integer 生成分子数量 strong_constraints Array of MoleculeConstraint objects 强约束集合 weak_constraints Array of MoleculeConstraint objects 弱约束集合 num_expected Integer 期望最大返回条目数（排序后取Top） initial_dataset Array of strings 初始化分子集合 binding_site BindingSite object 结合位点 custom_props Array of CustomProp objects 用户已开启的自定义属性集合 表5 GenerationResult 参数 参数类型 描述 name String 任务名 最小长度：1 最大长度：128 num_rounds Integer 总生成轮数 num_expected Integer 期望条目数 num_strong_constraints Integer 强约束数量 num_weak_constraints Integer 弱约束数量 prop_names Array of strings 分子ADMET属性名列表 result Array of GenerationResultItem objects 分子生成结果条目 initial_dataset_size Integer 初始化数据集的分子条目数 strong_constraints Array of MoleculeConstraint objects 强约束集合 weak_constraints Array of MoleculeConstraint objects 弱约束集合 binding_site BindingSite object 结合位点 custom_props Array of CustomProp objects 用户已开启的自定义属性集合 表6 GenerationResultItem 参数 参数类型 描述 smiles String 分子SMILES表达式 props Array of objects 分子ADMET属性值列表 num_fulfilled_weak_constraints Integer 分子所满足的弱约束数量 score Number 分子的打分 表7 MoleculeConstraint 参数 参数类型 描述 name String 属性名称 type String 属性约束类型 枚举值： bool range struct minimize maximize bool Boolean 属性约束类型bool的参数 range Array of numbers 属性约束类型range的参数 struct StructureConstraintParams object 结构约束参数 quantiles Array of numbers 属性约束类型minimize和maximize的参数 最小值：0.0 最大值：1.0 表8 StructureConstraintParams 参数 参数类型 描述 structs Array of strings 子结构SMILES exclusive Boolean 是否排除子结构 operator String 多个子结构之间的逻辑关系 缺省值：or 枚举值： or and 表9 BindingSite 参数 参数类型 描述 protein String 蛋白质3D结构，使用gzip压缩然后转base64格式 最小长度：1 最大长度：10000000 bounding_box BoundingBox object 结合口袋，包含口袋中心位置和尺寸大小 表10 BoundingBox 参数 参数类型 描述 center Array of numbers 口袋中心坐标; x, y, z轴的坐标 size Array of numbers 口袋尺寸大小; x, y, z轴的大小 最小值：1.7 最大值：500 表11 CustomProp 参数 参数类型 描述 id String 自定义属性的ID（API侧） 最小长度：1 最大长度：64 prop_definition PropDefinition object 属性定义的元信息 表12 PropDefinition 参数 参数类型 描述 id String 属性业务侧ID 最小长度：1 最大长度：128 name String 属性名称 最小长度：1 最大长度：32 type String 属性类型 枚举值： binary numerical description String 属性具体描述信息 最小长度：0 最大长度：256 value_range ValueRange object 属性有效值域区间 optimal_range ValueRange object 属性最优值域区间 warning_range ValueRange object 属性欠佳值域区间 style String 模型参数呈现类型 枚举值： number probability confidential_interval Boolean 模型推理是否呈现置信区间 表13 ValueRange 参数 参数类型 描述 lower Number 值域下限 lower_inclusive Boolean 是否包含值域下限 upper Number 值域上限 upper_inclusive Boolean 是否包含值域上限

请求示例 创建一个分子生成任务 { "num_trials" : 10000, "weak_constraints" : [ { "name" : "mw", "type" : "range", "range" : [ 100, 600 ] }, { "name" : "nhet", "type" : "range", "range" : [ 0, 15 ] }, { "name" : "fsp3", "type" : "range", "range" : [ 0.07317, null ] }, { "name" : "qedmean", "type" : "maximize" }, { "name" : "sascore", "type" : "minimize", "quantiles" : [ 0.1, 0.9 ] }, { "name" : "3b2dce64-c244-11ed-acf5-0255ac100017", "type" : "range", "range" : [ 0.2, 0.5 ] } ], "initial_dataset" : [ "c1ccccc1", "C1CCCCC1" ], "custom_props" : [ { "id" : "3b2dce64-c244-11ed-acf5-0255ac100017", "prop_definition" : { "id" : "c4c07032d1934671a0dfe3bd10416eea", "name" : "custom_prop_name", "type" : "numerical", "description" : "custom_prop_description" } } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户 token 表3 请求Body参数 参数 是否必选 参数类型 描述 num_trials 否 Integer 生成分子数量 strong_constraints 否 Array of 表4 objects 强约束集合 weak_constraints 否 Array of 表4 objects 弱约束集合 num_expected 否 Integer 期望最大返回条目数（排序后取Top） initial_dataset 否 Array of strings 初始化分子集合 binding_site 否 表6 object 结合位点 custom_props 否 Array of 表8 objects 用户已开启的自定义属性集合 表4 MoleculeConstraint 参数 是否必选 参数类型 描述 name 否 String 属性名称 type 是 String 属性约束类型 枚举值： bool range struct minimize maximize bool 否 Boolean 属性约束类型bool的参数 range 否 Array of numbers 属性约束类型range的参数 struct 否 表5 object 结构约束参数 quantiles 否 Array of numbers 属性约束类型minimize和maximize的参数 最小值：0.0 最大值：1.0 表5 StructureConstraintParams 参数 是否必选 参数类型 描述 structs 是 Array of strings 子结构SMILES exclusive 是 Boolean 是否排除子结构 operator 否 String 多个子结构之间的逻辑关系 缺省值：or 枚举值： or and 表6 BindingSite 参数 是否必选 参数类型 描述 protein 否 String 蛋白质3D结构，使用gzip压缩然后转base64格式 最小长度：1 最大长度：10000000 bounding_box 否 表7 object 结合口袋，包含口袋中心位置和尺寸大小 表7 BoundingBox 参数 是否必选 参数类型 描述 center 否 Array of numbers 口袋中心坐标。 x, y, z轴的坐标 size 否 Array of numbers 口袋尺寸大小。x, y, z轴的大小 最小值：1.7 最大值：500 表8 CustomProp 参数 是否必选 参数类型 描述 id 是 String 自定义属性的ID（API侧） 最小长度：1 最大长度：64 prop_definition 否 表9 object 属性定义的元信息 表9 PropDefinition 参数 是否必选 参数类型 描述 id 否 String 属性业务侧ID 最小长度：1 最大长度：128 name 否 String 属性名称 最小长度：1 最大长度：32 type 否 String 属性类型 枚举值： binary numerical description 否 String 属性具体描述信息 最小长度：0 最大长度：256 value_range 否 表10 object 属性有效值域区间 optimal_range 否 表10 object 属性最优值域区间 warning_range 否 表10 object 属性欠佳值域区间 style 否 String 模型参数呈现类型 枚举值： number probability confidential_interval 否 Boolean 模型推理是否呈现置信区间 表10 ValueRange 参数 是否必选 参数类型 描述 lower 否 Number 值域下限 lower_inclusive 否 Boolean 是否包含值域下限 upper 否 Number 值域上限 upper_inclusive 否 Boolean 是否包含值域上限

响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。 对于获取用户Token接口，返回如下消息体。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "aaa", //假设区 域名 称是“aaa” ...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示 { "error_msg": "The format of message is error", "error_code": "AS.0001" } 其中，error_code表示错误码，error_msg表示错误描述信息。

响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 表1 公共响应消息头 消息头名称 说明 是否必选 Content-Type 用于指明发送给接收者的实体正文的媒体类型。 类型：字符串。 默认值：application/json; charset=UTF-8 是 对于获取用户Token接口，返回如图1所示。 其中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。 图1 获取用户Token响应消息头

Token认证 Token的有效期为24小时，需要使用同一个Token鉴权时，可以缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 username为 IAM 用户名，domainname为账号名，********为用户登录密码，project name为项目名称。可登录控制台“我的凭证”页面获取。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type:application/json { "auth": { "identity": { "methods": ["password"], "password": { "user": { "name": "username", "password": "**********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxx" //替换为实际的project name，如cn-north-4 } } } } 获取Token 后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 GET https://iam.cn-north-4.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ....

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。如果请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，cn-north-4为project的名称，获取方法请参见获取用户名、账号名和项目name。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token的作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type:application/json { "auth": { "identity": { "methods": ["password"], "password": { "user": { "name": "username", "password": "**********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxx" //替换为实际的project name，如cn-north-4 } } } } 到这里为止这个请求需要的内容就齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP请求方法 方法 说明 GET 请求服务器返回指定资源. PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为 “POST”，则其请求为： POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json X-Auth-Token: ABCDEFJ....

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 请求URI 参数 说明 URI-scheme 传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器域名或IP，不同服务在不同区域时，对应Endpoint不同，可以从终端节点中获取。 例如 EIHealth 服务在“华北-北京四”区域的Endpoint为“eihealth.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，可选，查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如，您需要获取IAM在“华北-北京四”区域的Token，则需使用“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens 为查看方便，服务每个具体API的URI，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 如下公共消息头需要添加到请求中。 表3 公共请求消息头 参数名 说明 是否必选 示例 Content-type 消息体的类型（格式），默认取值为“application/json”。 是 application/json 例如，对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

API概览 医疗智能体 平台所提供的API，均符合RESTful API设计规范，如表1所示。 临床研究和药物设计所提供的API，均符合RESTful API设计规范，如表2所示。 表1 医疗智能体平台API 类型 API 说明 项目管理 项目管理 项目创建、获取项目详情、删除项目等相关操作API。 系统管理 系统管理 系统设置、系统资源、用户管理、消息中心、标签等相关操作API。 镜像管理 标签页面管理 导入镜像、更新镜像、创建镜像、删除镜像等相关操作API。 数据管理 数据管理 数据归档、数据管理等相关操作API。 数据库管理 数据库管理 数据库管理、模板管理等相关操作API。 应用管理 应用管理 导入应用、创建应用、获取应用详情、删除应用等相关操作API。 流程管理 流程管理 导入流程、创建流程、获取流程详情、删除流程等相关操作API。 作业管理 作业管理 启动作业、获取作业详情、停止作业等相关操作API。 资产市场 资产市场 资产管理、资产收藏、供应商管理等相关操作API。 开发环境 notebook开发环境 Notebook开发环境创建、更新、删除等相关操作API。 虚拟药物筛选 虚拟药物筛选 创建study、列举study、删除study等相关操作API。 表2 临床研究、AI辅助药物设计API 类型 API 说明 药物设计 API（AI辅助药物设计） 分子生成、分子优化、靶点化合物结合预测、分子属性预测相关操作API。

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

终端节点 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从地区和终端节点中查询服务的终端节点。 医疗智能体平台的终端节点如表1所示，药物设计、临床研究的终端节点如表2所示，请您根据业务需要选择对应区域的终端节点。 表1 终端节点（医疗智能体平台API） 区域名称 区域 终端节点（Endpoint） 协议类型 华北-北京四 cn-north-4 eihealth.cn-north-4.myhuaweicloud.com eihealth.cn-north-4.myhuaweicloud.cn HTTPS 华东-上海一 cn-east-3 eihealth.cn-east-3.myhuaweicloud.com eihealth.cn-east-3.myhuaweicloud.cn HTTPS 华南-广州 cn-south-1 eihealth.cn-south-1.myhuaweicloud.com eihealth.cn-south-1.myhuaweicloud.cn HTTPS 表2 终端节点（AI辅助药物设计API、临床研究API） 区域名称 区域 终端节点（Endpoint） 协议类型 华东-上海一 cn-east-3 eihealth-api.cn-east-3.myhuaweicloud.com eihealth-api.cn-east-3.myhuaweicloud.cn HTTPS 表3 终端节点（医学影像） 区域名称 区域 终端节点（Endpoint） 协议类型 华南-广州 cn-south-1 eihealth.cn-south-1.myhuaweicloud.com HTTPS 父主题： 使用前必读

概述 欢迎使用医疗智能体（EIHealth）平台，该服务基于华为云AI和大数据技术优势，为基因组分析、药物研发和临床研究三个领域提供的专业AI研发平台。平台提供大量相关模型、算法及数据资源，是一站式的医疗研发平台。EIHealth以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务，支持的全部API请参见API概览。 在调用医疗智能体平台API之前，请确保已经充分了解医疗智能体平台的相关概念，详细信息请参见《产品介绍》和《用户指南》。 您可以使用本文档提供的API对EIHealth平台的资源进行相关操作。 父主题： 使用前必读

请求示例 测试 CSS 资源连通性，选择id为2f042ad4-6aca-11ed-b7f6-fa163e504fdd的 CS S资源，集群管理员为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

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

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

URI POST /v1/{project_id}/eihealth-projects/{eihealth_project_id}/templates/upload 表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}/datas/upload 表1 路径参数 参数 是否必选 参数类型 描述 eihealth_project_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。 最小长度：1 最大长度：32768 表3 FormData参数 参数 是否必选 参数类型 描述 file 是 File 文件流对象 target_folder 否 String 目标文件夹 最小长度：0 最大长度：2000 part_number 否 String 分段序号，表示第几个文件片段 缺省值：1 最小长度：1 最大长度：4 total_part 否 String 分段总数，上传的文件总共分成了几个片段 缺省值：1 最小长度：1 最大长度：4 multipart_id 否 String 分段上传任务id，除了第一个片段外，后续的片段都需要标识出任务id 最小长度：1 最大长度：128 file_name 否 String 文件名称 最小长度：1 最大长度：2000 md5 否 String 文件MD5值 最小长度：1 最大长度：2000

请求示例 更新流程，更新流程的cpu资源为1C，内存资源为1G。 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/workflows { "name" : "demo-workflow", "version" : "1.0.0", "summary" : "summary", "description" : "description", "labels" : [ "labelA", "labelB" ], "timeout" : 1440, "output_dir" : "/workflow", "tasks" : [ { "task_name" : "app1-1", "app_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "display_name" : "步骤1", "output_dir" : "/task", "resources" : { "cpu_type" : "X86", "cpu" : "1C", "memory" : "1G", "gpu_type" : "GPU", "gpu" : 0 }, "location" : { "x" : 100, "y" : 100 }, "inputs" : [ { "name" : "dir-parameter", "values" : [ "/test" ] } ] } ] }

URI PUT /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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 FormData参数 参数 是否必选 参数类型 描述 file 是 File 文件流对象 name 是 String 供应商名称 最小长度：1 最大长度：30

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 operation 是 String 是否开启资源配额限制 枚举值： OPEN CLOSE settings 是 UserSettingDto object 更新用户请求体 表4 UserSettingDto 参数 是否必选 参数类型 描述 job_quota 是 Integer 允许同时运行的作业数 最小值：1 最大值：100 job_timeout 是 Integer 作业执行超时时长，单位天 最小值：1 最大值：60 cpu_quota 是 Integer 作业的CPU资源配额，单位核 最小值：1 最大值：1024 mem_quota 是 Integer 作业的内存资源配额，单位GB 最小值：1 最大值：1024 projects_per_user 否 Integer 用户可创建项目数配额 最小值：0 最大值：20 缺省值：2

请求示例 更新用户设置，设置开启资源配额限制，设置作业配额为10，作业超时时长为1天，CPU的核数配额为50，内存的配额为128GB，用户可创建的项目数为2 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/users/{user_id}/settings { "operation" : "OPEN", "settings" : { "job_quota" : 10, "job_timeout" : 1, "cpu_quota" : 50, "mem_quota" : 128 } }

请求参数 表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

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，获取Token接口响应消息头中X-Subject-Token的值即为Token。 最小长度：1 最大长度：32768 表3 请求Body参数 参数 是否必选 参数类型 描述 password 否 String 新密码，在8-32位之间支持用户自定义密码长度，至少包含以下四种字符中的两种： 大写字母、小写字母、数字和特殊字符。 最小长度：8 最大长度：32 mobile 否 String 用户手机号，纯数字，长度小于等于32位，当且仅当重置手机号时传入空串。必须与国家码同时存在。 最小长度：0 最大长度：32 areacode 否 String 国家码，当且仅当重置手机号时传入空串。中国大陆为“0086” 最小长度：0 最大长度：10 email 否 String 用户邮箱，需符合邮箱格式 最小长度：0 最大长度：128