华为云用户手册

创建工作空间 登录专业版华为HiLens管理控制台，在左侧导航栏中“当前工作空间”下方的下拉框中选择“创建工作空间”。 进入“创建工作空间”页面。 图1 创建工作空间 也可以在左侧导航栏选择“工作空间”，在工作空间页面单击“创建工作空间”。 填写工作空间名称和描述，填完之后单击右下角的“立即创建”，跳到“工作空间”页面，可查看所创建的新工作空间。 填写工作空间描述时，请以中文、字母开头，以中文、字母、数字结尾，字符长度范围为4-48的字符，仅允许输入中文、字母、数字、中划线、下划线。 图2 创建工作空间-0

订单激活 使用订单号激活设备，需要先购买HiLens端云协同AI运行服务，详情请见订购HiLens端云协同AI运行服务。 登录专业版华为HiLens管理控制台，在左侧导航栏选择“设备管理”。 进入“设备列表”页面。 选择“设备状态”处于“运行中”，且“激活状态”处于“未激活”的设备，单击激活状态列的“立即激活”。 进入设备激活页面。 图1 激活设备 勾选订单，然后单击右下角的“确定”。 调至设备列表页面，设备激活成功后，设备的激活状态变成“已激活”。 图2 订单号激活

单个设备添加标签 在HiLens专业版管理控制台左侧菜单栏选择“设备管理”，然后在设备列表中，选择需要进行管理的某一设备，单击设备名称进入设备详情页面。 “设备详情”页面默认展示“部署列表”页签。 单击“标签”，切换至“标签”页签。 在“标签”页签，单击“添加标签”。 弹出“添加标签”对话框。 图2 添加标签 在“添加标签”对话框中填写“标签名”和“标签值”，单击“确定”。 只允许大小写字母、数字、下划线和中划线，不允许为空。标签名不允许重复，最大长度为36个字符，标签值最大长度为43个字符。最多可添加10组标签。 在“标签”页签可查看已添加的标签。

编辑标签 在HiLens专业版管理控制台左侧菜单栏选择“设备管理”，然后在设备列表中，选择需要进行管理的某一设备，单击设备名称进入设备详情页面。 “设备详情”页面默认展示“部署列表”页签。 单击“标签”，切换至“标签”页签。 在“标签”页签，单击“操作”列的“编辑”。 弹出“编辑标签”对话框。 图4 编辑标签 在“编辑标签”对话框中编辑“标签名”和“标签值”，单击“确定”。 在“标签”页签可查看重新编辑的标签。

标注数据集 在“数据标注”页面的标注数据集列表中，单击“操作”列“标注”。 在“数据标注”页面，在“数据集文件列表”下拉列表中选择文件。 单击“创建对话”顺次生成一条不完整信息（对话样式），用户根据实际需要填写对话的instruction（指令）、input（输入/提问）、output（输出/回答），完成一条数据标注。 对于单条标注，还可执行以下操作： 单击标注右侧“一键自动生成”由平台内置的模型一键生成所有行的output信息。 单击标注右侧“添加回答”可继续添加多条output。 单击标注右侧“删除”，可删除标注。 对于标注中的output，，还可执行以下操作： 单击output所在行右侧的“自动生成”，由平台内置的模型自动生成当前行的output信息。 单击output所在行右侧的“重新生成”，由平台内置的模型重新生成当前行的output信息。

更多操作 一条数据标注完成后，可执行如下表1所示的操作。 表1 更多操作 操作 说明 删除标注 在“数据标注”页面的标注数据集列表中，单击“操作”列“删除”。 发布标注 在“数据标注”页面的标注数据集列表中，单击“操作”列“发布”。 在“发布”对话框，有两种发布方式： 选择发布后“更新原始数据集”，单击“确认”，覆盖原数据集信息（数据集名称不变）。 选择发布后“创建新数据集”，设置新数据集名称，然后单击“确认”。

