Queries all regions.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeRegions

The operation that you want to perform. Set the value to DescribeRegions.

PageSize Integer No 10

The number of entries to return on each page.

  • Maximum value: 100.
  • Default value: 10.
PageNumber Integer No 1

The number of the page to return.

  • Pages start from page 1.
  • Default value: 1.
FileSystemType String No standard

The type of file system.

  • Valid values: standard and extreme.
  • Default value: standard.

Response parameters

Parameter Type Example Description
RequestId String A70BEE5D-76D3-49FB-B58F-1F398211A5C3

The ID of the request.

TotalCount Integer 4

The total number of regions.

PageSize Integer 2

The number of entries returned per page.

PageNumber Integer   1

The page number of the returned page.

Regions Array

The details of regions.

RegionId String cn-hangzhou

The ID of each region.

LocalName String East China 1

The name of the region.

RegionEndpoint String nas.cn-hangzhou.aliyuncs.com

The public endpoint of the region.

Examples

Sample requests

GET https://nas.cn-hangzhou.aliyuncs.com/?Action=DescribeRegions
&PageSize=2
&PageNumber=1
&<Common request parameters>

Sample success responses

XML format

<DescribeRegionsResponse>
    <PageNumber>1</PageNumber>
    <TotalCount>4</TotalCount>
    <PageSize>2</PageSize>
    <RequestId>A70BEE5D-76D3-49FB-B58F-1F398211A5C3</RequestId>
    <Regions>
        <Region>
            <RegionId>cn-hangzhou</RegionId>
            <RegionEndpoint>nas.cn-hangzhou.aliyuncs.com</RegionEndpoint>
	        <LocalName>East China 1</LocalName>
        </Region>
        <Region>
            <RegionId>cn-shanghai</RegionId>
	        <RegionEndpoint>nas.cn-shanghai.aliyuncs.com</RegionEndpoint>
            <LocalName>East China 2</LocalName>
        </Region>
    </Regions>
</DescribeRegionsResponse>

JSON format

{
  "TotalCount": 4,
  "PageSize": 2,
  "RequestId": "A70BEE5D-76D3-49FB-B58F-1F398211A5C3",
  "PageNumber": 1,
  "Regions": {
    "Region": [
      {
        "RegionId": "cn-hangzhou",
		"RegionEndpoint": "nas.cn-hangzhou.aliyuncs.com",
        "LocalName": "East China 1"
      },
      {
        "RegionId": "cn-shanghai",
        "RegionEndpoint": "nas.cn-shanghai.aliyuncs.com",
		"LocalName": "East China 2"
      }
    ]
  }
}

Error codes

For a list of error codes, visit the API Error Center.