All Products
Search
Document Center

:DescribeZones

Last Updated:May 22, 2026

Melakukan kueri terhadap zona dalam suatu wilayah.

Catatan Penggunaan

Saat memanggil operasi ini, hanya daftar zona dan beberapa informasi sumber daya di masing-masing zona yang dikembalikan. Jika Anda ingin mengetahui tipe instans dan kategori disk yang tersedia untuk pembelian di zona tertentu, disarankan untuk memanggil operasi DescribeAvailableResource.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter Permintaan

Parameter

Type

Required

Example

Description

Action String Yes DescribeZones

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeZones.

RegionId String Yes cn-hangzhou

ID wilayah tempat Anda melakukan kueri zona. Anda dapat memanggil operasi DescribeRegions untuk mendapatkan daftar wilayah terbaru.

Verbose Boolean No false

Menentukan apakah informasi detail ditampilkan atau tidak.

  • true
  • false

Nilai default: true.

InstanceChargeType String No PostPaid

Metode penagihan yang didukung di zona tersebut. Untuk informasi selengkapnya, lihat Billing overview. Nilai yang valid:

  • PrePaid: subscription
  • PostPaid: pay-as-you-go

Nilai default: PostPaid.

SpotStrategy String No NoSpot

Kebijakan bidding untuk instans pay-as-you-go. Anda dapat menentukan parameter ini ketika parameter InstanceChargeType diatur ke PostPaid. Untuk informasi selengkapnya, lihat Preemptible instances. Nilai yang valid:

  • NoSpot: Instans merupakan instans pay-as-you-go reguler.
  • SpotWithPriceLimit: Instans merupakan instans preemptible dengan harga maksimum per jam yang ditentukan pengguna.
  • SpotAsPriceGo: Instans merupakan instans preemptible yang menggunakan harga pasar sebagai harga bidding secara otomatis. Harga pasar dapat mencapai harga pay-as-you-go.

Nilai default: NoSpot.

AcceptLanguage String No zh-CN

Bahasa alami yang digunakan untuk menyaring respons. Untuk informasi selengkapnya, lihat RFC 7231. Nilai yang valid:

  • zh-CN: Chinese
  • en-US: English
  • ja: Japanese

Nilai default: zh-CN.

Parameter Respons

Parameter

Type

Example

Description

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID permintaan.

Zones Array of Zone

Detail tentang zona dan sumber daya yang didukungnya.

Zone
ZoneId String cn-hangzhou-g

ID zona.

ZoneType String AvailabilityZone

Jenis zona. Nilai yang valid:

  • AvailabilityZone: Alibaba Cloud public cloud zone
LocalName String Hangzhou Zone G

Nama zona dalam bahasa lokal.

AvailableResources Array of ResourcesInfo

Detail tentang sumber daya yang dapat dibuat di zona tersebut.

ResourcesInfo
IoOptimized Boolean true

Menunjukkan apakah instans I/O teroptimasi didukung di zona tersebut.

SystemDiskCategories Array of String cloud_essd

Kategori disk sistem yang dapat dibuat. Nilai yang valid:

  • cloud: disk dasar
  • cloud_efficiency: disk ultra
  • cloud_ssd: SSD standar
  • cloud_essd: enhanced SSD (ESSD)
InstanceGenerations Array of String ecs-6

Generasi keluarga instans yang didukung.

DataDiskCategories Array of String cloud_essd

Kategori disk data yang dapat dibuat. Nilai yang valid:

  • cloud: disk dasar
  • cloud_efficiency: disk ultra
  • cloud_ssd: SSD standar
  • cloud_essd: ESSD
  • ephemeral_ssd: SSD lokal
InstanceTypes Array of String ecs.g5.large

Tipe instans dari instans I/O teroptimasi dengan jenis jaringan berbeda yang dapat dibuat di zona tersebut.

InstanceTypeFamilies Array of String ecs.r7t

Keluarga instans yang didukung.

NetworkTypes Array of String vpc

Jenis jaringan yang didukung. Nilai yang valid:

  • VPC: Virtual Private Cloud (VPC)
  • Classic: classic network
AvailableResourceCreation Array of String DedicatedHost

Jenis sumber daya yang dapat dibuat. Nilai yang valid:

  • VSwitch: vSwitch
  • IoOptimized: I/O optimized instance
  • Instance: instance
  • DedicatedHost: dedicated host
  • disk: cloud disk
DedicatedHostGenerations Array of String ddh-6

Generasi host khusus yang didukung.

AvailableInstanceTypes Array of String ecs.g6.xlarge

Tipe instans yang didukung.

AvailableDiskCategories Array of String cloud

Kategori disk yang dapat dibuat. Nilai yang valid:

  • cloud: disk dasar
  • cloud_ssd: SSD standar
  • cloud_efficiency: disk ultra
  • cloud_essd: ESSD
AvailableDedicatedHostTypes Array of String ddh.g6

Tipe host khusus yang didukung.

AvailableVolumeCategories Array of String san_efficiency

Kategori perangkat Penyimpanan Blok Bersama yang didukung.

Contoh

Contoh permintaan