操作步骤 在“服务部署”页面，按表1填写服务的相关参数，然后单击右下角的“部署”。 图1 服务部署 表1 服务部署参数说明 参数 说明 服务名称 待部署的服务名称，首次部署服务请单击可修改默认服务名称。 如果在不同版本非首次部署服务，服务名称不支持修改。 描述 待部署服务的简要说明。 资源池 用于部署服务的资源池和资源类型。资源池可选“公共资源池”和“专属资源池”。 “公共资源池”：提供公共的大规模计算集群，资源按作业隔离。您可以按需选择不同的资源类型。 “专属资源池”：提供独享的计算资源，不与其他用户共享，更加高效。使用专属资源池需要在ModelArts创建专属资源池。 计算节点规格 界面上选择计算规格。 服务自动停止 设置服务自动停止的时间，在线服务运行状态在所选的时间点后自动停止，同时在线服务也停止计费。 计算节点个数 设置当前版本模型的实例个数。如果节点个数设置为1，表示后台的计算模式是单机模式；如果节点个数设置大于1，表示后台的计算模式为分布式的。请根据实际编码情况选择计算模式。 部署成功后，页面显示“服务部署成功”。您可以单击“查看应用监控”，进入应用监控页面查看监控信息，详情请见监控应用。

API调用 本章节以postman为例介绍如何调用API，建议使用SDK。 使用API调用时，因为需要使用Token进行认证鉴权，在鉴权中，会存在因华为账号升级导致的“无法使用主账户 获取Token ”的情况，产生“The username or password is wrong.”报错，该问题可以通过创建一个 IAM 子用户获取Token解决，处理步骤请参见帐密报错“The username or password is wrong.”。 获取Token。 由于自定义OCR部署在华北-北京四区域，因此需要获取北京四（cn-north-4）区域的Token。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Request Header: Content-Type: application/json Request Body: { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "IAM子用户名", "password": "密码", "domain": { "name": "主账户的用户名" } } } }, "scope": { "project": { "name": "cn-north-4" } } } 图8 请求header 图9 请求body 调用自定义OCR API。 依据下图的对应关系，将自定义OCR部署后生产的API填写至postman中。url中的{endpoint}需要替换为ocr.cn-north-4.myhuaweicloud.com。 在"image"参数中，输入图片的base64编码即可调用API。 图10 调用自定义OCR API

SDK调用 本章节以Python SDK为例介绍如何进行使用，其他语言SDK使用方法相同。 获取SDK。 在自定义OCR的“部署”页面，选择“SDK调用”获取SDK。 图2 获取SDK 导入SDK至PyCharm（请在PyCharm中提前配置python环境）。 图3 导入SDK 获取AK、SK。 AK/SK（Access Key ID/Secret Access Key）即访问密钥，包含访问密钥ID（AK）和秘密访问密钥（SK）两部分，华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。 登录访问密钥页面，依据界面操作指引，获取AK、SK。下载得到的访问密钥为credentials.csv文件，文件中的B列和C列分别是AK、SK信息。 图4 新增访问密钥 图5 AKSK文件 修改OCRDemo.py文件。 在文件中找到“aksk_request”，修改内容有两处： （1）填写获取的AK、SK。 （2）将代码示例中的请求url替换为自定义OCR部署后生成的url，只使用图片中用蓝色标注的字段进行替换。 （3）将代码示例中的# option["side"]="front"替换为： option["template_id"]="xxx" template_id的值可以在自定义OCR部署发布后获取。 图6 修改代码文件（修改前） 图7 修改代码文件（修改后） 调用自定义OCR SDK。 在示例代码“img_path”中输入需要识别的图片，并执行代码。

步骤5：评估模型 在应用开发的“模型评估”页面，您可以针对当前版本的模型进行整体评估和详细评估。 “整体评估”左侧显示当前模型的“版本”、“标签数量”、“验证集数量”。 “整体评估”右侧显示当前模型的评估参数值，包括“精准率”、“召回率”、“F1值”。 图9 整体评估 在应用开发的“模型评估”页面，您可以搜索查看测试集中数据模型预测结果。 “详细评估”左侧在搜索框中搜索标签，右侧显示正确标签所对应样本的正确标签和预测标签，您可以对比正确标签和预测标签，判断当前模型预测该样本是否预测正确。 例如搜索框内输入标签“1”，下方会显示正确标签为“1”的样本中，预测正确的样本数在验证集中的占比。右侧显示正确标签为“1”的样本信息，包括样本的正确标签和预测标签。 图10 详细评估 单击右下角的“发布部署”。 进入应用开发的“服务部署”页面。

