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 whose zones you want to query.

You can call the DescribeRegions operation to query the most recent region list.

FileSystemType String No standard

The type of the file system.

Default value: standard. Valid values:

  • standard: General-purpose NAS file system
  • extreme: Extreme NAS file system
  • cpfs: CPFS file system

Response parameters

Parameter Type Example Description
RequestId String A70BEE5D-76D3-49FB-B58F-1F398211****

The ID of the request.

Zones Array of Zone

The array of 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 array of instance 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).
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.

Examples

Sample requests

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

Sample responses

XML format 

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 format 

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

Error codes

HttpCode Error code Error message Description
404 InvalidRegionId.NotFound The specified Region is not found. The error message 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 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.