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
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.
Nilai default: true. |
| InstanceChargeType | String | No | PostPaid | Metode penagihan yang didukung di zona tersebut. Untuk informasi selengkapnya, lihat Billing overview. Nilai yang valid:
Nilai default: PostPaid. |
| SpotStrategy | String | No | NoSpot | Kebijakan bidding untuk instans pay-as-you-go. Anda dapat menentukan parameter ini ketika parameter
Nilai default: NoSpot. |
| AcceptLanguage | String | No | zh-CN | Bahasa alami yang digunakan untuk menyaring respons. Untuk informasi selengkapnya, lihat RFC 7231. Nilai yang valid:
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:
|
| 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:
|
| 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:
|
| 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:
|
| AvailableResourceCreation | Array of String | DedicatedHost | Jenis sumber daya yang dapat dibuat. Nilai yang valid:
|
| 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:
|
| 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.