All Products
Search
Document Center

Edge Security Acceleration:GetEdgeContainerAppResourceReserve

Last Updated:Nov 07, 2025

Obtain the resource reservation configuration of the 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:GetEdgeContainerAppResourceReserveget
*All Resources
*
    none
none

Request parameters

ParameterTypeRequiredDescriptionExample
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.

04F0F334-1335-436C-A1D7-6C044FE73368
Enableboolean

Whether to enable resource reservation.

true
Foreverboolean

Whether to enable resource reservation permanently.

true
DurationTimestring

The end time of the reservation. The input is UTC time. 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

Chinese mainland:

  • East China: huadong
  • South China: huanan
  • Central China: huazhong
  • North China: huabei
  • Northwest: xibei
  • Southwest: 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 following ISPs are supported. You do not need to enter this field for overseas and special administrative regions. ISP:

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

The number of container replicas.

1

Examples

Sample success responses

JSONformat

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368\n",
  "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.
400InternalErrorAn internal exception occurred, please try again later.An inner exception was triggered. Please try again later.
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.

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