步骤3：选择数据 在应用开发的“数据选择”页面，单击“新建数据集”。 右侧弹出“新建数据集”页面。 按表4填写数据集基本信息，然后单击“确定”。 图6 新建数据集 表4 新建数据集参数说明 参数 说明 推荐填写 数据集名称 待新建的数据集名称。支持输入中英文、数字、下划线及中划线。 本样例填写“test”。 描述 数据集简要描述。 - 数据集状态 上传的训练数据可以是已标注的数据，也可以是未标注的数据。 您可以根据自身业务选择“数据集状态”是“已标注数据集”还是“未标注数据集”。 数据集模板可在选择“数据集状态”后，单击下方的“文本分类已标注数据模板”或“文本分类未标注数据模板”，下载数据集模板至本地查看。 本样例使用已标注的数据集，所以选择“已标注数据集”。 如果您想手动修改标签，可单击数据集操作列的“标注”，进入数据集概览页单击右上角的“开始标注”，在“数据标注”页面手动标注数据，详细的操作指导请参考标注数据。 数据集输入位置 训练数据存储至OBS的位置。 单击“数据集输入位置”右侧输入框，在弹出的“数据集输入位置”对话框中，选择“OBS桶”和“文件夹”，然后单击“确定”。 选择步骤1：准备数据中提前上传数据集的OBS路径“mapro-nlp/data-in”。 数据集输出位置 待新建的数据集存储至OBS的位置。 单击“数据集输出位置”右侧的“修改”，在弹出的“数据集输出位置”对话框中，选择“OBS桶”和“文件夹”，然后单击“确定”。 选择步骤1：准备数据中提前创建好的输出数据集的OBS路径“mapro-nlp/data-out”。 勾选已上传的数据集。 服务进行标签解析，统计训练数据集中各个标签的样本数。 您可以选择打开“合并标签”开关，将样本数量较少的标签在模型训练中进行合并，以达到更优训练效果。 图7 数据选择 单击右下角“下一步”。 进入应用开发的“模型训练”页面。

步骤4：训练模型 在应用开发的“模型训练”页面，勾选模型训练所使用的“预训练模型”。 当前服务提供预置预训练模型“BERT”、“TinyBERT”、“FastText”。本样例使用“FastText”模型。 在参数配置，填写“学习率”和“训练轮次”。 本样例使用“学习率”为“0.00001”，“训练轮次”为“3”。 单击右下角的“开始训练”，开始训练模型。 模型训练一般需要运行一段时间，等模型训练完成后，可查看“训练详情”、“准确率变化情况”和“误差变化”。 图8 训练详情 模型训练完成后，单击右下角的“下一步”。 进入应用开发的“模型评估”页面。

步骤6：部署服务 在应用开发“服务部署”页面，按表5填写服务的相关参数，然后单击“部署”。 图11 服务部署 表5 服务部署参数说明 参数 说明 推荐填写 服务名称 待部署的服务名称，首次部署服务请单击可修改默认服务名称。 如果在不同版本非首次部署服务，服务名称不支持修改。 本样例使用默认服务名称。 描述 待部署服务的简要说明。 - 资源池 用于部署服务的资源池和资源类型。资源池可选“公共资源池”和“专属资源池”。 “公共资源池”：提供公共的大规模计算集群，资源按作业隔离。您可以按需选择不同的资源类型。 “专属资源池”：提供独享的计算资源，不与其他用户共享，更加高效。使用专属资源池需要在ModelArts创建专属资源池。 本样例选择“公共资源池”。 计算节点规格 界面上选择计算规格。 - 计算节点个数 设置当前版本模型的实例个数。如果节点个数设置为1，表示后台的计算模式是单机模式；如果节点个数设置大于1，表示后台的计算模式为分布式的。请根据实际编码情况选择计算模式。 本样例选择1个计算节点。 服务自动停止 设置服务自动停止的时间，在线服务运行状态在所选的时间点后自动停止，同时在线服务也停止计费。 本样例选择“1小时后”。 部署成功后，页面显示“服务部署成功”。您可以单击“查看应用监控”，进入应用监控页面查看监控信息，详情请见监控应用。

