DescribeZones - Apsara File Storage NAS - Alibaba Cloud Documentation Center

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.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The ID of the region where you want to query zones. You can call the DescribeRegions operation to query the latest region list.	cn-hangzhou
FileSystemType	string	No	The type of the file system. Valid values: standard (default): 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).	standard

Response parameters

Parameter	Type	Description	Example
	object
RequestId	string	The request ID.	A70BEE5D-76D3-49FB-B58F-1F398211****
Zones	object []	The queried zones.
Performance	array	This parameter is reserved. You can ignore this parameter.
	string	This parameter is reserved. You can ignore this parameter.	nfs
Capacity	array	This parameter is reserved. You can ignore this parameter.
	string	This parameter is reserved. You can ignore this parameter.	nfs
ZoneId	string	The zone ID.	cn-hangzhou-b
InstanceTypes	object []	The details about file system types.
StorageType	string	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).	Capacity
ProtocolType	string	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).	nfs

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status code	Error code	Error message	Description
404	InvalidRegionId.NotFound	The specified Region is not found.	The requested region does not exist or the service is not yet available.
500	InternalError	The request processing has failed due to some unknown error.	The request failed due to an unknown error. Please try again later.

For a list of error codes, visit the Service error codes.