edit-icon download-icon

DescribeRegions

Last Updated: Jul 13, 2018

Description

Used to return all region IDs.

Request parameters

Parameter name Type Required Description
Action String TRUE Operation interface name and system required parameter. Value: DescribeRegions
AcceptLanguage String FALSE Default value: none. Chinese: zh-CN, English: en-US, Japanese: ja
PageSize Integer FALSE The number of regions contained on each page. The default value is 10.
PageNumber Integer FALSE The page number of the list (beginning from 1).

Response parameters

Parameter name Type Description
RequestId String Request ID
TotalCount Integer The total number of returned region information items.
PageSize Integer The number of regions contained on each page.
PageNumber Integer The page number of the list.
Regions RegionType Region description.

Example

Request example

  1. GET https://nas.cn-hangzhou.aliyuncs.com/?Action=DescribeRegions
  2. &PageSize=2
  3. &PageNumber=1
  4. &<Public Request Parameter>

Response example

XML example

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <DescribeRegionsResponse>
  3. <PageNumber>1</PageNumber>
  4. <TotalCount>4</TotalCount>
  5. <PageSize>2</PageSize>
  6. <RequestId>A70BEE5D-76D3-49FB-B58F-1F398211A5C3</RequestId>
  7. <Regions>
  8. <Region>
  9. <RegionId>cn-hangzhou</RegionId>
  10. <RegionEndpoint>nas.cn-hangzhou.aliyuncs.com</RegionEndpoint>
  11. <LocalName>China East 1</LocalName>
  12. </Region>
  13. <Region>
  14. <RegionId>cn-shanghai</RegionId>
  15. <RegionEndpoint>nas.cn-shanghai.aliyuncs.com</RegionEndpoint>
  16. <LocalName>China East 2</LocalName>
  17. </Region>
  18. </Regions>
  19. </DescribeRegionsResponse>

JSON example

  1. {
  2. "TotalCount": 4,
  3. "PageSize": 2,
  4. "RequestId": "A70BEE5D-76D3-49FB-B58F-1F398211A5C3",
  5. "PageNumber": 1,
  6. "Regions": {
  7. "Region": [
  8. {
  9. "RegionId": "cn-hangzhou",
  10. "RegionEndpoint": "nas.cn-hangzhou.aliyuncs.com",
  11. "LocalName": "China East 1"
  12. },
  13. {
  14. "RegionId": "cn-shanghai",
  15. "RegionEndpoint": "nas.cn-shanghai.aliyuncs.com",
  16. "LocalName": "China East 2"
  17. }
  18. ]
  19. }
  20. }
Thank you! We've received your feedback.