步骤1：准备数据 在开发应用之前，您需要自行准备训练数据集并上传至OBS桶及文件夹中。由于数据安全原因，本样例不提供具体的样例数据，仅提供样例数据要求。 本样例使用已标注数据训练模型，数据集要求如下： 文件格式要求为txt或者csv，文件大小不能超过8MB。 以换行符作为分隔符，每行数据代表一个标注对象。 每个分类标签需要准备5个及以上数据，为了训练出效果较好的模型，建议每个分类标签准备100个以上的数据。 文本分类的标注对象和标注内容在一个文本文件内，标注对象与标注内容之间，多个标注内容之间可分别指定分隔符。 例如，文本文件的内容如下所示。标注对象与标注内容之间采用Tab键分隔。 手感很好，反应速度很快，不知道以后怎样 positive 三个月前买了一个用的非常好果断把旧手机替换下来尤其在待机方面秒杀 positive 没充一会电源怎么也会发热呢音量健不好用回弹不好 negative 算是给自己的父亲节礼物吧物流很快下单不到24小时就到货了耳机更赞有些低音炮的感觉入耳很紧不会掉棒棒哒 positive 按上文要求准备训练数据集，并保存至本地，训练数据命名为“test.txt”。 登录OBS服务，创建桶和文件夹，用于存放数据集。 创建名称为“mapro-nlp”的OBS桶。 创建名称为“data-in”的文件夹用于存放训练数据集。 创建名称为“data-out”的文件夹用于存放输出的数据集。 创建OBS桶和文件夹的操作指导请参见创建桶和新建文件夹。为保证数据能正常访问，请务必确保创建的OBS桶与 ModelArts Pro 服务在同一区域。 参考上传文件，使用单个文件上传方式将本地准备的训练数据“test.txt”文件上传至OBS路径“mapro-nlp/data-in”下。

步骤1：准备数据 在开发应用之前，您需要设计好商品标签，并自行准备数据集并上传至OBS桶及文件夹中。 由于数据安全原因，本样例不提供具体的样例数据，仅提供适用本次样例的数据要求。本次样例需要准备两份数据，一份训练数据集用于训练模型，一份SKU数据用于创建SKU，即商品各类单品的图片，方便后续针对训练数据集中的数据进行自动标注。 商品标签 本次样例以蛋糕商品为例，设计“cream_cake”、“fruit_cake”、“cheese_cake”这三类标签。 数据格式 保证图片质量：不能有损坏的图片。 目前支持的格式包括JPG、JPEG、PNG、BMP。 训练数据集 本样例训练数据集使用未标注数据。 为了保证模型的预测准确度，训练样本跟真实使用场景尽量相似。 为保证模型的泛化能力，数据集尽量覆盖所有商品分类的图片，即覆盖所有标签的图片。 每个分类标签需要准备20个数据以上，为了训练出效果较好的模型，建议每个分类标签准备200个以上的数据。 所有图片放在一个文件目录下，示例如下所示。 ├─Training-Dataset │ IMG_20180919_114732.jpg │ IMG_20180919_114745.jpg │ IMG_20180919_114945.jpg 如果训练数据集使用已标注数据，数据要求请见数据集要求。

HiLens套件 HiLens套件当前处于公测阶段，可免费试用。但是由于使用过程中依赖 对象存储服务 （Object Storage Service，OBS）、ModelArts服务和华为HiLens服务的使用，依赖服务会产生相应的费用。 HiLens套件安全帽检测技能工作流中训练安全帽检测模型，会使用到ModelArts的计算资源，价格详情请见ModelArts价格详情。 HiLens套件涉及OBS收费的功能如表5所示，价格详情请见OBS价格详情。 HiLens套件部署技能至边缘设备，并在华为HiLens平台上进行模型管理和技能管理，华为HiLens服务价格详情请见计费说明。 表5 HiLens套件涉及OBS收费功能 功能 与OBS关系 上传训练数据集 ModelArts Pro上传的训练数据集存储在OBS中。 管理数据集 数据集存储在OBS中。 数据集的标注信息存储在OBS中。 支持从OBS中导入数据。 训练模型 训练模型使用的数据集存储在OBS中。 训练模型的运行脚本存储在OBS中。 训练模型输出的模型存储在指定的OBS中。

