创建边缘容器应用版本，可以按照版本进行应用的迭代发布。
调试
您可以在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> | 是 | 该版本要部署的容器组，包含具体的镜像信息。 | [ { "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}" } ] |
| object | 是 | 单个容器对象。 | ||
| Name | string | 是 | 容器名称，同一个容器组下命名唯一。 | lxg-demo-er |
| Image | string | 是 | 镜像地址。 | registry-vpc.cn-shenzhen.aliyuncs.com/lihe****h/ea****ts_serv****am: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 |
| ProbeContent | object | 是 | 容器健康探针内容。 | |
| 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\"}] |
返回参数
示例
正常返回示例
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. | 名称已存在。 |
| 404 | InvalidApp.NotFound | The application does not exist. Check whether the application ID you specified is correct and try again. | 您传入的应用ID对应的应用不存在，请检查后重试。 |
| 500 | InternalError | Failed to call the service. Try again later or contact technical support. | 调用服务失败，请稍后重试或联系客服咨询详情。 |
访问错误中心查看更多错误码。