更新时间:2024-04-03 GMT+08:00
分享

更新应用

功能介绍

更新应用

URI

PUT /v1/{project_id}/eihealth-projects/{eihealth_project_id}/apps/{app_id}

表1 路径参数

参数

是否必选

参数类型

描述

app_id

String

应用id

最小长度:1

最大长度:128

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

参数

是否必选

参数类型

描述

name

String

应用名称 目标应用名称 取值范围:长度为[1,56],以大小写字母开头,允许出现中划线(-)、下划线(_)、小写字母和数字,且必须以大小写字母或数字结尾。

最小长度:1

最大长度:56

version

String

应用版本 取值范围:[1,24],以小写字母或数字或大写字母开头,允许出现中划线,必须以小写字母或数字或大写字母结尾。更新应用时,应用版本不支持修改。

最小长度:1

最大长度:24

summary

String

应用简述 取值范围[0,128]

最小长度:0

最大长度:128

description

String

应用描述 取值范围[0,65535],后续支持markdown文本

最小长度:0

最大长度:65535

labels

Array of strings

应用标签 取值范围[0,5],单个标签最大长度32字符,支持中文、字母、数字、空格、下划线和中划线,且不能以空格开头或者结尾。

最小长度:1

最大长度:32

数组长度:0 - 5

image

String

docker镜像地址 取值范围[5-255],不能包含中文字符

最小长度:5

最大长度:255

commands

Array of strings

docker启动时执行命令 取值范围[1-300],单个命令长度取值范围[0-256],不能包含中文字符

最小长度:0

最大长度:256

数组长度:1 - 300

resources

ResourceDto object

应用申请资源

inputs

Array of AppInputParameterDto objects

应用的输入参数列表

数组长度:0 - 128

outputs

Array of AppOutputParameterDto objects

应用的输出参数列表

数组长度:0 - 128

node_labels

Array of strings

节点标签 取值范围[0,1],单个标签最大长度63字符

最小长度:1

最大长度:63

数组长度:0 - 1

icon

String

图标base64编码

最小长度:0

最大长度:20000

表4 ResourceDto

参数

是否必选

参数类型

描述

cpu_type

String

cpu架构类型,不填默认X86

最小长度:0

最大长度:24

cpu

String

cpu申请使用量,取值范围[0.1-128],单位C,支持一位小数。对于应用,不填默认1C;对于流程和作业,不填默认使用前一级的配置,填值会覆盖更新。覆盖关系:作业->流程->应用

最小长度:0

最大长度:24

memory

String

内存申请使用量,取值范围[0.1-3072],单位G,支持一位小数。对于应用,不填默认1G;对于流程和作业,不填默认使用前一级的配置,填值会覆盖更新。覆盖关系:作业->流程->应用

最小长度:0

最大长度:24

gpu_type

String

gpu架构类型,取值范围 ' '|GPU|Snt9|D310。对于流程和作业,不填默认使用前一级的配置,填值会覆盖更新。覆盖关系:作业->流程->应用

最小长度:0

最大长度:24

gpu

String

gpu申请使用量,取值范围[0-16],仅支持整数,Snt9有特殊约束,申请数量需要是0,1,2,4,8。对于应用,不填默认0;对于流程和作业,不填默认使用前一级的配置,填值会覆盖更新。覆盖关系:作业->流程->应用

最小长度:0

最大长度:24

表5 AppInputParameterDto

参数

是否必选

参数类型

描述

name

String

参数名称,单个应用内唯一。取值范围:长度为[1,32],以小写字母开头,允许出现中划线(-)、小写字母和数字,且必须以小写字母或数字结尾。

最小长度:1

最大长度:32

description

String

参数描述。取值范围:[0-255]

最小长度:0

最大长度:255

required

Boolean

参数是否必须

concurrent

String

参数是否开启并发。当前支持vars_iter并发类型,不填表示未开启并发。

最小长度:0

最大长度:16

type

String

参数类型。取值:[STRING,FILE,DIRECTORY,ENUM]

pattern

String

提示用户参数填写的格式,取值范围:[0-64]。对于STRING类型,匹配字符串内容,比如后缀约束.fastq;对于ENUM类型,可以提示一定要在param_enum列表范围内取值;对于FILE类型,约束文件后缀类型;对于DIRECTORY类型,提示目录下需要包含哪些文件;

最小长度:0

最大长度:64

values

Array of strings

参数取值 如填写,只支持填一项,根据参数类型进行不同的校验

最小长度:0

最大长度:2048

数组长度:0 - 128

enum

Array of strings

枚举参数的取值列表,列表最大长度20,每一项字符串最长128。参数类型为ENUM时需要填此字段

最小长度:0

最大长度:128

数组长度:0 - 20

表6 AppOutputParameterDto

参数

是否必选

参数类型

描述

name

String

参数名称,单个应用内唯一。取值范围:长度为[1,32],以小写字母开头,允许出现中划线(-)、小写字母和数字,且必须以小写字母或数字结尾。

最小长度:1

最大长度:32

description

String

参数描述。取值范围:[0-255]

最小长度:0

最大长度:255

required

Boolean

参数是否必须

type

String

参数类型。取值:[STRING,FILE,DIRECTORY,ENUM]

pattern

String

提示用户参数填写的格式,取值范围:[0-64]。对于STRING类型,匹配字符串内容,比如后缀约束.fastq;对于ENUM类型,可以提示一定要在param_enum列表范围内取值;对于FILE类型,约束文件后缀类型;对于DIRECTORY类型,提示目录下需要包含哪些文件;

最小长度:0

最大长度:64

values

Array of strings

参数取值 如填写,只支持填一项,根据参数类型进行不同的校验

最小长度:0

最大长度:2048

数组长度:0 - 128

enum

Array of strings

枚举参数的取值列表,列表最大长度20,每一项字符串最长128。参数类型为ENUM时需要填此字段

最小长度:0

最大长度:128

数组长度:0 - 20

响应参数

请求示例

更新应用,更新应用cpu资源为1C,内存资源为1G

https://eihealth.cn-north-4.myhuaweicloud.com/v1/{project_id}/eihealth-projects/{eihealth_project_id}/apps/{app_id}

{
  "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"
}

响应示例

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档