根據(jù)地域ID、計費方式等參數(shù)查詢可用區(qū)信息列表。
接口說明
DescribeZones 僅查詢阿里云提供的可用區(qū)列表并返回少量庫存信息。如果您需要查詢具體可用區(qū)下可購買的實例規(guī)格和云盤規(guī)格，推薦您使用 DescribeAvailableResource 。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
當(dāng)前API暫無授權(quán)信息透出。
請求參數(shù)
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 可用區(qū)所在的地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
| Verbose | boolean | 否 | 是否展示詳細(xì)信息。
默認(rèn)值：true。 | false |
| InstanceChargeType | string | 否 | PostPaid | |
| SpotStrategy | string | 否 | 按量付費實例的競價策略。當(dāng)
默認(rèn)值：NoSpot | NoSpot |
| AcceptLanguage | string | 否 | zh-CN |
返回參數(shù)
示例
正常返回示例
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"Zones": {
"Zone": [
{
"ZoneId": "cn-hangzhou-g",
"ZoneType": "AvailabilityZone",
"LocalName": "華東 1 可用區(qū) G",
"AvailableResources": {
"ResourcesInfo": [
{
"IoOptimized": true,
"SystemDiskCategories": {
"supportedSystemDiskCategory": [
"cloud_essd"
]
},
"InstanceGenerations": {
"supportedInstanceGeneration": [
"ecs-6"
]
},
"DataDiskCategories": {
"supportedDataDiskCategory": [
"cloud_essd"
]
},
"InstanceTypes": {
"supportedInstanceType": [
"ecs.g5.large"
]
},
"InstanceTypeFamilies": {
"supportedInstanceTypeFamily": [
"ecs.r7t"
]
},
"NetworkTypes": {
"supportedNetworkCategory": [
"vpc"
]
}
}
]
},
"AvailableResourceCreation": {
"ResourceTypes": [
"DedicatedHost"
]
},
"DedicatedHostGenerations": {
"DedicatedHostGeneration": [
"ddh-6"
]
},
"AvailableInstanceTypes": {
"InstanceTypes": [
"ecs.g6.xlarge"
]
},
"AvailableDiskCategories": {
"DiskCategories": [
"cloud"
]
},
"AvailableDedicatedHostTypes": {
"DedicatedHostType": [
"ddh.g6"
]
},
"AvailableVolumeCategories": {
"VolumeCategories": [
"san_efficiency"
]
}
}
]
}
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | InvalidSpotStrategy | The specified SpotStrategy is not valid. | 指定的 SpotStrategy 參數(shù)無效。 |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定的地域 ID 不存在。 |
| 404 | InvalidRegion.NotFound | The specified parameter RegionId is not valid. | RegionId 參數(shù)不合法。 |
| 404 | InvalidInstanceChargeType.NotFound | The InstanceChargeType does not exist in our records | - |
| 404 | InvalidAcceptLanguage.NotFound | Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed. | 您選擇的語言類型無效，現(xiàn)在只支持中文、英語和日語。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內(nèi)容概要 | 操作 |
|---|
暫無變更歷史