文档中心

云数据库 MySQL 版

请输入

全局管理

DescribeAvailabilityZones - 查看可用区列表

调用 DescribeAvailabilityZones 接口查看可用区列表。

请求类型

同步请求。

注意事项

DescribeAvailabilityZones 接口按 Header 中的 Region 参数转发，只可查询 Header 中的 Region 参数指定地域的可用区信息，不会返回其他地域的信息。

可通过 DescribeRegions 接口查询地域（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

这个页面对您有帮助吗？

有用

无用