All Products
Search
Document Center

Edge Security Acceleration:UpdateEdgeContainerAppResourceReserve

Last Updated:Nov 07, 2025

Updates the resource reservation configuration of an edge container.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • For mandatory resource types, indicate with a prefix of * .
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
esa:UpdateEdgeContainerAppResourceReserveupdate
*All Resources
*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
EnablebooleanNo

Whether to enable resource reservation.

true
ForeverbooleanNo

Whether to permanently enable the reservation. Once it is enabled, you are not allowed to set the reservation deadline.

true
DurationTimestringNo

The end time of the reservation. The input time is UTC. It takes +8 hours to enter Beijing time. For example, if the current time is 2006-01-02 06:04:05, you need to enter "2006-01-02T14:04:05Z".

2006-01-02T15:04:05Z
ReserveSetarray<object>No

Reserved resource list.

objectNo

The reserved region object.

RegionstringNo

Information about the region. The Chinese mainland supports the input of regions and special administrative regions, and the regions outside the Chinese mainland support the input of countries. The following is the corresponding parameter mapping:

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 overseas:

  • Taiwan, China: tw
  • Macau, China: mo
  • Hong Kong, China: hk
  • Japan: jp
  • United States: us
  • Thailand: th
  • Korea: kr
  • Russia: ru
  • Singapore: sg
  • France: fr
  • Spain: es
  • Italy: it
  • Sweden: se
  • UAE: ae
  • Indonesia: id
  • Chile: cl
  • Philippines: ph
  • Malaysia: my
  • Vietnam: vn
  • Argentina: AR
  • Australia: au
  • Brazil: br
  • Colombia: co
  • Germany: de
  • UK: GB
  • Peru: pe
  • Saudi Arabia: sa
  • Netherlands: nl
  • South Africa: za
huazhong
IspstringNo

The ISP. The following types are supported. You do not need to enter the ISP in regions outside the Chinese mainland:

  • China Mobile: cmcc
  • China Telecom: chinanet
  • China Unicom: unicom
cmcc
ReplicasintegerNo

The number of container replicas.

1
AppIdstringNo

The application ID, which can be obtained by calling the ListEdgeContainerApps operation.

app-88068867578379****

Response parameters

ParameterTypeDescriptionExample
object

Schema of Response

RequestIdstring

The request ID.

1AB799CF-562A-5CAF-A99E-4354053D814F
Enableboolean

Whether to enable resource reservation.

true
Foreverboolean

Enable Permanent Incremental Backup

true
DurationTimestring

The end time of the reservation. The input time is UTC. It takes +8 hours to enter Beijing time. For example, if the current time is 2006-01-02 06:04:05, you need to enter "2006-01-02T14:04:05Z".

2006-01-02T15:04:05Z
ReserveSetarray<object>

Reserved resource list.

Itemobject

The reserved region object.

Regionstring

Information about the region. The Chinese mainland supports the input of regions and special administrative regions, and the regions outside the Chinese mainland support the input of countries. The following is the corresponding parameter mapping:

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 overseas:

  • Taiwan, China: tw
  • Macau, China: mo
  • Hong Kong, China: hk
  • Japan: jp
  • United States: us
  • Thailand: th
  • Korea: kr
  • Russia: ru
  • Singapore: sg
  • France: fr
  • Spain: es
  • Italy: it
  • Sweden: se
  • UAE: ae
  • Indonesia: id
  • Chile: cl
  • Philippines: ph
  • Malaysia: my
  • Vietnam: vn
  • Argentina: AR
  • Australia: au
  • Brazil: br
  • Colombia: co
  • Germany: de
  • UK: GB
  • Peru: pe
  • Saudi Arabia: sa
  • Netherlands: nl
  • South Africa: za
huazhong
Ispstring

The ISP. The following types are supported. You do not need to enter the ISP in regions outside the Chinese mainland:

  • China Mobile: cmcc
  • China Telecom: chinanet
  • China Unicom: unicom
cmcc
Replicasinteger

The number of container replicas.

1

Examples

Sample success responses

JSONformat

{
  "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 codeError codeError messageDescription
400InvalidParameterInvalid parameter. Check the parameter configuration.Invalid parameter. Check the parameter configuration.
400InvalidParameter.AppidThe 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.
404InvalidApp.NotFoundThe 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.
500InternalErrorFailed to call the service. Try again later or contact technical support.Failed to call the service. Try again later or contact technical support.

For a list of error codes, visit the Service error codes.