DescribeZones - - Centro de documentación de Alibaba Cloud

Consulta las zonas de una región.

Notas de uso

Al invocar esta operación, solo se devuelve una lista de zonas y cierta información de recursos de cada zona. Si desea consultar los tipos de instancia y las categorías de disco disponibles para compra en una zona específica, le recomendamos invocar la operación DescribeAvailableResource.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos invocar esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeZones	La operación que desea ejecutar. Establezca el valor en DescribeZones.
RegionId	String	Sí	cn-hangzhou	El ID de la región cuyas zonas desea consultar. Puede invocar la operación DescribeRegions para obtener la lista más reciente de regiones.
Verbose	Boolean	No	false	Especifica si se muestra información detallada. true false Valor predeterminado: true.
InstanceChargeType	String	No	PostPaid	El método de facturación compatible con la zona. Para obtener más información, consulte Billing overview. Valores válidos: PrePaid: suscripción PostPaid: pay-as-you-go Valor predeterminado: PostPaid.
SpotStrategy	String	No	NoSpot	La política de puja para la instancia pay-as-you-go. Especifique este parámetro cuando el parámetro `InstanceChargeType` se establece en PostPaid. Para obtener más información, consulte Preemptible instances. Valores válidos: NoSpot: La instancia es una instancia pay-as-you-go regular. SpotWithPriceLimit: La instancia es una preemptible instance con un precio máximo por hora definido por el usuario. SpotAsPriceGo: La instancia es una preemptible instance que utiliza automáticamente el precio de mercado como precio de puja. El precio de mercado puede ser hasta igual al precio pay-as-you-go. Valor predeterminado: NoSpot.
AcceptLanguage	String	No	zh-CN	El idioma natural utilizado para filtrar las respuestas. Para obtener más información, consulte RFC 7231. Valores válidos: zh-CN: chino en-US: inglés ja: japonés Valor predeterminado: zh-CN.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.
Zones	Array of Zone		Detalles sobre las zonas y sus recursos compatibles.
Zone
ZoneId	String	cn-hangzhou-g	El ID de la zona.
ZoneType	String	AvailabilityZone	El tipo de zona. Valores válidos: AvailabilityZone: Zona de nube pública de Alibaba Cloud
LocalName	String	Hangzhou Zone G	El nombre de la zona en el idioma local.
AvailableResources	Array of ResourcesInfo		Detalles sobre los recursos que se pueden crear en la zona.
ResourcesInfo
IoOptimized	Boolean	true	Indica si la zona admite instancias optimizadas para E/S.
SystemDiskCategories	Array of String	cloud_essd	Las categorías de discos del sistema que se pueden crear. Valores válidos: cloud: disco básico cloud_efficiency: disco ultra cloud_ssd: SSD estándar cloud_essd: SSD mejorado (ESSD)
InstanceGenerations	Array of String	ecs-6	Las generaciones de familias de instancias compatibles.
DataDiskCategories	Array of String	cloud_essd	Las categorías de discos de datos que se pueden crear. Valores válidos: cloud: disco básico cloud_efficiency: disco ultra cloud_ssd: SSD estándar cloud_essd: ESSD ephemeral_ssd: SSD local
InstanceTypes	Array of String	ecs.g5.large	Los tipos de instancias optimizadas para E/S de diferentes tipos de red que se pueden crear en la zona.
InstanceTypeFamilies	Array of String	ecs.r7t	Las familias de instancias compatibles.
NetworkTypes	Array of String	vpc	Los tipos de red compatibles. Valores válidos: VPC: Virtual Private Cloud (VPC) Classic: red clásica
AvailableResourceCreation	Array of String	DedicatedHost	Los tipos de recursos que se pueden crear. Valores válidos: VSwitch: vSwitch IoOptimized: instancia optimizada para E/S Instance: instancia DedicatedHost: host dedicado disk: disco en la nube
DedicatedHostGenerations	Array of String	ddh-6	Las generaciones de hosts dedicados compatibles.
AvailableInstanceTypes	Array of String	ecs.g6.xlarge	Los tipos de instancia compatibles.
AvailableDiskCategories	Array of String	cloud	Las categorías de discos que se pueden crear. Valores válidos: cloud: disco básico cloud_ssd: SSD estándar cloud_efficiency: disco ultra cloud_essd: ESSD
AvailableDedicatedHostTypes	Array of String	ddh.g6	Los tipos de host dedicado compatibles.
AvailableVolumeCategories	Array of String	san_efficiency	Las categorías de dispositivos Shared Block Storage compatibles.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidSpotStrategy	The specified SpotStrategy is not valid.	Valor de SpotStrategy no válido.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	No se encontró el RegionId.
404	InvalidRegion.NotFound	The specified parameter RegionId is not valid.	Valor de RegionId no válido.
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records	No se encontró el método de facturación de la instancia.
404	InvalidAcceptLanguage.NotFound	Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.	Valor de AcceptLanguage no válido. Los valores válidos son zh-CN, en-US y ja.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.