调用DescribeRegions接口查询您可以使用的阿里云地域。

调试

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

请求参数

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

接口名称。

固定取值：DescribeRegions
PageSize Integer 否 10

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

取值范围：1~100

默认值：10
PageNumber Integer 否 1

列表的分页页码。

起始值（默认值）：1
FileSystemType String 否 standard

文件系统类型。

取值范围：

取值：

  • all：所有类型
  • standard（默认值）：通用型NAS
  • extreme：极速型NAS
  • cpfs：CPFS
    说明 仅中国站支持CPFS文件系统。

返回数据

名称 类型 示例值 描述
TotalCount Integer 1

查询到的地域数量。
RequestId String A70BEE5D-76D3-49FB-B58F-1F398211****

请求ID。
PageSize Integer 10

每页包含的地域数。
PageNumber Integer 1

当前页码。
Regions Array of Region

地域信息集合。
Region
LocalName String East China 1

地域名称。
RegionEndpoint String nas.cn-hangzhou.aliyuncs.com

地域对应的接入地址（Endpoint）。
RegionId String cn-hangzhou

地域ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeRegions
&PageSize=10
&PageNumber=1
&FileSystemType=standard
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<TotalCount>1</TotalCount>
<PageSize>10</PageSize>
<RequestId>A70BEE5D-76D3-49FB-B58F-1F398211****</RequestId>
<PageNumber>1</PageNumber>
<Regions>
    <Region>
        <RegionId>cn-hangzhou</RegionId>
        <RegionEndpoint>nas.cn-hangzhou.aliyuncs.com</RegionEndpoint>
        <LocalName>East China 1</LocalName>
    </Region>
</Regions>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "PageSize" : 10,
  "RequestId" : "A70BEE5D-76D3-49FB-B58F-1F398211****",
  "PageNumber" : 1,
  "Regions" : {
    "Region" : {
      "RegionId" : "cn-hangzhou",
      "RegionEndpoint" : "nas.cn-hangzhou.aliyuncs.com",
      "LocalName" : "East China 1"
    }
  }
}

错误码

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