Reserve Edge Container Resources by Region via API - Edge Security Acceleration - Alibaba Cloud - Edge Security Acceleration

Updates the resource reservation configuration of an edge container application.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
Enable	boolean	No	Specifies whether to enable resource reservation.	true
Forever	boolean	No	Specifies whether to permanently enable reservation. Once enabled, you cannot set a reservation end time.	true
DurationTime	string	No	The reservation end time. This parameter uses UTC time. To convert from UTC+8, add 8 hours. For example, if the current time is 2006-01-02 06:04:05 in UTC+8, enter "2006-01-02T14:04:05Z".	2006-01-02T15:04:05Z
ReserveSet	array<object>	No	The list of reserved resources.
	object	No	The reserved region object.
Region	string	No	The region information. For the Chinese mainland, you can specify a major region. For special administrative regions and areas outside China, you can specify a country or region. The following list shows the parameter mappings: Chinese mainland: East China: huadong South China: huanan Central China: huazhong North China: huabei Northwest China: xibei Southwest China: xinan Northeast China: dongbei Special administrative regions and outside China: Taiwan (China): tw Macao (China): mo Hong Kong (China): hk Japan: jp United States: us Thailand: th South Korea: kr Russia: ru Singapore: sg France: fr Spain: es Italy: it Sweden: se United Arab Emirates: ae Indonesia: id Chile: cl Philippines: ph Malaysia: my Vietnam: vn Argentina: ar Australia: au Brazil: br Colombia: co Germany: de United Kingdom: gb Peru: pe Saudi Arabia: sa Netherlands: nl South Africa: za.	huazhong
Isp	string	No	The Internet service provider (ISP). The following ISPs are supported. You do not need to specify an ISP for special administrative regions or areas outside China: China Mobile: cmcc China Telecom: chinanet China Unicom: unicom.	cmcc
Replicas	integer	No	The number of container replicas.	1
AppId	string	No	The application ID. You can call the ListEdgeContainerApps operation to obtain the application ID. Important The AppId format is the app- prefix followed by a numeric suffix, with a total length of 20 to 64 characters (example: app-8806886***83794688). Call ListEdgeContainerApps to obtain an existing AppId, or call CreateEdgeContainerApp to create an application first. .	app-88068867578379****

Response elements

Element	Type	Description	Example
	object	Schema of Response
RequestId	string	The request ID.	1AB799CF-562A-5CAF-A99E-4354053D814F
Enable	boolean	Specifies whether to enable resource reservation.	true
Forever	boolean	Indicates whether reservation is permanently enabled.	true
DurationTime	string	The reservation end time. This parameter uses UTC time. To convert from UTC+8, add 8 hours. For example, if the current time is 2006-01-02 06:04:05 in UTC+8, enter "2006-01-02T14:04:05Z".	2006-01-02T15:04:05Z
ReserveSet	array<object>	The list of reserved resources.
	object	The reserved region object.
Region	string	The region information. For the Chinese mainland, you can specify a major region. For special administrative regions and areas outside China, you can specify a country or region. The following list shows the parameter mappings: Chinese mainland: East China: huadong South China: huanan Central China: huazhong North China: huabei Northwest China: xibei Southwest China: xinan Northeast China: dongbei Special administrative regions and outside China: Taiwan (China): tw Macao (China): mo Hong Kong (China): hk Japan: jp United States: us Thailand: th South Korea: kr Russia: ru Singapore: sg France: fr Spain: es Italy: it Sweden: se United Arab Emirates: ae Indonesia: id Chile: cl Philippines: ph Malaysia: my Vietnam: vn Argentina: ar Australia: au Brazil: br Colombia: co Germany: de United Kingdom: gb Peru: pe Saudi Arabia: sa Netherlands: nl South Africa: za.	huazhong
Isp	string	The Internet service provider (ISP). The following ISPs are supported. You do not need to specify an ISP for special administrative regions or areas outside China: China Mobile: cmcc China Telecom: chinanet China Unicom: unicom.	cmcc
Replicas	integer	The number of container replicas.	1

Examples

Success response

JSON format

{
  "RequestId": "1AB799CF-562A-5CAF-A99E-4354053D814F",
  "Enable": true,
  "Forever": true,
  "DurationTime": "2006-01-02T15:04:05Z",
  "ReserveSet": [
    {
      "Region": "huazhong",
      "Isp": "cmcc",
      "Replicas": 1
    }
  ]
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParameter	Invalid parameter. Check the parameter configuration.	Invalid parameter. Check the parameter configuration.
400	InvalidParameter.Appid	The format of the application ID is invalid. You can call ListEdgeContainerApps to obtain the application ID.	The format of the input application ID is incorrect. You can use the ListEdgeContainerApps API to obtain the application ID.
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.