文字识别 套件 计费项 按API调用次数按需计费。 只有调用成功才会计算调用次数，其中2xx状态码表示调用成功。 计费模式 按需计费 指按照自定义模板文字识别API调用次数、阶梯价格计费，按月累计，一个自然月后次数清零重新累计。具体计费价格请参见文字识别价格详情，类型选择“ 自定义模板OCR ”。 套餐包 用户可以购买套餐包，扣费时，优先在套餐包内进行抵扣。超出套餐包额度，转回按需计费方式。具体计费价格请参见文字识别价格详情，类型选择“自定义模板OCR”。

自然语言处理 套件 计费项 自然语言处理套件具体收费项请参见表1，具体计费价格请参见ModelArts价格详情。 表1 自然语言处理计费项说明 计费项 说明 训练文本分类模型、训练实体抽取模型 工作流中训练模型时，会使用到ModelArts计算资源。 部署服务（在线服务） 工作流中部署在线服务时，会使用到计算型实例资源。 计费模式 按需购买。购买方式比较灵活，可以即开即停。 依赖服务计费 由于使用自然语言处理套件的过程中依赖对象存储服务（Object Storage Service，OBS）的使用，OBS服务会产生相应的费用。 自然语言处理套件涉及OBS收费的功能如表2所示，价格详情请见OBS价格详情。 表2 自然语言处理套件涉及OBS收费功能 功能 与OBS关系 上传训练数据集 ModelArts Pro上传的训练数据集存储在OBS中。 标注数据 ModelArts Pro标注的数据存储在OBS中。 管理数据集 数据集存储在OBS中。 数据集的标注信息存储在OBS中。 支持从OBS中导入数据。 训练模型 训练模型使用的数据集存储在OBS中。 训练模型的运行脚本存储在OBS中。 训练模型输出的模型存储在指定的OBS中。 部署应用 将存储在OBS中的应用部署上线为在线服务。

处理步骤 子账号（IAM用户）需要联系主账户授予使用OCR服务的权限。为IAM用户授权过程请参见为IAM用户分配权限、IAM用户登录并验证权限。 授权时，子账号所在的用户组，需要设置为OCR FullAccess权限。 图1 用户组权限 授权后，子账号登录自定义OCR（ModelArts Pro ）页面，服务会自动开通。 在子用户已经具备OCR权限，并开通ModelArts Pro后，如果仍然无法调用，请检查子用户是否有“编程访问权限”。 图2 编程访问权限

HiLens套件 HiLens套件当前处于公测阶段，可免费试用。但是由于使用过程中依赖对象存储服务（Object Storage Service，OBS）、ModelArts服务和华为HiLens服务的使用，依赖服务会产生相应的费用。 HiLens套件安全帽检测技能工作流中训练安全帽检测模型，会使用到ModelArts的计算资源，价格详情请见ModelArts价格详情。 HiLens套件涉及OBS收费的功能如表5所示，价格详情请见OBS价格详情。 HiLens套件部署技能至边缘设备，并在华为HiLens平台上进行模型管理和技能管理，华为HiLens服务价格详情请见计费说明。 表5 HiLens套件涉及OBS收费功能 功能 与OBS关系 上传训练数据集 ModelArts Pro上传的训练数据集存储在OBS中。 管理数据集 数据集存储在OBS中。 数据集的标注信息存储在OBS中。 支持从OBS中导入数据。 训练模型 训练模型使用的数据集存储在OBS中。 训练模型的运行脚本存储在OBS中。 训练模型输出的模型存储在指定的OBS中。

