DescribeZones - Elastic Compute Service

根據地域ID、計費方式等參數查詢可用區資訊列表。

介面說明

DescribeZones 僅查詢阿里雲提供的可用區列表並返回少量庫存資訊。如果您需要查詢具體可用區下可購買的執行個體規格和雲端硬碟規格，推薦您使用 DescribeAvailableResource 。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	是	可用區所在的地域 ID。您可以呼叫 DescribeRegions 查看最新的阿里雲地域列表。	cn-hangzhou
Verbose	boolean	否	是否展示詳細資訊。 true：展示。 false：不展示。預設值：true。	false
InstanceChargeType	string	否	可用區裡支援的資源計費方式。更多資訊，請參見計費概述。取值範圍： PrePaid：包年包月。 PostPaid：按量付費。預設值：PostPaid。	PostPaid
SpotStrategy	string	否	按量付費執行個體的競價策略。當`InstanceChargeType=PostPaid`時，您可以傳入該參數。更多資訊，請參見搶佔式執行個體。取值範圍： NoSpot：正常按量付費執行個體。 SpotWithPriceLimit：設定上限價格的搶佔式執行個體。 SpotAsPriceGo：系統自動出價，最高按量付費價格。預設值：NoSpot。	NoSpot
AcceptLanguage	string	否	根據漢語、英語和日語篩選返回結果。更多資訊，請參見RFC 7231。取值範圍： zh-CN：簡體中文。 zh-TW：繁體中文。 en-US：英文。 ja：日文。 fr：法語。 de：德語。 ko：韓語。預設值：zh-CN。枚舉值： de : 德語。 en-US : 英文。 ko : 韓語。 zh-TW : 繁體中文。 ja : 日文。 fr : 法語。 zh-CN : 簡體中文。	zh-CN

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Zones	object
Zone	array<object>	可用區及可用區下支援的資源資訊集合。
	array<object>
ZoneId	string	可用性區域 ID。	cn-hangzhou-g
ZoneType	string	可用性區域類型。可能值： AvailabilityZone：公用雲可用性區域。	AvailabilityZone
LocalName	string	可用性區域本地語言名。	华东 1 可用区 G
AvailableResources	object
ResourcesInfo	array<object>	可供建立的具體資源群組成的數組。
	array<object>
IoOptimized	boolean	是否為 I/O 最佳化執行個體。	true
SystemDiskCategories	object
supportedSystemDiskCategory	array	系統硬碟類型列表。
	string	允許建立的系統硬碟類型。可能值： cloud：普通雲端硬碟。 cloud_efficiency：高效雲端硬碟。 cloud_ssd：SSD 雲端硬碟。 cloud_essd：ESSD 雲端硬碟。	cloud_essd
InstanceGenerations	object
supportedInstanceGeneration	array	支援的執行個體規格類型系列代數列表。
	string	執行個體規格類型系列代數。	ecs-6
DataDiskCategories	object
supportedDataDiskCategory	array	允許建立的資料盤類型。
	string	資料盤類型。可能值： cloud：普通雲端硬碟。 cloud_efficiency：高效雲端硬碟。 cloud_ssd：SSD 雲端硬碟。 cloud_essd：ESSD 雲端硬碟。 ephemeral_ssd：本地 SSD 盤。	cloud_essd
InstanceTypes	object
supportedInstanceType	array	執行個體規格列表。
	string	當前可用性區域、網路類型（NetworkTypes）、I/O 最佳化執行個體（IoOptimized）下允許建立的執行個體規格列表。	ecs.g5.large
InstanceTypeFamilies	object
supportedInstanceTypeFamily	array	允許建立的執行個體規格類型系列列表。
	string	執行個體規格類型系列。	ecs.r7t
NetworkTypes	object
supportedNetworkCategory	array	支援的網路類型列表。
	string	支援的網路類型。可能值： VPC：Virtual Private Cloud。 Classic：傳統網路。	vpc
AvailableResourceCreation	object
ResourceTypes	array	允許建立的資源類型列表。
	string	允許建立的資源類型。可能值： VSwitch：交換器。 IoOptimized：I/O 最佳化執行個體。 Instance：執行個體。 DedicatedHost：Dedicated Host。 Disk：雲端硬碟。	DedicatedHost
DedicatedHostGenerations	object
DedicatedHostGeneration	array	支援的 Dedicated Host 代數列表。
	string	支援的 Dedicated Host 代數。	ddh-6
AvailableInstanceTypes	object
InstanceTypes	array	當前可用性區域下可建立的所有規格列表。
	string	當前可用性區域下可建立的規格。	ecs.g6.xlarge
AvailableDiskCategories	object
DiskCategories	array	允許建立的雲端硬碟種類集合。
	string	允許建立的雲端硬碟種類。可能值： cloud：普通雲端硬碟。 cloud_ssd：SSD 雲端硬碟。 cloud_efficiency：高效雲端硬碟。 cloud_essd：ESSD 雲端硬碟。	cloud
AvailableDedicatedHostTypes	object
DedicatedHostType	array	支援的 Dedicated Host 規格列表。
	string	支援的 Dedicated Host 規格。	ddh.g6
AvailableVolumeCategories	object
VolumeCategories	array	支援的共用儲存類型列表。
	string	支援的共用儲存類型。	san_efficiency

樣本

正常返回樣本

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Zones": {
    "Zone": [
      {
        "ZoneId": "cn-hangzhou-g",
        "ZoneType": "AvailabilityZone",
        "LocalName": "华东 1 可用区 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.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.
404	InvalidRegion.NotFound	The specified parameter RegionId is not valid.
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.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。