调用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"
    }
  }
}

错误码

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