DescribeZones - : Central de Documentação do Alibaba Cloud

Observações de uso

Esta operação retorna apenas uma lista de zonas e algumas informações sobre os recursos de cada zona. Para consultar os tipos de instância e as categorias de disco disponíveis para compra em uma zona específica, chame a operação DescribeAvailableResource.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DescribeZones	Operação a ser executada. Defina o valor como DescribeZones.
RegionId	String	Sim	cn-hangzhou	ID da região cujas zonas serão consultadas. Chame a operação DescribeRegions para obter a lista mais recente de regiões.
Verbose	Boolean	Não	false	Especifica se devem ser exibidas informações detalhadas. true false Valor padrão: true.
InstanceChargeType	String	Não	PostPaid	Método de faturamento compatível com a zona. Para mais informações, consulte Visão geral do faturamento. Valores válidos: PrePaid: assinatura PostPaid: pagamento conforme o uso Valor padrão: PostPaid.
SpotStrategy	String	Não	NoSpot	Política de lance para a instância de pagamento conforme o uso. Especifique este parâmetro quando `InstanceChargeType` estiver definido como PostPaid. Para mais informações, consulte Instâncias preemptíveis. Valores válidos: NoSpot: instância regular de pagamento conforme o uso. SpotWithPriceLimit: instância preemptível com preço máximo por hora definido pelo usuário. SpotAsPriceGo: instância preemptível que utiliza automaticamente o preço de mercado como lance. Esse valor pode chegar ao preço de pagamento conforme o uso. Valor padrão: NoSpot.
AcceptLanguage	String	Não	zh-CN	Idioma natural usado para filtrar as respostas. Para mais informações, consulte RFC 7231. Valores válidos: zh-CN: chinês en-US: inglês ja: japonês Valor padrão: zh-CN.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.
Zones	Array of Zone		Detalhes sobre as zonas e seus recursos compatíveis.
Zone
ZoneId	String	cn-hangzhou-g	ID da zona.
ZoneType	String	AvailabilityZone	Tipo da zona. Valores válidos: AvailabilityZone: zona de nuvem pública da Alibaba Cloud
LocalName	String	Hangzhou Zone G	Nome da zona no idioma local.
AvailableResources	Array of ResourcesInfo		Detalhes sobre os recursos que podem ser criados na zona.
ResourcesInfo
IoOptimized	Boolean	true	Indica se a zona é compatível com instâncias otimizadas para I/O.
SystemDiskCategories	Array of String	cloud_essd	Categorias de discos de sistema que podem ser criados. Valores válidos: cloud: disco básico cloud_efficiency: disco ultra cloud_ssd: SSD padrão cloud_essd: SSD aprimorado (ESSD)
InstanceGenerations	Array of String	ecs-6	Gerações de famílias de instâncias compatíveis.
DataDiskCategories	Array of String	cloud_essd	Categorias de discos de dados que podem ser criados. Valores válidos: cloud: disco básico cloud_efficiency: disco ultra cloud_ssd: SSD padrão cloud_essd: ESSD ephemeral_ssd: SSD local
InstanceTypes	Array of String	ecs.g5.large	Tipos de instâncias otimizadas para I/O, de diferentes tipos de rede, que podem ser criados na zona.
InstanceTypeFamilies	Array of String	ecs.r7t	Famílias de instâncias compatíveis.
NetworkTypes	Array of String	vpc	Tipos de rede compatíveis. Valores válidos: VPC: Virtual Private Cloud (VPC) Classic: rede clássica
AvailableResourceCreation	Array of String	DedicatedHost	Tipos de recursos que podem ser criados. Valores válidos: VSwitch: vSwitch IoOptimized: instância otimizada para I/O Instance: instância DedicatedHost: host dedicado disk: disco em nuvem
DedicatedHostGenerations	Array of String	ddh-6	Gerações de hosts dedicados compatíveis.
AvailableInstanceTypes	Array of String	ecs.g6.xlarge	Tipos de instância compatíveis.
AvailableDiskCategories	Array of String	cloud	Categorias de discos que podem ser criados. Valores válidos: cloud: disco básico cloud_ssd: SSD padrão cloud_efficiency: disco ultra cloud_essd: ESSD
AvailableDedicatedHostTypes	Array of String	ddh.g6	Tipos de host dedicado compatíveis.
AvailableVolumeCategories	Array of String	san_efficiency	Categorias de dispositivos Shared Block Storage compatíveis.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

Formato XML

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>

Formato JSON

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

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.	Valor de SpotStrategy inválido.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	O RegionId não foi encontrado.
404	InvalidRegion.NotFound	The specified parameter RegionId is not valid.	Valor de RegionId inválido.
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records	O método de faturamento da instância não foi encontrado.
404	InvalidAcceptLanguage.NotFound	Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.	Valor de AcceptLanguage inválido. Os valores válidos são zh-CN, en-US e ja.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.