All Products
Search
Document Center

ENS:DescribeReservedResource

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
The current API does not require request parameters

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID.

6666C5A5-75ED-422E-A022-7121FA18C968
Imagesobject []

The information about the image.

ImageNamestring

The name of the image.

centos_6_08_64_20G_alibase_****
ImageIdstring

The ID of the image.

centos_6_08_64_20G_alibase_****
SupportResourcesobject []

The resources.

EnsRegionIdstring

The ID of the node.

cn-beijing-cmcc
DataDiskSizesarray

The sizes of data disks.

string

The size of the data disk. Unit: GB.

2
SupportResourcesCountstring

The number of resources that you can purchase.

9
SystemDiskSizesarray

The sizes of system disks.

string

The size of the system disk. Unit: GB.

20
InstanceSpecstring

The specifications of instances.

ens.sn1.stiny
Codeinteger

The returned service code. 0 indicates that the request was successful.

0

Examples

Sample success responses

JSONformat

{
  "RequestId": "6666C5A5-75ED-422E-A022-7121FA18C968",
  "Images": {
    "Image": [
      {
        "ImageName": "centos_6_08_64_20G_alibase_****",
        "ImageId": "centos_6_08_64_20G_alibase_****"
      }
    ]
  },
  "SupportResources": {
    "SupportResource": [
      {
        "EnsRegionId": "cn-beijing-cmcc",
        "DataDiskSizes": {
          "DataDiskSize": [
            "2"
          ]
        },
        "SupportResourcesCount": "9",
        "SystemDiskSizes": {
          "SystemDiskSize": [
            "20"
          ]
        },
        "InstanceSpec": "ens.sn1.stiny"
      }
    ]
  },
  "Code": 0
}

Error codes

HTTP status codeError codeError messageDescription
400MissingParameterThe input parameters that is mandatory for processing this request is not supplied.-
400InstanceNotExistsThe user have no instances.-
400CallInterfaceCall Interface Happen Error.An error occurred when you call the operation.
400NoPermissionPermission denied.-
400InvalidParameter.%sThe specified field %s invalid. Please check it again.-

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 changed. The request parameters of the API has changedsee changesets
Change itemChange content
API DescriptionAPI Description Update.
Error CodesThe Error code has changed.
    Error Codes 400 change
Input ParametersThe request parameters of the API has changed.
    delete Input Parameters: Version