Todos os produtos
Search
Central de documentação

Elastic Compute Service:DescribeZones

Última atualização: Oct 16, 2026

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

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

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:

  • true: Exibe informações detalhadas.

  • false: Não exibe informações detalhadas.

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:

  • PrePaid: assinatura.

  • PostPaid: pay-as-you-go.

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:

  • NoSpot: instância pay-as-you-go regular.

  • SpotWithPriceLimit: instância spot com preço máximo.

  • SpotAsPriceGo: instância spot cujo preço é oferecido automaticamente pelo sistema, até o preço pay-as-you-go.

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:

  • zh-CN: Chinês simplificado.

  • zh-TW: Chinês tradicional.

  • en-US: Inglês.

  • ja: Japonês.

  • fr: Francês.

  • de: Alemão.

  • ko: Coreano.

Valor padrão: zh-CN.

Valores válidos:

  • de :

    Alemão.

  • en-US :

    Inglês.

  • ko :

    Coreano.

  • zh-TW :

    Chinês tradicional.

  • ja :

    Japonês.

  • fr :

    Francês.

  • zh-CN :

    Chinês simplificado.

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: zona de nuvem pública.

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: disco básico.

  • cloud_efficiency: ultra disco.

  • cloud_ssd: SSD padrão.

  • cloud_essd: SSD empresarial.

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: disco básico.

  • cloud_efficiency: ultra disco.

  • cloud_ssd: SSD padrão.

  • cloud_essd: SSD empresarial.

  • ephemeral_ssd: SSD local.

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: virtual private cloud (VPC).

  • Classic: rede clássica. O recurso de rede clássica foi descontinuado. Para mais informações, consulte Aviso de descontinuação.

vpc

AvailableResourceCreation

object

ResourceTypes

array

A lista de tipos de recursos permitidos.

string

O tipo de recurso permitido. Valores válidos:

  • VSwitch: vSwitch.

  • IoOptimized: instância otimizada para I/O.

  • Instance: instância.

  • DedicatedHost: host dedicado.

  • Disk: disco.

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: disco básico.

  • cloud_ssd: SSD padrão.

  • cloud_efficiency: ultra disco.

  • cloud_essd: SSD empresarial.

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.