调用DescribeZones接口查询一个地域下的所有可用区及可用区所支持的文件系统类型。

调试

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

请求参数

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

接口名称。

固定取值：DescribeZones。
RegionId String 是 cn-hangzhou

可用区所在的地域ID。

您可以调用DescribeRegions查看最新地域列表。
FileSystemType String 否 standard

文件系统类型。

取值：

  • standard（默认值）：通用型NAS
  • extreme：极速型NAS
  • cpfs：文件存储CPFS

返回数据

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

请求ID。
Zones Array of Zone

可用区信息集合。
Zone
Performance Array of String nfs

接口预留参数，暂未生效，您无需关注。
Capacity Array of String nfs

接口预留参数，暂未生效，您无需关注。
ZoneId String cn-hangzhou-b

可用区ID。
InstanceTypes Array of InstanceType

实例类型信息集合。
InstanceType
StorageType String Capacity

存储类型。

  • 当FileSystemType=standard时，包括：Performance（性能型）、Capacity（容量型）。
  • 当FileSystemType=extreme时，包括：standard（标准型）、advance（高级型）。
  • 当FileSystemType=cpfs时，包括：advance_100（100 MB/s/TiB基线）、advance_200（200 MB/s/TiB基线）。
ProtocolType String NFS

文件传输协议类型。

  • 当FileSystemType=standard时，包括：NFS、SMB。
  • 当FileSystemType=extreme时，包括：NFS。
  • 当FileSystemType=cpfs时，包括：cpfs。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeZones
&RegionId=cn-hangzhou
&FileSystemType=standard
&公共请求参数

正常返回示例

XML格式 

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

<DescribeZonesResponse>
    <RequestId>A70BEE5D-76D3-49FB-B58F-1F398211****</RequestId>
    <ZoneId>cn-hangzhou-b</ZoneId>
    <Capacity>
    </Capacity>
    <InstanceTypes>
        <InstanceType>
            <StorageType>Performance</StorageType>
            <ProtocolType>nfs</ProtocolType>
        </InstanceType>
    </InstanceTypes>
    <Performance>
        <Protocol>nfs</Protocol>
    </Performance>
</DescribeZonesResponse>

JSON格式 

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

{
  "RequestId" : "A70BEE5D-76D3-49FB-B58F-1F398211****",
  "ZoneId" : "cn-hangzhou-b",
  "Capacity" : {
    "Protocol" : [ ]
  },
  "InstanceTypes" : {
    "InstanceType" : [ {
      "StorageType" : "Performance",
      "ProtocolType" : "nfs"
    } ]
  },
  "Performance" : {
    "Protocol" : [ "nfs" ]
  }
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidRegionId.NotFound The specified Region is not found. 请求的地域不存在或暂未提供服务。
500 InternalError The request processing has failed due to some unknown error. 由于未知错误造成请求失败，请稍后再试。

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