DescribeZones - - 阿里雲

Queries all zones in a region and the file system types that are supported in each zone.

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	DescribeZones	The operation that you want to perform. Set the value to DescribeZones.
RegionId	String	Yes	cn-hangzhou	The ID of the region where you want to query zones. You can call the DescribeRegions operation to query the latest region list.
FileSystemType	String	No	standard	The type of the file system. Valid values: standard (default value): General-purpose NAS file system extreme: Extreme NAS file system cpfs: Cloud Parallel File Storage (CPFS) file system Note CPFS file systems are available only on the China site (aliyun.com).

Response parameters


Parameter	Type	Example	Description
RequestId	String	A70BEE5D-76D3-49FB-B58F-1F398211****	The ID of the request.
Zones	Array of Zone		The details about zones.
Zone
Performance	Array of String	nfs	This parameter is reserved. You can ignore this parameter.
Capacity	Array of String	nfs	This parameter is reserved. You can ignore this parameter.
ZoneId	String	cn-hangzhou-b	The ID of the zone.
InstanceTypes	Array of InstanceType		The details about file system types.
InstanceType
StorageType	String	Capacity	The storage type. If the FileSystemType parameter is set to standard, the storage type is Performance or Capacity. If the FileSystemType parameter is set to extreme, the storage type is standard or advance. If the FileSystemType parameter is set to cpfs, the storage type is advance_100 (100 MB/s/TiB baseline) or advance_200 (200 MB/s/TiB baseline). Note CPFS file systems are available only on the China site (aliyun.com).
ProtocolType	String	nfs	The protocol type. If the FileSystemType parameter is set to standard, the protocol type is nfs or smb. If the FileSystemType parameter is set to extreme, the protocol type is nfs. If the FileSystemType parameter is set to cpfs, the protocol type is cpfs. Note CPFS file systems are available only on the China site (aliyun.com).

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeZones
&RegionId=cn-hangzhou
&FileSystemType=standard
&<Common request parameters>

Sample success responses

XML format

JSON format

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

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

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

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

Error codes


HttpCode	Error code	Error message	Description
404	InvalidRegionId.NotFound	The specified Region is not found.	The error message is returned because the requested region does not exist or the query service is unavailable in this region.
500	InternalError	The request processing has failed due to some unknown error.	The error message is returned because the request has failed due to an unknown error. Try again later.

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