https://ecs.aliyuncs.com/?Action=DescribeZones
&RegionId=cn-hangzhou
&InstanceChargeType=PostPaid
&SpotStrategy=NoSpot
&<Common request parameters>

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeZonesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <Zones>
        <Zone>
            <DedicatedHostGenerations>
                <DedicatedHostGeneration>ddh-5</DedicatedHostGeneration>
                <DedicatedHostGeneration>ddh-6</DedicatedHostGeneration>
            </DedicatedHostGenerations>
            <AvailableInstanceTypes>
                <InstanceTypes>ecs.g6.xlarge</InstanceTypes>
                <InstanceTypes>ecs.g7t.4xlarge</InstanceTypes>
            </AvailableInstanceTypes>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <AvailableDedicatedHostTypes>
                <DedicatedHostType>ddh.g6</DedicatedHostType>
                <DedicatedHostType>ddh.r6</DedicatedHostType>
            </AvailableDedicatedHostTypes>
            <AvailableResources>
                <ResourcesInfo>
                    <InstanceGenerations>
                        <supportedInstanceGeneration>ecs-5</supportedInstanceGeneration>
                        <supportedInstanceGeneration>ecs-6</supportedInstanceGeneration>
                    </InstanceGenerations>
                    <NetworkTypes>
                        <supportedNetworkCategory>vpc</supportedNetworkCategory>
                    </NetworkTypes>
                    <IoOptimized>true</IoOptimized>
                    <SystemDiskCategories>
                        <supportedSystemDiskCategory>cloud_efficiency</supportedSystemDiskCategory>
                        <supportedSystemDiskCategory>cloud_essd</supportedSystemDiskCategory>
                    </SystemDiskCategories>
                    <InstanceTypes>
                        <supportedInstanceType>ecs.c6.xlarge</supportedInstanceType>
                        <supportedInstanceType>ecs.g5.large</supportedInstanceType>
                    </InstanceTypes>
                    <InstanceTypeFamilies>
                        <supportedInstanceTypeFamily>ecs.r7t</supportedInstanceTypeFamily>
                        <supportedInstanceTypeFamily>ecs.r7</supportedInstanceTypeFamily>
                    </InstanceTypeFamilies>
                    <DataDiskCategories>
                        <supportedDataDiskCategory>cloud_efficiency</supportedDataDiskCategory>
                        <supportedDataDiskCategory>cloud_essd</supportedDataDiskCategory>
                    </DataDiskCategories>
                </ResourcesInfo>
            </AvailableResources>
            <AvailableDiskCategories>
                <DiskCategories>cloud_efficiency</DiskCategories>
                <DiskCategories>cloud_essd</DiskCategories>
            </AvailableDiskCategories>
            <ZoneType>AvailabilityZone</ZoneType>
            <LocalName>Hangzhou Zone G</LocalName>
            <AvailableResourceCreation>
                <ResourceTypes>VSwitch</ResourceTypes>
                <ResourceTypes>IoOptimized</ResourceTypes>
                <ResourceTypes>Instance</ResourceTypes>
                <ResourceTypes>DedicatedHost</ResourceTypes>
                <ResourceTypes>Disk</ResourceTypes>
            </AvailableResourceCreation>
            <AvailableVolumeCategories>
                <VolumeCategories>san_efficiency</VolumeCategories>
            </AvailableVolumeCategories>
        </Zone>
    </Zones>
</DescribeZonesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Zones" : {
    "Zone" : [ {
      "DedicatedHostGenerations" : {
        "DedicatedHostGeneration" : [ "ddh-5", "ddh-6" ]
      },
      "AvailableInstanceTypes" : {
        "InstanceTypes" : [ "ecs.g6.xlarge", "ecs.g7t.4xlarge" ]
      },
      "ZoneId" : "cn-hangzhou-g",
      "AvailableDedicatedHostTypes" : {
        "DedicatedHostType" : [ "ddh.g6", "ddh.r6" ]
      },
      "AvailableResources" : {
        "ResourcesInfo" : [ {
          "InstanceGenerations" : {
            "supportedInstanceGeneration" : [ "ecs-5", "ecs-6" ]
          },
          "NetworkTypes" : {
            "supportedNetworkCategory" : [ "vpc" ]
          },
          "IoOptimized" : true,
          "SystemDiskCategories" : {
            "supportedSystemDiskCategory" : [ "cloud_efficiency", "cloud_essd" ]
          },
          "InstanceTypes" : {
            "supportedInstanceType" : [ "ecs.c6.xlarge", "ecs.g5.large" ]
          },
          "InstanceTypeFamilies" : {
            "supportedInstanceTypeFamily" : [ "ecs.r7t", "ecs.r7" ]
          },
          "DataDiskCategories" : {
            "supportedDataDiskCategory" : [ "cloud_efficiency", "cloud_essd" ]
          }
        } ]
      },
      "AvailableDiskCategories" : {
        "DiskCategories" : [ "cloud_efficiency", "cloud_essd" ]
      },
      "ZoneType" : "AvailabilityZone",
      "LocalName" : "Hangzhou Zone G",
      "AvailableResourceCreation" : {
        "ResourceTypes" : [ "VSwitch", "IoOptimized", "Instance", "DedicatedHost", "Disk" ]
      },
      "AvailableVolumeCategories" : {
        "VolumeCategories" : [ "san_efficiency" ]
      }
    } ]
  }
}

Kode Kesalahan

Kode status HTTP

Kode kesalahan

Pesan kesalahan

Deskripsi

400 InvalidSpotStrategy The specified SpotStrategy is not valid. Nilai SpotStrategy tidak valid.
404 InvalidRegionId.NotFound The specified RegionId does not exist. RegionId tidak ditemukan.
404 InvalidRegion.NotFound The specified parameter RegionId is not valid. Nilai RegionId tidak valid.
404 InvalidInstanceChargeType.NotFound The InstanceChargeType does not exist in our records Metode penagihan instans tidak ditemukan.
404 InvalidAcceptLanguage.NotFound Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed. Nilai AcceptLanguage tidak valid. Nilai yang valid adalah zh-CN, en-US, dan ja.

Untuk daftar kode kesalahan, lihat Service error codes.