Call the DescribeRegions operation to query region information.

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

Only the request parameters specific to this operation and some common parameters are listed below. For more information, refer to Common parameters.

Action string required Sample value: DescribeRegions

The action that you want to perform. Value: DescribeRegions.

Version string required Sample value: 2020-04-01

The version of the API. Valid value: 2020-04-01.

MaxResults integer Optional Sample value: 10

The number of entries returned on each page in a pagination query.

Maximum value: 20

Minimum value: 1

Default value: 10

NextToken string Optional Sample value: --

Pagination token marking the query position. Omit this parameter for initial API requests. In the next query, set the NextToken parameter to the value returned by the previous API call.

RegionIds.N string[] Optional Sample value: RegionIds.1=cn-beijing

The region ID. Up to 20 region IDs are supported.

Argument - N: specifies the serial number of the region ID.

Separate multiple region IDs with &.

Response parameters

Only the response parameters specific to this operation are listed below. For more information, refer to the response structure.

NextToken string Sample value: bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******

The query credentials value returned by this call. If null is returned, this page is the last page.

Regions object[] Sample value: --

The information about the regions that meet the conditions.

RegionId string Sample value: cn-beijing

The region ID.

Sample request

Sample response

Error codes

The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.

Status code	Error code	Error message	Description
400	LimitExceeded.MaximumRegionIds	The number of specified RegionIds exceeds the maximum limit.	The number of specified region IDs exceeds the upper limit.
400	InvalidArgument	The specified argument is invalid.	The specified parameter is invalid.
429	FlowLimitExceeded	You've reached the limit on request rate of resources.	Request rate of resources exceeds the limit.
500	InternalError	An internal error has occurred.	An internal error occurred. Try again. If multiple attempts fail, submit a ticket.

Elastic Compute Service