更新时间:2021-12-27 GMT+08:00
分享

更新应用模板版本

功能介绍

更新一个应用模板版本

调试

您可以在API Explorer中调试该接口。

URI

PUT /v2/{project_id}/edgemgr/apps/{app_id}/versions/{version_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

app_id

String

应用模板ID

version_id

String

应用模板版本ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

ief-instance-id

String

铂金版实例ID,专业版实例为空值

表3 请求Body参数

参数

是否必选

参数类型

描述

envs

Array of Env objects

环境变量

volumes

Array of Volumes objects

卷配置

configs

configs object

容器特殊参数

resources

resources object

资源配额

command

Array of strings

启动命令

args

Array of strings

参数

liveness_probe

String

工作负载存活探针

readiness_probe

String

工作负载业务探针

npu_type

String

npu类型,支持D310类型和D910类型。

  • D310表示D310类型。

  • D910表示D910类型。

  • 不填表示为D310类型。

表4 Env

参数

是否必选

参数类型

描述

name

String

环境变量的key,由大小写字母或下划线开头,由数字、大小写字母、下划线组成,最大长度2048个字符,不允许重复

value

String

环境变量的value,最大长度20480个字符。value、value_from和field_path必须三选一使用。

value_from

value_from object

环境变量可使用配置项和密钥导入

field_path

String

该参数目前只支持赋值"status.hostIP",即引用边缘节点的IP地址作为环境变量。

表5 value_from

参数

是否必选

参数类型

描述

secret

Secrets object

环境变量引用密钥时使用。使用ValueFrom时,secret与configmap必须二选一。

configmap

ConfigsMap object

环境变量引用配置项时使用。

表6 Secrets

参数

是否必选

参数类型

描述

name

String

密钥的名称

key

String

密钥的属性名

表7 ConfigsMap

参数

是否必选

参数类型

描述

name

String

配置项的名称

key

String

配置项的属性名

表8 Volumes

参数

是否必选

参数类型

描述

name

String

卷名称,小写字母或数字,最长63个字符

type

String

卷的类型,支持configMap,secret,emptyDir,hostPath

source

String

卷来源,type为hostPath时输入路径,要求以/开头,后面可包含中划线,反斜杠,下划线,点号,字母,数字; secret时输入secret名称,configMap时输入configMap名称,emptyDir时输入disk或memory

destination

String

卷挂载路径,必须是合法的路径

read_only

Boolean

读写权限,configMap和secret类型只支持读权限

表9 configs

参数

是否必选

参数类型

描述

privileged

Boolean

默认为false,表示是否开启特权模式

host_network

Boolean

默认为true,其中true表示主机网络,而false表示端口映射

restart_policy

String

应用实例重启模式:

  1. Always:当容器终止退出后,总是重启容器;

  2. Onfailure:容器异常退出(退出码非0)时才重启容器;

  3. Never:容器终止退出后,不重启容器;

ports

Array of AppPorts objects

容器端口映射值

表10 AppPorts

参数

是否必选

参数类型

描述

container_port

Integer

构成一堆映射的容器端口

host_port

Integer

构成一对映射的物理机对应网卡端口

表11 resources

参数

是否必选

参数类型

描述

limits

limits object

允许容器使用的最大资源

requests

requests object

容器需要使用的最小资源

表12 limits

参数

是否必选

参数类型

描述

cpu

String

cpu核数,大于等于0.01,最大1000;请求不需要带单位

memory

String

内存大小,单位兆,大于等于0.01,最大1024000。注意:内存的limits值最小为4;请求不需要带单位

gpu

String

Gpu显存大小,单位兆,大于等于0.01,最大1024000;请求不需要带单位

npu

String

Npu个数,大于0,最大1000;请求不需要带单位

表13 requests

参数

是否必选

参数类型

描述

cpu

String

cpu核数,大于等于0.01,最大1000;请求不需要带单位

memory

String

内存大小,单位兆,大于等于0.01,最大1024000。注意:内存的limits值最小为4;请求不需要带单位

gpu

String

Gpu显存大小,单位兆,大于等于0.01,最大1024000;请求不需要带单位

npu

String

Npu个数,大于0,最大1000;请求不需要带单位

响应参数

状态码: 200

表14 响应Body参数

参数

参数类型

描述

version

AppVersionDetail object

app详情

表15 AppVersionDetail

参数

参数类型

描述

id

String

应用版本ID

version

String

应用版本号

created_at

String

创建时间

updated_at

String

更新时间 只有更新后才会出现该字段

project_id

String

项目ID

image_url

String

镜像存储地址

envs

Array of Env objects

环境变量

volumes

Array of Volumes objects

卷配置

configs

configs object

容器特殊参数

resources

Resources object

容器使用的资源

arch

String

架构

command

Array of strings

启动命令

args

Array of strings

参数

liveness_probe

liveness_probe object

工作负载存活探针

readiness_probe

readiness_probe object

工作负载业务探针

表16 Env

参数

参数类型

描述

name

String

环境变量的key,由大小写字母或下划线开头,由数字、大小写字母、下划线组成,最大长度2048个字符,不允许重复

value

String

环境变量的value,最大长度20480个字符。value、value_from和field_path必须三选一使用。

value_from

value_from object

环境变量可使用配置项和密钥导入

field_path

String

该参数目前只支持赋值"status.hostIP",即引用边缘节点的IP地址作为环境变量。

表17 value_from

参数

参数类型

描述

secret

Secrets object

环境变量引用密钥时使用。使用ValueFrom时,secret与configmap必须二选一。

configmap

ConfigsMap object

环境变量引用配置项时使用。

表18 Secrets

参数

参数类型

描述

name

String

密钥的名称

key

String

密钥的属性名

表19 ConfigsMap

参数

参数类型

描述

name

String

配置项的名称

key

String

配置项的属性名

表20 Volumes

参数

参数类型

描述

name

String

卷名称,小写字母或数字,最长63个字符

type

String

卷的类型,支持configMap,secret,emptyDir,hostPath

source

String

卷来源,type为hostPath时输入路径,要求以/开头,后面可包含中划线,反斜杠,下划线,点号,字母,数字; secret时输入secret名称,configMap时输入configMap名称,emptyDir时输入disk或memory

destination

String

卷挂载路径,必须是合法的路径

read_only

Boolean

读写权限,configMap和secret类型只支持读权限

表21 configs

参数

参数类型

描述

privileged

Boolean

默认为false,表示是否开启特权模式

host_network

Boolean

默认为true,其中true表示主机网络,而false表示端口映射

restart_policy

String

应用实例重启模式:

  1. Always:当容器终止退出后,总是重启容器;

  2. Onfailure:容器异常退出(退出码非0)时才重启容器;

  3. Never:容器终止退出后,不重启容器;

ports

Array of Ports objects

容器端口映射值

表22 Ports

参数

参数类型

描述

container_port

Integer

构成一堆映射的容器端口

host_port

Integer

构成一对映射的物理机对应网卡端口

host_ip

String

对应网卡地址

表23 Resources

参数

参数类型

描述

limits

limits object

允许容器使用的最大资源

requests

requests object

容器需要使用的最小资源

表24 limits

参数

参数类型

描述

cpu

Float

cpu核数,大于等于0.01,最大1000;请求不需要带单位

memory

Float

内存大小,单位兆,大于等于0.01,最大1024000。注意:内存的limits值最小为4;请求不需要带单位

gpu

Float

Gpu显存大小,单位兆,大于等于0.01,最大1024000;请求不需要带单位

npu

Float

Npu个数,大于0,最大1000;请求不需要带单位

表25 requests

参数

参数类型

描述

cpu

Float

cpu核数,大于等于0.01,最大1000;请求不需要带单位

memory

Float

内存大小,单位兆,大于等于0.01,最大1024000。注意:内存的limits值最小为4;请求不需要带单位

gpu

Float

Gpu显存大小,单位兆,大于等于0.01,最大1024000;请求不需要带单位

npu

Float

Npu个数,大于0,最大1000;请求不需要带单位

表26 liveness_probe

参数

参数类型

描述

exec_command

String

执行探测的命令行命令,长度1-10240内的字符串

http_get

http_get object

执行http探测

initial_delay_seconds

Integer

表示从工作负载启动后从多久开始探测,大于0且不大于3600的整数,默认为10

timeout_seconds

Integer

表示探测超时时间,大于0且不大于3600的整数,默认为1

表27 http_get

参数

参数类型

描述

path

String

必须要以/开头,构造结果为:协议类型://主机地址:端口路径

port

Integer

探测的http端口,1到65535之间的整数

host

String

请求的主机地址,默认为容器IP

scheme

String

协议类型,HTTP或HTTPS,默认HTTP

表28 readiness_probe

参数

参数类型

描述

exec_command

String

执行探测的命令行命令,长度1-10240内的字符串

http_get

http_get object

执行http探测

initial_delay_seconds

Integer

表示从工作负载启动后从多久开始探测,大于0且不大于3600的整数,默认为10

timeout_seconds

Integer

表示探测超时时间,大于0且不大于3600的整数,默认为1

表29 http_get

参数

参数类型

描述

path

String

必须要以/开头,构造结果为:协议类型://主机地址:端口路径

port

Integer

探测的http端口,1到65535之间的整数

host

String

请求的主机地址,默认为容器IP

scheme

String

协议类型,HTTP或HTTPS,默认HTTP

请求示例

{
  "version" : {
    "resources" : {
      "limits" : {
        "cpu" : 0.1,
        "memory" : 1024,
        "gpu" : 3.9
      },
      "requests" : {
        "cpu" : 0.1,
        "memory" : 1024,
        "gpu" : 3.9
      }
    },
    "envs" : [ {
      "name" : "key",
      "value" : "name"
    } ],
    "volumes" : [ {
      "name" : "test",
      "type" : "hostPath",
      "source" : "/tmp",
      "destination" : "/tmp0",
      "read_only" : true
    } ],
    "configs" : {
      "privileged" : true,
      "host_network" : true,
      "restart_policy" : "Always"
    }
  }
}

响应示例

状态码: 200

ok

{
  "envs" : [ {
    "name" : "MQ_IP",
    "value" : "127.0.0.1"
  } ],
  "created_at" : "2018-11-08T01:38:17.287510+08:00",
  "updated_at" : null,
  "version" : "1.11.08",
  "image_url" : "",
  "volumes" : [ ],
  "readiness_probe" : null,
  "configs" : {
    "host_network" : true,
    "restart_policy" : "Always",
    "privileged" : false
  },
  "project_id" : "{project_id}",
  "liveness_probe" : null,
  "id" : "8a33dc45-d18f-49b1-8573-6e60f9daa144",
  "npu_type" : "",
  "resources" : {
    "requests" : {
      "cpu" : 0.25,
      "memory" : 512
    },
    "limits" : {
      "cpu" : 1,
      "memory" : 512
    }
  }
}

状态码

状态码

描述

200

ok

错误码

请参见错误码

分享:

    相关文档

    相关产品

close