Consulta a lista de zonas com base em parâmetros como o ID da região e o método de cobrança.
Descrição da operação
DescribeZones consulta apenas a lista de zonas fornecidas pela Alibaba Cloud e retorna informações limitadas de inventário. Para consultar os tipos de instância e as categorias de disco disponíveis em uma zona específica, use DescribeAvailableResource.
Experimente agora
Testar
Autorização RAM
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| RegionId |
string |
Sim |
O ID da região da zona. Você pode chamar a operação DescribeRegions para consultar a lista mais recente de regiões da Alibaba Cloud. |
cn-hangzhou |
| Verbose |
boolean |
Não |
Especifica se devem ser exibidas informações detalhadas. Valores válidos:
Valor padrão: true. |
false |
| InstanceChargeType |
string |
Não |
O método de cobrança dos recursos suportados na zona. Para mais informações, consulte Visão geral da cobrança. Valores válidos:
Valor padrão: PostPaid. |
PostPaid |
| SpotStrategy |
string |
Não |
A política de lance para instâncias pay-as-you-go. Você pode especificar este parâmetro quando InstanceChargeType estiver definido como PostPaid. Para mais informações, consulte Instâncias spot. Valores válidos:
Valor padrão: NoSpot. |
NoSpot |
| AcceptLanguage |
string |
Não |
O idioma usado para filtrar os resultados retornados, como chinês, inglês ou japonês. Para mais informações, consulte RFC 7231. Valores válidos:
Valor padrão: zh-CN. Valores válidos:
|
zh-CN |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
|||
| RequestId |
string |
O ID da solicitação. |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
| Zones |
object |
||
| Zone |
array<object> |
A coleção de zonas e as informações de recursos suportados em cada zona. |
|
|
array<object> |
|||
| ZoneId |
string |
O ID da zona. |
cn-hangzhou-g |
| ZoneType |
string |
O tipo de zona. Valores válidos:
|
AvailabilityZone |
| LocalName |
string |
O nome local da zona. |
China East 1 Zone G |
| AvailableResources |
object |
||
| ResourcesInfo |
array<object> |
A matriz de recursos específicos disponíveis para criação. |
|
|
array<object> |
|||
| IoOptimized |
boolean |
Indica se a instância é otimizada para I/O. |
true |
| SystemDiskCategories |
object |
||
| supportedSystemDiskCategory |
array |
A lista de categorias de disco do sistema suportadas. |
|
|
string |
As categorias de disco do sistema permitidas. Valores válidos:
|
cloud_essd |
|
| InstanceGenerations |
object |
||
| supportedInstanceGeneration |
array |
A lista de gerações de famílias de instâncias suportadas. |
|
|
string |
A geração da família de instâncias. |
ecs-6 |
|
| DataDiskCategories |
object |
||
| supportedDataDiskCategory |
array |
As categorias de disco de dados permitidas. |
|
|
string |
A categoria de disco de dados. Valores válidos:
|
cloud_essd |
|
| InstanceTypes |
object |
||
| supportedInstanceType |
array |
A lista de tipos de instância suportados. |
|
|
string |
A lista de tipos de instância que podem ser criados na zona atual, tipo de rede (NetworkTypes) e otimização de I/O (IoOptimized). |
ecs.g5.large |
|
| InstanceTypeFamilies |
object |
||
| supportedInstanceTypeFamily |
array |
A lista de famílias de instâncias permitidas. |
|
|
string |
A família de instâncias. |
ecs.r7t |
|
| NetworkTypes |
object |
||
| supportedNetworkCategory |
array |
A lista de tipos de rede suportados. |
|
|
string |
O tipo de rede suportado. Valores válidos:
|
vpc |
|
| AvailableResourceCreation |
object |
||
| ResourceTypes |
array |
A lista de tipos de recursos permitidos. |
|
|
string |
O tipo de recurso permitido. Valores válidos:
|
DedicatedHost |
|
| DedicatedHostGenerations |
object |
||
| DedicatedHostGeneration |
array |
A lista de gerações de hosts dedicados suportadas. |
|
|
string |
A geração de host dedicado suportada. |
ddh-6 |
|
| AvailableInstanceTypes |
object |
||
| InstanceTypes |
array |
A lista de todos os tipos de instância que podem ser criados na zona atual. |
|
|
string |
O tipo de instância que pode ser criado na zona atual. |
ecs.g6.xlarge |
|
| AvailableDiskCategories |
object |
||
| DiskCategories |
array |
A coleção de categorias de disco permitidas. |
|
|
string |
A categoria de disco permitida. Valores válidos:
|
cloud |
|
| AvailableDedicatedHostTypes |
object |
||
| DedicatedHostType |
array |
A lista de tipos de host dedicado suportados. |
|
|
string |
O tipo de host dedicado suportado. |
ddh.g6 |
|
| AvailableVolumeCategories |
object |
||
| VolumeCategories |
array |
A lista de tipos de armazenamento compartilhado suportados. |
|
|
string |
O tipo de armazenamento compartilhado suportado. |
san_efficiency |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"Zones": {
"Zone": [
{
"ZoneId": "cn-hangzhou-g",
"ZoneType": "AvailabilityZone",
"LocalName": "China East 1 Zone 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"
]
}
}
]
}
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | InvalidSpotStrategy | The specified SpotStrategy is not valid. | O parâmetro SpotStrategy especificado é inválido. |
| 404 | InvalidRegionId.NotFound | The specified RegionId does not exist. | O RegionId especificado não existe. Verifique se o produto está disponível nesta região. |
| 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. | O tipo de idioma selecionado é inválido. Apenas chinês, inglês e japonês são suportados. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.