DescribeZones - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengkueri daftar zona aktif berdasarkan parameter seperti ID wilayah dan metode penagihan.

Deskripsi operasi

DescribeZones hanya mengkueri daftar zona yang disediakan oleh Alibaba Cloud dan mengembalikan informasi inventaris terbatas. Untuk mengkueri tipe instans dan kategori disk yang tersedia untuk dibeli di zona tertentu, gunakan DescribeAvailableResource.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah tempat zona berada. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
Verbose	boolean	No	Apakah akan menampilkan informasi detail. true: Menampilkan informasi detail. false: Tidak menampilkan informasi detail. Nilai default: true.	false
InstanceChargeType	string	No	Metode penagihan yang didukung oleh sumber daya di zona aktif. Untuk informasi lebih lanjut, lihat Billing overview. Nilai valid: PrePaid: langganan. PostPaid: pay-as-you-go. Nilai default: PostPaid.	PostPaid
SpotStrategy	string	No	Kebijakan penawaran untuk instans pay-as-you-go. Anda dapat menentukan parameter ini saat `InstanceChargeType=PostPaid`. Untuk informasi lebih lanjut, lihat Spot instances. Nilai valid: NoSpot: instans pay-as-you-go reguler. SpotWithPriceLimit: spot instans dengan batas harga maksimum. SpotAsPriceGo: spot instans dengan harga pasar dan harga pay-as-you-go sebagai batas atas. Nilai default: NoSpot.	NoSpot
AcceptLanguage	string	No	Bahasa alami yang digunakan untuk memfilter hasil tanggapan. Untuk informasi lebih lanjut, lihat RFC 7231. Nilai valid: zh-CN: bahasa Tionghoa sederhana. zh-TW: bahasa Tionghoa tradisional. en-US: bahasa Inggris. ja: bahasa Jepang. fr: bahasa Prancis. de: bahasa Jerman. ko: bahasa Korea. Nilai default: zh-CN. Valid values: de : Bahasa Jerman. en-US : Bahasa Inggris. ko : Bahasa Korea. zh-TW : Bahasa Tionghoa tradisional. ja : Bahasa Jepang. fr : Bahasa Prancis. zh-CN : Bahasa Tionghoa sederhana.	zh-CN

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Zones	object
Zone	array<object>	Kumpulan zona dan informasi sumber daya yang didukung di setiap zona.
	array<object>
ZoneId	string	ID zona.	cn-hangzhou-g
ZoneType	string	Tipe zona. Nilai yang valid: AvailabilityZone: zona cloud publik.	AvailabilityZone
LocalName	string	Nama zona dalam bahasa lokal.	华东 1 可用区 G
AvailableResources	object
ResourcesInfo	array<object>	Array yang terdiri dari resource spesifik yang tersedia untuk pembuatan.
	array<object>
IoOptimized	boolean	Menunjukkan apakah instance dioptimalkan I/O.	true
SystemDiskCategories	object
supportedSystemDiskCategory	array	Daftar kategori system disk.
	string	Kategori system disk yang dapat dibuat. Nilai yang valid: cloud: disk dasar. cloud_efficiency: ultra disk. cloud_ssd: SSD standar. cloud_essd: ESSD.	cloud_essd
InstanceGenerations	object
supportedInstanceGeneration	array	Daftar generasi instance yang didukung.
	string	Generasi instance.	ecs-6
DataDiskCategories	object
supportedDataDiskCategory	array	Kategori data disk yang dapat dibuat.
	string	Kategori data disk. Nilai yang valid: cloud: disk dasar. cloud_efficiency: ultra disk. cloud_ssd: SSD standar. cloud_essd: ESSD. ephemeral_ssd: SSD lokal.	cloud_essd
InstanceTypes	object
supportedInstanceType	array	Daftar tipe instance.
	string	Daftar tipe instance yang dapat dibuat pada zona saat ini, tipe jaringan (NetworkTypes), dan konfigurasi I/O optimized (IoOptimized).	ecs.g5.large
InstanceTypeFamilies	object
supportedInstanceTypeFamily	array	Daftar keluarga instance yang dapat dibuat.
	string	Keluarga instance.	ecs.r7t
NetworkTypes	object
supportedNetworkCategory	array	Daftar tipe jaringan yang didukung.
	string	Tipe jaringan yang didukung. Nilai yang valid: VPC: virtual private cloud (VPC). Classic: jaringan classic.	vpc
AvailableResourceCreation	object
ResourceTypes	array	Daftar tipe resource yang dapat dibuat.
	string	Tipe resource yang dapat dibuat. Nilai yang valid: VSwitch: vSwitch. IoOptimized: instance I/O optimized. Instance: instance. DedicatedHost: dedicated host. Disk: disk.	DedicatedHost
DedicatedHostGenerations	object
DedicatedHostGeneration	array	Daftar generasi dedicated host yang didukung.
	string	Generasi dedicated host yang didukung.	ddh-6
AvailableInstanceTypes	object
InstanceTypes	array	Daftar semua tipe instance yang dapat dibuat pada zona saat ini.
	string	Tipe instance yang dapat dibuat pada zona saat ini.	ecs.g6.xlarge
AvailableDiskCategories	object
DiskCategories	array	Kumpulan kategori disk yang dapat dibuat.
	string	Kategori disk yang dapat dibuat. Nilai yang valid: cloud: disk dasar. cloud_ssd: SSD standar. cloud_efficiency: ultra disk. cloud_essd: ESSD.	cloud
AvailableDedicatedHostTypes	object
DedicatedHostType	array	Daftar tipe dedicated host yang didukung.
	string	Tipe dedicated host yang didukung.	ddh.g6
AvailableVolumeCategories	object
VolumeCategories	array	Daftar tipe shared storage yang didukung.
	string	Tipe shared storage yang didukung.	san_efficiency

Contoh

Respons sukses

JSONformat

{
  "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"
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message
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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.