You need to enable JavaScript to run this app.
RDS for MySQL

RDS for MySQL

Copy page
Download PDF
Global management
DescribeAvailabilityZones
Copy page
Download PDF
DescribeAvailabilityZones
Call the DescribeAvailabilityZones API to view the list of availability zones.​
Request type​
Synchronous request.​
Precautions​
  • The DescribeAvailabilityZones API forwards requests based on the Region parameter in the header. It only queries availability zone information for the region specified in the header and will not return information for other regions.​
Debug​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
None.​
​
Parameter​
Type​
Is it required?​
Sample value​
Description​
SpecFamily​
String​
No​
General​
Instance specification type. Values:​
  • General, a general-type specification.​
  • Shared: a shared-type specification.​
StorageType​
String​
No​
LocalSSD​
The storage type of the instance. Range:​
  • LocalSSD: local SSD.​
  • CloudESSD_FlexPL: Cloud ESSD FlexPL.​
  • CloudESSD_PL0: Cloud ESSD PL0.​
tip​
  • The StorageType parameter is required if you set the StorageSpace parameter.​
  • When the InstanceType is set to SingleNode, the StorageType can only be CloudESSD_FlexPL or CloudESSD_PL0.​
  • This parameter has different value ranges for different APIs. The rules are as follows:​
  • When used as a request parameter in the following APIs, StorageType can only be LocalSSD.​
  • RestoreToCrossRegionInstance​
  • RestoreToNewInstanceFromUserTos​
  • When used as a request parameter for some API operations, the value range of this parameter is related to the storage type of the original instance. The specific rules are as follows:​
  • If the original instance storage type is LocalSSD or CloudESSD_FlexPL, changing the storage type is not supported.​
  • If the original instance storage type is CloudESSD_PL0, the value can be CloudESSD_PL0 or CloudESSD_FlexPL.​
  • The related APIs are:​
  • RebuildDBInstance​
  • RestoreToNewInstance​
  • ModifyDBNodeSpec​
​
Response parameters​
​
Parameter​
Type​
Sample value​
Description​
RegionId​
String​
cn-beijing​
Region ID​
Zones​
Array of Zone​
{​
"Description": "North China 2 (Beijing) - availability zone A",​
"ZoneId": "cn-beijing-a",​
"ZoneName": "cn-beijing-a"​
}​
Availability zone list.​
​
Zone​
​
Parameter​
Type​
Sample value​
Description​
ZoneId​
String​
cn-beijing-a​
The ID of the availability zone.​
ZoneName​
String​
cn-beijing-a​
The Name of the availability zone.​
Description​
String​
North China 1 (Beijing) - Availability zone A​
Description of the availability zone.​
status​
String​
Normal​
Availability zone state. Values are as follows:​
  • Normal: available.​
  • Disable: Unavailable.​
tip​
This field is returned only when SpecFamily or StorageType is passed in the request parameters; otherwise, it is not returned.​
​
Sample​
Sample request​
​
POST /?Action=DescribeAvailabilityZones&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host: rds-mysql.cn-beijing.volcengineapi.com​
X-Date: 20211202T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****​
​
Sample response​
​
{​
"ResponseMetadata": {​
"RequestId": "202301092220460BDD841A0E0BF2B51B42",​
"Action": "DescribeAvailabilityZones",​
"Version": "2022-01-01",​
"Service": "rds_mysql",​
"Region": "cn-beijing"​
},​
"Result": {​
"RegionId": "cn-beijing",​
"Zones": [​
{​
"Description": "华北2(北京)-可用区A",​
"ZoneId": "cn-beijing-a",​
"ZoneName": "cn-beijing-a"​
},​
{​
"Description": "华北2(北京)-可用区B",​
"ZoneId": "cn-beijing-b",​
"ZoneName": "cn-beijing-b"​
}​
]​
}​
}​
​
Error code​
For more details, refer to Error codes.​
Last updated: 2026.06.12 17:17:49