All Products
Search
Document Center

ENS:DescribePrePaidInstanceStock

Last Updated:Mar 12, 2024

Queries the specifications of resources that you can purchase.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
EnsRegionIdstringYes

The ID of the edge node.

cn-suzhou-telecom
SystemDiskSizeintegerYes

The ID of the systemdisk

100
DataDiskSizeintegerYes

The ID of the datadisk.

20
InstanceSpecstringYes

The size of the system disk. Unit: GB.

ens.sn1.stiny

Response parameters

ParameterTypeDescriptionExample
object
AvaliableCountinteger

The number of resources that you can purchase.

84
Coresinteger

The number of vCPUs.

1
DataDiskSizeinteger

The size of the data disk.

20
EnsRegionIdstring

The ID of the node.

cn-suzhou-telecom
InstanceSpecstring

The instance type.

ens.sn1.stiny
Memoryinteger

The memory size. Unit: GB.

2048
RequestIdstring

The ID of the request.

007833C8-E819-4122-B636-0D48D7BF6DFB
SystemDiskSizeinteger

The size of the system disk. Unit: GB.

20
ResourceGapstring

The reasons for resource scarcity

StockNotEnough

Examples

Sample success responses

JSONformat

{
  "AvaliableCount": 84,
  "Cores": 1,
  "DataDiskSize": 20,
  "EnsRegionId": "cn-suzhou-telecom",
  "InstanceSpec": "ens.sn1.stiny",
  "Memory": 2048,
  "RequestId": "007833C8-E819-4122-B636-0D48D7BF6DFB",
  "SystemDiskSize": 20,
  "ResourceGap": "StockNotEnough"
}

Error codes

HTTP status codeError codeError messageDescription
400NoPermissionPermission denied.-
400InvalidParameter.%sThe specified field %s invalid. Please check it again.-
400InventoryExceededThe Instance in stock are insufficient,please submit a ticket.-
400CallInterfaceCall Interface Happen Error.An error occurred when you call the operation.

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

Change history

Change timeSummary of changesOperation
2023-12-26API Description Update. The Error code has changedsee changesets
Change itemChange content
API DescriptionAPI Description Update.
Error CodesThe Error code has changed.
    Error Codes 400 change