You need to enable JavaScript to run this app.
文档中心
云数据库 MySQL 版

云数据库 MySQL 版

复制全文
下载 pdf
全局管理
DescribeAvailabilityZones - 查看可用区列表
复制全文
下载 pdf
DescribeAvailabilityZones - 查看可用区列表
调用 DescribeAvailabilityZones 接口查看可用区列表。​
请求类型​
同步请求。​
注意事项​
  • DescribeAvailabilityZones 接口按 Header 中的 Region 参数转发,只可查询 Header 中的 Region 参数指定地域的可用区信息,不会返回其他地域的信息。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
无。​
​
参数​
类型​
是否必选​
示例值​
描述​
SpecFamily​
String​
否​
General​
实例规格类型。取值:​
  • General,通用型规格。​
  • Shared:共享型规格。​
StorageType​
String​
否​
LocalSSD​
实例的存储类型。取值范围:​
  • LocalSSD:本地盘。​
  • CloudESSD_FlexPL:FlexPL 云盘。​
  • CloudESSD_PL0:PL0 云盘。​
说明​
  • 如需设定 StorageSpace 参数,StorageType 参数为必传。​
  • 当 InstanceType 取值为 SingleNode 时,StorageType 取值只能为 CloudESSD_FlexPL 或 CloudESSD_PL0。​
  • 在不同接口中,该参数取值范围不同。具体规则如下:​
  • 在以下接口中作为请求参数时,StorageType 的取值只能为 LocalSSD。​
  • RestoreToCrossRegionInstance​
  • RestoreToNewInstanceFromUserTos​
  • 在部分接口中作为请求参数时,该参数的取值范围与原实例的存储类型有关,具体规则如下:​
  • 原实例的存储类型为 LocalSSD 或 CloudESSD_FlexPL 时,不支持变更存储类型。​
  • 原实例的存储类型为 CloudESSD_PL0 时,可取值为 CloudESSD_PL0 或 CloudESSD_FlexPL。​
  • 涉及的接口是:​
  • RebuildDBInstance​
  • RestoreToNewInstance​
  • ModifyDBNodeSpec​
​
返回参数​
​
参数​
类型​
示例值​
描述​
RegionId​
String​
cn-beijing​
地域 ID​
Zones​
Array of Zone​
{​
"Description": "华北2(北京)-可用区A",​
"ZoneId": "cn-beijing-a",​
"ZoneName": "cn-beijing-a"​
}​
地域下的可用区列表。​
​
Zone​
​
参数​
类型​
示例值​
描述​
ZoneId​
String​
cn-beijing-a​
可用区的 ID。​
ZoneName​
String​
cn-beijing-a​
可用区的名称。​
Description​
String​
华北1(北京)-可用 A​
可用区的描述信息。​
status​
String​
Normal​
可用区状态。取值如下:​
  • Normal :可用。​
  • Disable :不可用。​
说明​
该字段仅当请求参数中传入 SpecFamily 或 StorageType 时才返回,否则不返回。​
​
示例​
请求示例​
​
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****​
​
返回示例​
​
{​
"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"​
}​
]​
}​
}​
​
错误码​
更多详情,请参见错误码。​
​
最近更新时间:2026.06.10 10:58:15
这个页面对您有帮助吗?
有用
有用
无用
无用