DescribeRegions - Elastic Compute Service - Alibaba Cloud Documentation Center

Queries available Alibaba Cloud regions.

Debugging

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

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
InstanceChargeType	string	No	The billing method of instances. For more information, see Billing overview. Valid values: PrePaid: subscription. If you set this parameter to PrePaid, make sure that you have sufficient balance or credits in your account. Otherwise, the InvalidPayMethod error code is returned. PostPaid: pay-as-you-go. Default value: PostPaid.	PrePaid
ResourceType	string	No	The resource type. Valid value: instance: Elastic Compute Service (ECS) instance disk: disk reservedinstance: reserved instance scu: storage capacity unit (SCU) Default value: instance.	instance
AcceptLanguage	string	No	The natural language that is used to filter responses. For more information, see RFC 7231. Valid values: zh-CN: Chinese en-US: English ja: Japanese Default value: zh-CN.	zh-CN

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The request ID.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Regions	array<object>	The queried regions.
	object
Status	string	Indicates whether clusters are sold out. Valid values: available soldOut	available
RegionEndpoint	string	The endpoint of the region.	ecs.aliyuncs.com
LocalName	string	The name of the region.	China (Qingdao)
RegionId	string	The region ID.	cn-qingdao-et2-bo1

Examples

Sample success responses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Regions": {
    "Region": [
      {
        "Status": "available",
        "RegionEndpoint": "ecs.aliyuncs.com",
        "LocalName": "China (Qingdao)",
        "RegionId": "cn-qingdao-et2-bo1"
      }
    ]
  }
}

Error codes

HTTP status code	Error code	Error message	Description
403	Unauthorized.EmptyRegion	The specified account has no access authority to any region.	You do not have permissions to access any regions. Apply for the permissions and try again.
403	Invalid.InstanceChargeType	The specified instanceChargeType is not valid.	The specified InstanceChargeType parameter is invalid.
404	InvalidAcceptLanguage.NotFound	Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.	Your selected language is invalid. Only Chinese, English, and Japanese are supported.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	The specified resource type does not exist.

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

Change history

Change time	Summary of changes	Operation

No change history