调用DescribeRegions查询您可以使用的地域。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeRegions

操作接口名,系统规定参数,取值:DescribeRegions

PageSize Integer 10

分页查询时,每个分页包含的地域个数。

  • 最大值:100。
  • 默认值:10。
PageNumber Integer 1

列表的分页页码。

  • 起始值:1。
  • 默认值:1。
FileSystemType String standard

文件系统类型。

  • 可选值:standard、extreme。
  • 默认值:standard

返回数据

名称 类型 示例值 描述
RequestId String A70BEE5D-76D3-49FB-B58F-1F398211A5C3

请求ID。

TotalCount Integer 4

查询到的地域总个数。

PageSize Integer 2

每个分页包含的地域个数。

PageNumber Integer 1

列表的分页页码。

Regions Array

地域的描述信息。

RegionId String cn-hangzhou

地域ID。

LocalName String East China 1

地域名称。

RegionEndpoint String nas.cn-hangzhou.aliyuncs.com

对应地域的服务入口地址。

示例

请求示例

GET https://nas.cn-hangzhou.aliyuncs.com/?Action=DescribeRegions
&PageSize=2
&PageNumber=1
&<公共请求参数>

正常返回示例

XML 格式

<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 格式

{
  "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"
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。