功能介绍
1.1.8 Edge 应用版本管理
1.1.8.1 创建应用版本
功能介绍
创建应用版本
URI
POST /v1/{project_id}/v2x-edge-apps/{edge_app_id}/versions
表1-64 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 参数说明：项目ID。获取方法请 参见 获取项目ID。
取值范围：仅支持数字，a到f的 小写字母组合，长度32。
正则匹配：^[0-9a-f]{32}$
edge_app_id 是 String 参数说明：用户自定义应用唯一 ID。
取值范围：只允许字母、数字、
下划线（_）、连接符（-）、美 元符号（$）的组合。
最小长度：1 最大长度：32
请求参数
表1-65 请求 Header 参数
参数 是否必选 参数类型 描述
Instance-Id 否 String 参数说明：实例ID。dris物理实 例的唯一标识。获取方法参见获
取Instance-Id。
取值范围：仅支持数字，小写字 母和连接符（-）的组合，长度 36。
正则匹配：^[a-z0-9-]{36}$
X-Auth-Token 否 String 参数说明：用户Token，Token 认证鉴权时必选。通过调用IAM 服务 获取IAM用户Token接口 获取，接口返回的响应消息头中
“X-Subject-Token”就是需要 获取的用户Token。简要的获取 方法样例请参见 Token认证。
最小长度：1 最大长度：20000
表1-66 请求 Body 参数
参数 是否必选 参数类型 描述
version 是 String 参数说明：应用版本。
最小长度：1 最大长度：32
正则匹配：^[A-Za-z0-9-_.]*$
参数 是否必选 参数类型 描述
description 否 String 参数说明：应用描述。
取值范围：只允许中文、字母、
ings 是 ContainerSet
tingsDTO object
参数说明：容器配置。
command 否 Object 参数说明：启动命令。
args 否 Object 参数说明：启动参数。
表1-67 ContainerSettingsDTO
参数 是否必选 参数类型 描述
configs 否 ContainerCo nfigsDTO object
参数说明：容器特殊参数。
image_url 是 String 参数说明：镜像存储地址。
最小长度：1
最大长度：1000000
envs 否 Object 参数说明：环境变量。
volumes 否 Array of VolumeDTO objects
参数说明：卷配置。
resources 否 ResourceDTO
object 参数说明：资源配额。
表1-68 ContainerConfigsDTO
参数 是否必选 参数类型 描述
privileged 否 Boolean 参数说明：开启容器特权模式。
缺省值：false
host_network 否 Boolean 参数说明：是否使用主机网络模 式。
缺省值：true
restart_policy 是 String 参数说明：重启策略，容器执行 健康检查后失败后的策略。
最小长度：1 最大长度：255
正则匹配：Always|OnFailure|
Never container_por
t_list 否 Array of ContainerPor tDTO objects
参数说明：容器端口映射值。
表1-69 ContainerPortDTO
参数 是否必选 参数类型 描述
container_por
t 否 Integer 参数说明：构成一堆映射的容器
端口。
最小值：1 最大值：65535
host_port 否 Integer 参数说明：构成一对映射的物理 机对应网卡端口。
最小值：1 最大值：65535
host_ip 否 String 参数说明：对应网卡地址。
表1-70 VolumeDTO
参数 是否必选 参数类型 描述
name 是 String 参数说明：卷名称。
最小长度：1 最大长度：63
正则匹配：^[a-z0-9]*$
参数 是否必选 参数类型 描述
type 否 String 参数说明：挂载类型。
正则匹配：LOG|DB|CONFIG
source 是 String 参数说明：源路径。
正则匹配：^/(\w+/?)+$
destination 是 String 参数说明：卷挂载路径。
正则匹配：^/*(?!boot/|dev/|
etc/|lib/|pro/|sys/|usr/)(\w+/?)+
$
read_only 否 Boolean 参数说明：只读，默认只读。
表1-71 ResourceDTO
参数 是否必选 参数类型 描述
limits 否 ResourceConf
igDTO object 参数说明：允许容器使用的最大 资源。
requests 否 ResourceConf
igDTO object 参数说明：容器需要使用的最小 资源。
表1-72 ResourceConfigDTO
参数 是否必选 参数类型 描述
cpu 否 Float 参数说明：cpu个数。
最小值：0.01 最大值：1000
memory 否 Float 参数说明：内存大小。
最小值：0.01 最大值：1024000
gpu 否 Float 参数说明：gpu个数。
最小值：0.01 最大值：1024000
npu 否 Float 参数说明：npu个数。
最小值：0.01
表1-73 ExtDevice
参数 是否必选 参数类型 描述
source 是 String 参数说明：源路径。
正则匹配：^/([a-zA-Z_0-9-]
+/?)+$
destination 是 String 参数说明：卷挂载路径。
正则匹配：^/([a-zA-Z_0-9-]
+/?)+$
cgroup_permi
ssions 否 String 参数说明：只读，默认MRW。
最小长度：1 最大长度：63
响应参数
状态码： 200
表1-74 响应 Body 参数
参数 参数类型 描述
edge_app_id String 参数说明：用户自定义应用唯一ID。
取值范围：只允许字母、数字、下划线（_）、连 接符（-）、美元符号（$）的组合。
最小长度：0 最大长度：32
version String 参数说明：应用版本。
最小长度：0 最大长度：32
description String 参数说明：应用描述。
取值范围：只允许中文、字母、数字、下划线
（_）、中文分号（；）、中文冒号（：）、中文 问号（？）、中文感叹号（！）中文逗号
（，）、中文句号（。）、英文引号（;）、英文 冒号（:）、英文逗号（,）、英文句号（.）、英 文问号（?）、英文感叹号（!）、顿号（、）、
连接符（-）的组合。
最小长度：0 最大长度：255
正则匹配：^[a-zA-Z0-9_；：？！，;:、,.?!。\-\s
\u4e00-\u9fa5]*$
参数 参数类型 描述
created_time String 参数说明：创建时间。
最小长度：0 最大长度：255 last_modified
_time String 参数说明：最后一次修改时间。
最小长度：0 最大长度：255
state String 参数说明：应用版本状态。
取值范围：
● DRAFT：草稿
● PUBLISHED：发布
● OFF_SHELF：下线 枚举值：
● DRAFT
● PUBLISHED
● OFF_SHELF