DescribeZones - Elastic Compute Service - Centro de documentación de Alibaba Cloud

Consulta la lista de zonas activas según parámetros como el ID de región y el método de facturación.

Descripción de la operación

DescribeZones solo consulta la lista de zonas proporcionadas por Alibaba Cloud y devuelve información limitada de inventario. Para consultar los tipos de instancia y las categorías de disco disponibles para compra en una zona específica, utilice DescribeAvailableResource.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región donde se encuentran las zonas. Puede llamar a DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
Verbose	boolean	No	Especifica si se debe mostrar información detallada. true: muestra información detallada. false: no muestra información detallada. Valor predeterminado: true.	false
InstanceChargeType	string	No	El método de facturación admitido por los recursos en la zona activa. Para obtener más información, consulte Resumen de facturación. Valores válidos: PrePaid: suscripción. PostPaid: pago por uso. Valor predeterminado: PostPaid.	PostPaid
SpotStrategy	string	No	La política de puja para instancias de pago por uso. Puede especificar este parámetro cuando `InstanceChargeType=PostPaid`. Para obtener más información, consulte Instancias spot. Valores válidos: NoSpot: instancia regular de pago por uso. SpotWithPriceLimit: instancia spot con un límite de precio máximo. SpotAsPriceGo: instancia spot con precio de mercado y el precio de pago por uso como límite superior. Valor predeterminado: NoSpot.	NoSpot
AcceptLanguage	string	No	El lenguaje natural que se utiliza para filtrar los resultados de la respuesta. Para obtener más información, consulte RFC 7231. Valores válidos: zh-CN: chino simplificado. zh-TW: chino tradicional. en-US: inglés. ja: japonés. fr: francés. de: alemán. ko: coreano. Valor predeterminado: zh-CN. Valores válidos: de : Alemán. en-US : Inglés. ko : Coreano. zh-TW : Chino tradicional. ja : Japonés. fr : Francés. zh-CN : Chino simplificado.	zh-CN

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Zones	object
Zone	array<object>	La colección de zonas y la información de recursos admitidos en cada zona.
	array<object>
ZoneId	string	El ID de la zona.	cn-hangzhou-g
ZoneType	string	El tipo de zona. Valores válidos: AvailabilityZone: zona de nube pública.	AvailabilityZone
LocalName	string	El nombre de la zona en el idioma local.	华东 1 可用区 G
AvailableResources	object
ResourcesInfo	array<object>	El arreglo de recursos específicos disponibles para creación.
	array<object>
IoOptimized	boolean	Indica si la instancia es una instancia optimizada para E/S. La optimización de E/S proporciona un mejor rendimiento de almacenamiento.	true
SystemDiskCategories	object
supportedSystemDiskCategory	array	La lista de categorías de disco del sistema.
	string	La categoría de disco del sistema que se puede crear. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra. cloud_ssd: SSD estándar. cloud_essd: SSD empresarial.	cloud_essd
InstanceGenerations	object
supportedInstanceGeneration	array	La lista de generaciones de familias de instancias admitidas.
	string	La generación de la familia de instancias.	ecs-6
DataDiskCategories	object
supportedDataDiskCategory	array	Las categorías de disco de datos que se pueden crear.
	string	La categoría de disco de datos. Valores válidos: cloud: disco básico. cloud_efficiency: disco ultra. cloud_ssd: SSD estándar. cloud_essd: SSD empresarial. ephemeral_ssd: SSD local.	cloud_essd
InstanceTypes	object
supportedInstanceType	array	La lista de tipos de instancia.
	string	La lista de tipos de instancia que se pueden crear en la combinación actual de zona, tipo de red (NetworkTypes) e instancia optimizada para E/S (IoOptimized).	ecs.g5.large
InstanceTypeFamilies	object
supportedInstanceTypeFamily	array	La lista de familias de instancias que se pueden crear.
	string	La familia de instancias.	ecs.r7t
NetworkTypes	object
supportedNetworkCategory	array	La lista de tipos de red admitidos.
	string	El tipo de red admitido. Valores válidos: VPC: nube privada virtual (VPC). Classic: red clásica. La red clásica está obsoleta. Para obtener más información, consulte Aviso de obsolescencia.	vpc
AvailableResourceCreation	object
ResourceTypes	array	La lista de tipos de recursos que se pueden crear.
	string	El tipo de recurso que se puede crear. Valores válidos: VSwitch: vSwitch. IoOptimized: instancia optimizada para E/S. Instance: instancia. DedicatedHost: host dedicado. Disk: disco.	DedicatedHost
DedicatedHostGenerations	object
DedicatedHostGeneration	array	La lista de generaciones de hosts dedicados admitidas.
	string	La generación de host dedicado admitida.	ddh-6
AvailableInstanceTypes	object
InstanceTypes	array	La lista de todos los tipos de instancia que se pueden crear en la zona actual.
	string	El tipo de instancia que se puede crear en la zona actual.	ecs.g6.xlarge
AvailableDiskCategories	object
DiskCategories	array	La colección de categorías de disco que se pueden crear.
	string	La categoría de disco que se puede crear. Valores válidos: cloud: disco básico. cloud_ssd: SSD estándar. cloud_efficiency: disco ultra. cloud_essd: SSD empresarial.	cloud
AvailableDedicatedHostTypes	object
DedicatedHostType	array	La lista de tipos de host dedicado admitidos.
	string	El tipo de host dedicado admitido.	ddh.g6
AvailableVolumeCategories	object
VolumeCategories	array	La lista de tipos de almacenamiento compartido admitidos.
	string	El tipo de almacenamiento compartido admitido.	san_efficiency

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Zones": {
    "Zone": [
      {
        "ZoneId": "cn-hangzhou-g",
        "ZoneType": "AvailabilityZone",
        "LocalName": "华东 1 可用区 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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidSpotStrategy	The specified SpotStrategy is not valid.	The specified SpotStrategy parameter is invalid.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	The specified region ID does not exist.
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.	Your selected language is invalid. Only Chinese, English, and Japanese are supported.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.