文字识别套件 计费项 按API调用次数按需计费。 只有调用成功才会计算调用次数，其中2xx状态码表示调用成功。 计费模式 按需计费 指按照自定义模板文字识别API调用次数、阶梯价格计费，按月累计，一个自然月后次数清零重新累计。具体计费价格请参见文字识别价格详情，类型选择“自定义模板OCR”。 套餐包 用户可以购买套餐包，扣费时，优先在套餐包内进行抵扣。超出套餐包额度，转回按需计费方式。具体计费价格请参见文字识别价格详情，类型选择“自定义模板OCR”。

自然语言处理套件 计费项 自然语言处理套件具体收费项请参见表1，具体计费价格请参见ModelArts价格详情。 表1 自然语言处理计费项说明 计费项 说明 训练文本分类模型、训练实体抽取模型 工作流中训练模型时，会使用到ModelArts计算资源。 部署服务（在线服务） 工作流中部署在线服务时，会使用到计算型实例资源。 计费模式 按需购买。购买方式比较灵活，可以即开即停。 依赖服务计费 由于使用自然语言处理套件的过程中依赖对象存储服务（Object Storage Service，OBS）的使用，OBS服务会产生相应的费用。 自然语言处理套件涉及OBS收费的功能如表2所示，价格详情请见OBS价格详情。 表2 自然语言处理套件涉及OBS收费功能 功能 与OBS关系 上传训练数据集 ModelArts Pro上传的训练数据集存储在OBS中。 标注数据 ModelArts Pro标注的数据存储在OBS中。 管理数据集 数据集存储在OBS中。 数据集的标注信息存储在OBS中。 支持从OBS中导入数据。 训练模型 训练模型使用的数据集存储在OBS中。 训练模型的运行脚本存储在OBS中。 训练模型输出的模型存储在指定的OBS中。 部署应用 将存储在OBS中的应用部署上线为在线服务。

响应示例 状态码： 200 OK { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "name" : "demo-job", "description" : "description", "labels" : [ "labelA", "labelB" ], "priority" : 0, "timeout" : 1440, "output_dir" : "/job/task", "status" : "SUCCEEDED", "create_time" : "2021-01-30T02:53:26Z", "finish_time" : "2021-01-30T02:53:26Z", "tool_info" : { "tool_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "tool_name" : "demo-workflow", "tool_version" : "1.0.0", "tool_type" : "workflow" }, "tasks" : [ { "task_name" : "app1-1", "display_name" : "步骤1", "output_dir" : "/task", "whole_output_dir" : "/workflow/task", "io_acc_type" : "SFS", "resources" : { "cpu_type" : "X86", "cpu" : "1C", "memory" : "1G", "gpu_type" : "GPU", "gpu" : 0 }, "location" : { "x" : 100, "y" : 100 }, "inputs" : [ { "name" : "dir-parameter", "values" : [ "/test" ] } ], "app_info" : { "app_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "app_name" : "demo-app", "app_version" : "1.0.0", "app_labels" : [ "labelA", "labelB" ], "app_summary" : "summary", "app_description" : "description", "app_image" : "gwj-test-01/busybox:latest", "app_commands" : [ "echo eihealth;" ], "app_input_parameters" : [ { "name" : "dir-parameter", "description" : "parameter description", "required" : true, "type" : "DIRECTORY", "pattern" : "*.fastq", "values" : [ "/test" ], "enum" : [ "/test" ] } ], "app_output_parameters" : [ { "name" : "dir-parameter", "description" : "parameter description", "required" : true, "type" : "DIRECTORY", "pattern" : "*.fastq", "values" : [ "/test" ] } ] } } ], "task_runtime_info" : [ { "task_name" : "app1-1", "create_time" : "2021-01-30T02:53:26Z", "finish_time" : "2021-01-30T02:53:26Z", "actual_running_time" : 100, "status" : "SUCCEEDED", "sub_tasks" : [ { "sub_task_name" : "app1-1-0", "create_time" : "2021-01-30T02:53:26Z", "finish_time" : "2021-01-30T02:53:26Z", "actual_running_time" : 100, "status" : "SUCCEEDED", "pod_create_time" : "2021-01-30T02:53:26Z", "pod_start_time" : "2021-01-30T02:53:26Z", "job_failed_times" : 0 } ] } ], "dag" : { "app1-1" : { } } }

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

