使用CreateEdgeContainerAppVersion创建边缘容器应用版本-边缘安全加速-阿里云-边缘安全加速(ESA)-阿里云帮助中心

创建边缘容器应用版本，可以按照版本进行应用的迭代发布。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

esa:CreateEdgeContainerAppVersion

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
AppId	string	是	应用 ID，可使用 ListEdgeContainerApps 接口获取应用 ID。	app-88068867578379****
Name	string	是	版本名称，长度6~128。	verson1
Remarks	string	否	备注信息。	test app
Containers	array<object>	是	该版本要部署的容器组，包含具体的镜像信息。镜像信息，由镜像地址及启动命令、参数、环境变量、探针规则等构成，支持多个镜像，json 数组结构。	[ { "Name": "container1", "Image": "image1", "Spec": "1C2G", "Command": "/bin/sh", "Args": "-c hello", "ProbeType": "tcpSocket", "ProbeContent": "{\"Port\":8080}" }, { "Name": "container2", "Image": "image2", "Spec": "2C4G", "ProbeType": "httpGet", "ProbeContent": "{\"Path\":\"/\",\"Port\":80,\"InitialDelaySeconds\":10}" } ]
	array<object>	是	单个容器对象。
Name	string	是	容器名称，同一个容器组下命名唯一。	lxg-demo-er
Image	string	是	镜像地址。	registry-vpc.cn-shenzhen.aliyuncs.com/lihe**h/eats_servam:3.
IsACRImage	boolean	是	是否为 ACR 镜像。	false
ACRImageInfo	object	否	ACR 镜像信息。
IsEnterpriseRegistry	boolean	否	是否为企业级镜像。	false
Domain	string	否	ACR 镜像域名。	1500.***.net
InstanceId	string	否	ACR 站点实例 ID。	xcdn-9axbo****
RegionId	string	否	ACR 镜像站点实例区域列表。	cn-shanghai
RepoId	string	否	镜像的仓库 ID。	crr-h1ghghu60ct****
RepoName	string	否	镜像仓库名称。	test_71
RepoNamespace	string	否	指定镜像仓库命名空间名称。	safeline
Tag	string	否	ACR 镜像标签。	3.40.2
TagUrl	string	否	ACR 镜像标签地址。	registry-vpc.cn-shenzhen.aliyuncs.com/**/eas*m:31
Spec	string	是	容器规格。表示算力规格，取值范围（1C2G \| 2C4G \| 2C8G \| 4C8G \| 4C16G \| 8C16G \| 8C32G）。	1C2G
Command	string	否	探针运行命令。表示启动命令，多个以空格分割。	nginx
Args	string	否	启动参数。表示启动参数，多个以空格分割。	-a
Storage	string	是	存储信息。标识存储空间，取值范围（0.5G \| 10G \| 20G \| 30G）。	0.5G
EnvVariables	string	否	环境变量。表示环境变量，格式为：key1=val1,key2=val2。	VITE_APP_TITLE=My App
PostStart	string	否	容器启动前执行命令。表示启动之前的命令，以空格为分隔，服务启动之前执行，一般用于初始化操作。	sh poststart.sh "echo hello world"
PreStop	string	否	容器停止前执行命令。表示启动之后的命令，以空格为分隔，服务退出之前执行，一般用于退出前的清理操作。	sh prestop.sh "echo hello world"
ProbeType	string	是	探针类型，支持如下几种类型： exec：命令型。 tcpSocket：tcp 探测型。 httpGet：http 访问型。	exec
ProbeContent	object	是	容器健康探针内容。	具体字段可参照k8s官方就绪探针的定义。
InitialDelaySeconds	integer	否	容器探针初始化延迟时间。	1
TimeoutSeconds	integer	否	容器健康检查的超时时间。	1
PeriodSeconds	integer	否	容器健康检查的间隔时间。	1
SuccessThreshold	integer	否	健康检查连续成功次数。	1
FailureThreshold	integer	否	容器健康检查连续失败次数。	3
Command	string	否	exec 类型探针探测命令。	echo ok
Port	integer	否	容器健康检查的端口。	9991
Host	string	否	健康检查的域名。	www.rewrite.com
Path	string	否	容器健康检查的路径。	/
Scheme	string	否	健康检查的请求协议。	http
HttpHeaders	string	否	HTTP 请求头。	[{\"Content-Type\":\"application/json\"}]

返回参数

名称	类型	描述	示例值
	object
VersionId	string	返回创建的版本的 ID。	ver-87962637161651****
RequestId	string	请求 ID。	04F0F334-1335-436C-A1D7-6C044FE73368

示例

正常返回示例

JSON格式

{
  "VersionId": "ver-87962637161651****",
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter.Name	The specified Name is invalid. Please check the Name parameter, which must be between 6 and 128 characters. Kindly make the necessary modifications and call the interface again.	Name 参数无效。请检查Name参数，该参数范围为6-128个字符之间，请进行修改后，重新调用接口。
400	InvalidParameter.Percentage	The Percentage parameter is invalid. Please check the Percentage parameter, which should be in the range of 1-100. Modify it accordingly and call the interface again.	Percentage 参数无效。请检查Percentage参数，该参数范围为1-100，请进行修改后，重新调用接口。
400	InvalidParameter.Image	The specified Image is invalid. Please check the Image parameter and make the necessary modifications and call the interface again.	Image参数非法。请检查Image参数，该参数不能赋值为非法字符如 @、#、% 等，请进行修改后，重新调用接口。
400	InvalidParameter.HttpHeaders	The specified HttpHeaders is invalid. Please check the HttpHeaders parameter. Please make the necessary changes and call the interface again.	HttpHeaders参数无效。请检查HttpHeaders参数是否填写，该参数不能包含 @ # 等非法字符，请进行修改后，重新调用接口。
400	InvalidParameter.appid	The format of the application ID is invalid. You can call ListEdgeContainerApps to obtain the application ID.	传入的应用ID格式不正确，可使用ListEdgeContainerApps接口获取应用ID。
400	InvalidParameter	The specified parameter is invalid.	输入参数规范校验失败。
400	ParameterAlreadyExist	Parameter uniqueness verification failed. Check for duplicate parameter values.	参数唯一性校验失败，请检查重复的参数值。
400	NameAlreadyExists	The name already exists.	名称已存在。
500	InternalError	Failed to call the service. Try again later or contact technical support.	调用服务失败，请稍后重试或联系客服咨询详情。
404	InvalidApp.NotFound	The application does not exist. Check whether the application ID you specified is correct and try again.	您传入的应用ID对应的应用不存在，请检查后重试。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。