Creates an edge container application version. You can iteratively release applications by version. Note: 1) Your account must have an ESA plan with the Edge Container feature enabled. 2) Call CreateEdgeContainerApp first to create an application and obtain the AppId. 3) Complete call chain example: CreateEdgeContainerApp → ListEdgeContainerApps → CreateEdgeContainerAppVersion.
Try it now
Test
RAM authorization
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| AppId |
string |
Yes |
The application ID. You can call the ListEdgeContainerApps operation to obtain the application ID. Important 1) Your account must have an ESA plan with the Edge Container feature enabled. 2) Call CreateEdgeContainerApp first to create an application and obtain the AppId. 3) Complete call chain example: CreateEdgeContainerApp → ListEdgeContainerApps → CreateEdgeContainerAppVersion. |
app-88068867578379**** |
| Name |
string |
Yes |
The version name. The name must be 6 to 128 characters in length. |
verson1 |
| Remarks |
string |
No |
The remarks. |
test app |
| Containers |
array<object> |
Yes |
The container group to be deployed for this version, including specific image information. The image information consists of the image address, startup command, parameters, environment variables, and probe rules. Multiple images are supported in a JSON array structure. |
[ { "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> |
Yes |
A single container object. |
||
| Name |
string |
Yes |
The container name. The name must be unique within the same container group. |
lxg-demo-er |
| Image |
string |
Yes |
The image address. |
registry-vpc.cn-shenzhen.aliyuncs.com/lihe****h/ea****ts_serv****am:3.** |
| IsACRImage |
boolean |
Yes |
Specifies whether the image is an Alibaba Cloud Container Registry (ACR) image. |
false |
| ACRImageInfo |
object |
No |
The ACR image information. |
|
| IsEnterpriseRegistry |
boolean |
No |
Specifies whether the image is an enterprise-level image. |
false |
| Domain |
string |
No |
The ACR image domain name. |
1500.***.net |
| InstanceId |
string |
No |
The ACR instance ID. |
xcdn-9axbo**** |
| RegionId |
string |
No |
The region list of the ACR instance. |
cn-shanghai |
| RepoId |
string |
No |
The repository ID of the image. |
crr-h1ghghu60ct**** |
| RepoName |
string |
No |
The image repository name. |
test_71 |
| RepoNamespace |
string |
No |
The namespace of the image repository. |
safeline |
| Tag |
string |
No |
The ACR image tag. |
3.40.2 |
| TagUrl |
string |
No |
The ACR image tag URL. |
registry-vpc.cn-shenzhen.aliyuncs.com/****/eas***m:31 |
| Spec |
string |
Yes |
The container specifications. Specifies the computing specifications. Valid values: 1C2G, 2C4G, 2C8G, 4C8G, 4C16G, 8C16G, and 8C32G. |
1C2G |
| Command |
string |
No |
The startup command. Separate multiple commands with spaces. |
nginx |
| Args |
string |
No |
The startup parameters. Separate multiple parameters with spaces. |
-a |
| Storage |
string |
Yes |
The storage capacity. Valid values: 0.5G, 10G, 20G, and 30G. |
0.5G |
| EnvVariables |
string |
No |
The environment variables. Format: key1=val1,key2=val2. |
VITE_APP_TITLE=My App |
| PostStart |
string |
No |
The command to execute before the container starts. Separate multiple commands with spaces. This command is executed before the service starts and is typically used for initialization operations. |
sh poststart.sh "echo hello world" |
| PreStop |
string |
No |
The command to execute before the container stops. Separate multiple commands with spaces. This command is executed before the service exits and is typically used for cleanup operations before exit. |
sh prestop.sh "echo hello world" |
| ProbeType |
string |
Yes |
The probe type. Valid values:
|
exec |
| ProbeContent |
object |
Yes |
The container health probe content. |
For specific fields, refer to the official Kubernetes readiness probe definition |
| InitialDelaySeconds |
integer |
No |
The initial delay time for the container probe. Unit: seconds. For example, 5 indicates that the initial delay time is set to 5 seconds. |
5 |
| TimeoutSeconds |
integer |
No |
The timeout period for the container health check. Unit: seconds. For example, 5 indicates that the timeout period is set to 5 seconds. |
1 |
| PeriodSeconds |
integer |
No |
The interval for the container health check. Unit: seconds. For example, 5 indicates that the health check interval is set to 5 seconds. |
1 |
| SuccessThreshold |
integer |
No |
The number of consecutive successful health checks required. |
1 |
| FailureThreshold |
integer |
No |
The number of consecutive failed health checks required. |
3 |
| Command |
string |
No |
The probe command for exec-type probes. |
echo ok |
| Port |
integer |
No |
The port for the container health check. |
9991 |
| Host |
string |
No |
The domain name for the health check. |
www.rewrite.com |
| Path |
string |
No |
The path for the container health check. |
/ |
| Scheme |
string |
No |
The request protocol for the health check. |
http |
| HttpHeaders |
string |
No |
The HTTP request headers. |
[{\"Content-Type\":\"application/json\"}] |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
|||
| VersionId |
string |
The ID of the created version. |
ver-87962637161651**** |
| RequestId |
string |
The request ID. |
04F0F334-1335-436C-A1D7-6C044FE73368 |
Examples
Success response
JSON format
{
"VersionId": "ver-87962637161651****",
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 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. | The Name parameter is not valid. Check the Name parameter, which is between 6 and 128 characters. After modification, call the interface again. |
| 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. | The Percentage parameter is invalid. Check the Percentage parameter. The parameter range is 1-100. Modify the parameter and call the interface again. |
| 400 | InvalidParameter.Image | The specified Image is invalid. Please check the Image parameter and make the necessary modifications and call the interface again. | Illegal Image parameter. Please check the Image parameter, which cannot be assigned to illegal characters such @. |
| 400 | InvalidParameter.HttpHeaders | The specified HttpHeaders is invalid. Please check the HttpHeaders parameter. Please make the necessary changes and call the interface again. | The HttpHeaders parameter is invalid. Please check whether the HttpHeaders parameter is filled in. The parameter cannot contain @. |
| 400 | InvalidParameter.appid | The format of the application ID is invalid. You can call ListEdgeContainerApps to obtain the application ID. | The format of the application ID is invalid. You can call ListEdgeContainerApps to obtain the application ID. |
| 400 | InvalidParameter | The specified parameter is invalid. | The specified parameter is invalid. |
| 400 | ParameterAlreadyExist | Parameter uniqueness verification failed. Check for duplicate parameter values. | Parameter uniqueness verification failed. Check for duplicate parameter values. |
| 400 | NameAlreadyExists | The name already exists. | Name already exists. |
| 500 | InternalError | Failed to call the service. Try again later or contact technical support. | 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. | The application does not exist. Check whether the application ID you specified is correct and try again. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.