请求示例 创建应用，应用名称为demo-app，版本为1.0.0 https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/apps { "name" : "demo-app", "version" : "1.0.0", "summary" : "summary", "description" : "description", "labels" : [ "labelA", "labelB" ], "image" : "gwj-test-01/busybox:latest", "commands" : [ "echo eihealth;" ], "resources" : { "cpu_type" : "X86", "cpu" : "1C", "memory" : "1G", "gpu_type" : "GPU", "gpu" : 0 }, "inputs" : [ { "name" : "dir-parameter", "description" : "parameter description", "required" : true, "concurrent" : "vars_iter", "type" : "DIRECTORY", "pattern" : "*.fastq", "values" : [ "/test" ] } ], "outputs" : [ { "name" : "dir-parameter", "description" : "parameter description", "required" : true, "type" : "DIRECTORY", "pattern" : "*.fastq", "values" : [ "/test" ] } ], "node_labels" : [ "health.node" ], "icon" : "data:image/png;base64,xxxxx" }

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

请求示例 更新作业，更新作业的cpu资源为1C，内存资源为1G https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/jobs/{job_id}/update { "tasks" : [ { "task_name" : "app1-1", "inputs" : [ { "name" : "dir-parameter", "source" : "MANUAL", "values" : [ "/test" ] } ], "resources" : { "cpu" : "1C", "cpu_type" : "X86", "memory" : "1G", "gpu_type" : "GPU", "gpu" : "0" }, "io_acc_type" : "SFS" } ] }

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

响应示例 状态码： 200 OK { "id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "name" : "demo-job", "description" : "description", "status" : "RUNNING", "create_time" : "2021-01-30T02:34:36Z", "finish_time" : "2021-01-30T02:53:26Z", "database_id" : "2adc4b5fbeeb4a518f177167074a5fb2", "database_column" : "user_name", "database_column_type" : "NEW", "clean_database_column" : true, "database_trigger" : [ { "name" : "status", "judge_mode" : "gte", "value" : "100" } ], "tool_info" : { "tool_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "tool_name" : "demo-workflow", "tool_version" : "1.0.0", "tool_type" : "workflow" }, "job_name" : "demo-job", "job_name_type" : "AUTO", "job_description" : "description", "labels" : [ "labelA", "labelB" ], "priority" : 0, "timeout" : 1440, "output_dir" : "/job", "output_dir_type" : "MANUAL", "node_labels" : [ "health.node" ], "io_acc_id" : "FFFFFFFF-FFFF-FFFF-FFFF-FFFFFFFFFFFF", "tasks" : [ { "task_name" : "app1-1", "display_name" : "步骤1", "output_dir" : "/task", "whole_output_dir" : "/workflow/task", "io_acc_type" : "SFS", "resources" : { "cpu" : "1C", "cpu_type" : "X86", "memory" : "1G", "gpu_type" : "GPU", "gpu" : "0" }, "location" : { "x" : 100, "y" : 100 }, "inputs" : [ { "name" : "dir-parameter", "source" : "MANUAL", "values" : [ "/test" ] } ], "app_info" : { "app_id" : "baabcb56-5bb6-11eb-8a0d-fa163e3ddba1", "app_name" : "demo-app", "app_version" : "1.0.0", "app_src_project_name" : "null", "app_labels" : [ "labelA", "labelB" ], "app_summary" : "summary", "app_description" : "description", "app_image" : "gwj-test-01/busybox:latest", "app_commands" : [ "echo eihealth;" ], "app_input_parameters" : [ { "name" : "dir-parameter", "description" : "parameter description", "required" : true, "concurrent" : "vars_iter", "type" : "DIRECTORY", "pattern" : "*.fastq", "values" : [ "/test" ], "enum" : null } ], "app_output_parameters" : [ { "name" : "dir-parameter", "description" : "parameter description", "required" : true, "type" : "DIRECTORY", "pattern" : "*.fastq", "values" : [ "/test" ], "enum" : null } ], "app_node_labels" : [ "health.node" ], "app_icon" : "data:image/png;base64,xxxxx" } } ] }

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