DescribeAvailableResource - - Centro de documentación de Alibaba Cloud

Consulta los recursos disponibles en una zona. Puede consultar los recursos de una zona antes de crear instancias ECS mediante la operación RunInstances o antes de modificar los tipos de instancia con la operación ModifyInstanceSpec.

Notas de uso

El valor de DestinationResource determina si es necesario especificar parámetros adicionales. Al seleccionar un valor en la siguiente cadena para DestinationResource, mientras más a la derecha se encuentre el valor elegido, mayor será la cantidad de parámetros que deberá especificar.

Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk
Ejemplos:
- Establezca DestinationResource como DataDisk.
  - Si establece ResourceType como disk para consultar categorías de discos de datos independientes de los tipos de instancia ECS, no necesita especificar InstanceType.
  - Si establece ResourceType como instance para consultar las categorías de discos de datos que se adquieren junto con instancias ECS, debe especificar InstanceType y SystemDiskCategory debido a los límites específicos de cada tipo de instancia para discos del sistema y discos de datos.
- Si establece DestinationResource como SystemDisk y ResourceType como instance, debe especificar InstanceType debido a los límites específicos del tipo de instancia para discos del sistema.
- Si establece DestinationResource como InstanceType, se recomienda especificar IoOptimized e InstanceType.
- Para consultar los recursos ecs.g5.large disponibles en todas las zonas de la región China (Hangzhou), establezca RegionId como cn-hangzhou, DestinationResource como InstanceType, IoOptimized como optimized e InstanceType como ecs.g5.large.
- Para consultar las zonas de la región China (Hangzhou) donde hay recursos ecs.g5.large disponibles, establezca RegionId como cn-hangzhou, DestinationResource como Zone, IoOptimized como optimized e InstanceType como ecs.g5.large.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, se recomienda llamar a esta operación desde OpenAPI Explorer. Esta herramienta 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í	DescribeAvailableResource	La operación que desea ejecutar. Establezca el valor como DescribeAvailableResource.
RegionId	String	Sí	cn-hangzhou	El ID de la región. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
InstanceChargeType	String	No	PrePaid	El método de facturación del recurso. 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 estrategia de puja para la instancia pay-as-you-go. Valores válidos: NoSpot: La instancia es de tipo pay-as-you-go. SpotWithPriceLimit: La instancia se crea como preemptible instance y permite especificar el precio horario máximo. SpotAsPriceGo: La instancia se crea como preemptible instance cuyo precio se basa en el precio de mercado al momento de la compra. Este precio puede ser igual al de una instancia pay-as-you-go. Valor predeterminado: NoSpot. Este parámetro solo surte efecto si establece InstanceChargeType como PostPaid.
SpotDuration	Integer	No	1	El periodo de protección de la preemptible instance. Unidad: horas. Valor predeterminado: 1. Valores válidos: 1: Tras crear una preemptible instance, Alibaba Cloud garantiza que la instancia no se liberará automáticamente durante 1 hora. Una vez finalizado este periodo de protección, el sistema compara el precio de puja con el precio de mercado y verifica el inventario de recursos para determinar si conserva o libera la instancia. 0: Tras crear una preemptible instance, Alibaba Cloud no garantiza que la instancia se ejecute durante 1 hora. El sistema compara el precio de puja con el precio de mercado y verifica el inventario de recursos para determinar si conserva o libera la instancia. Alibaba Cloud envía eventos del sistema ECS para notificarle 5 minutos antes de que se libere la instancia. Las preemptible instances se facturan por segundo. Se recomienda especificar un periodo de protección según sus requisitos empresariales. Nota Si establece SpotStrategy como SpotWithPriceLimit o SpotAsPriceGo, este parámetro surte efecto.
DestinationResource	String	Sí	InstanceType	El tipo de recurso. Valores válidos: Zone: zona. IoOptimized: recurso optimizado para E/S. InstanceType: tipo de instancia. SystemDisk: disco del sistema. DataDisk: disco de datos. Network: tipo de red. ddh: host dedicado. Para obtener más información sobre cómo especificar DestinationResource, consulte la sección "Notas de uso" de este tema.
ZoneId	String	No	cn-hangzhou-e	El ID de la zona. De forma predeterminada, este parámetro está vacío. Esto indica que el sistema devuelve los recursos que cumplen las demás condiciones en todas las zonas dentro de la región especificada por `RegionId`.
IoOptimized	String	No	optimized	Especifica si la instancia está optimizada para E/S. Valores válidos: none: La instancia no está optimizada para E/S. optimized: La instancia está optimizada para E/S. Valor predeterminado: optimized.
DedicatedHostId	String	No	dh-bp165p6xk2tlw61e****	El ID del host dedicado.
InstanceType	String	No	ecs.g5.large	El tipo de instancia. Para obtener más información, consulte Overview of instance families. También puede llamar a la operación DescribeInstanceTypes para consultar la lista de tipos de instancia más reciente. Para obtener más información sobre cómo especificar InstanceType, consulte la sección Notas de uso de este tema.
SystemDiskCategory	String	No	cloud_ssd	La categoría del disco del sistema. Valores válidos: cloud: disco básico. cloud_efficiency: ultra disk cloud_ssd: SSD estándar. ephemeral_ssd: SSD local. cloud_essd: ESSD. cloud_auto: disco ESSD AutoPL. Valor predeterminado: cloud_efficiency. Nota Si establece ResourceType como instance y DestinationResource como DataDisk, debe especificar SystemDiskCategory. Si no especifica este parámetro, se utiliza el valor predeterminado.
DataDiskCategory	String	No	cloud_ssd	El tipo de disco de datos. Valores válidos: cloud: disco básico. cloud_efficiency: ultra disk cloud_ssd: SSD estándar. ephemeral_ssd: SSD local. cloud_essd: ESSD. cloud_auto: disco ESSD AutoPL.
NetworkCategory	String	No	vpc	El tipo de red. Valores válidos: vpc: virtual private cloud (VPC). classic: red clásica.
Cores	Integer	No	2	El número de vCPU del tipo de instancia. Para obtener más información, consulte Overview of instance families. Este parámetro solo surte efecto si establece DestinationResource como InstanceType.
Memory	Float	No	8.0	El tamaño de memoria del tipo de instancia. Unidad: GiB. Para obtener más información, consulte Overview of instance families. Este parámetro solo surte efecto si establece DestinationResource como InstanceType.
ResourceType	String	No	instance	El tipo de recurso. Valores válidos: instance: instancia ECS. disk: disco en la nube. reservedinstance: reserved instance. ddh: host dedicado.
Scope	String	No	Region	El alcance de la reserved instance. Valores válidos: Region: regional. Zone: zonal

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	0041D94C-FB92-4C49-B115-259DA1C*	El ID de la solicitud.
AvailableZones	Array of AvailableZone		Las zonas consultadas.
AvailableZone
ZoneId	String	cn-hangzhou-e	El ID de la zona.
Status	String	Available	El estado de los recursos en la zona. Valores válidos: Available SoldOut
StatusCategory	String	WithStock	La categoría del recurso según el nivel de inventario. Valores válidos: WithStock: Hay recursos suficientes. ClosedWithStock: Los recursos son insuficientes. Se recomienda utilizar otros recursos con inventario suficiente. WithoutStock: Los recursos están agotados y se reabastecerán. Se recomienda utilizar otros recursos con inventario suficiente. ClosedWithoutStock: Los recursos están agotados y no se reabastecerán. Se recomienda utilizar otros recursos con inventario suficiente.
RegionId	String	cn-hangzhou	El ID de la región.
AvailableResources	Array of AvailableResource		Los recursos disponibles en la zona.
AvailableResource
Type	String	InstanceType	El tipo de recurso. Valores válidos: Zone: zona. IoOptimized: recurso optimizado para E/S. InstanceType: tipo de instancia. SystemDisk: disco del sistema. DataDisk: disco de datos. Network: tipo de red. ddh: host dedicado.
SupportedResources	Array of SupportedResource		Los recursos consultados.
SupportedResource
Status	String	Available	El estado del recurso. Valores válidos: Available SoldOut
Value	String	ecs.d1ne.xlarge	El tipo de recurso.
Max	Integer	2048	La capacidad máxima del disco. Este parámetro solo surte efecto si establece DestinationResource como SystemDisk o DataDisk.
Unit	String	GiB	La unidad de capacidad del disco. Este parámetro solo surte efecto si establece DestinationResource como SystemDisk o DataDisk.
StatusCategory	String	WithStock	La categoría del recurso según el nivel de inventario. Valores válidos: WithStock: Hay recursos suficientes. ClosedWithStock: Los recursos son insuficientes. Se recomienda utilizar otros recursos con inventario suficiente. WithoutStock: Los recursos están agotados y se reabastecerán. Se recomienda utilizar otros recursos con inventario suficiente. ClosedWithoutStock: Los recursos están agotados y no se reabastecerán. Se recomienda utilizar otros recursos con inventario suficiente.
Min	Integer	20	La capacidad mínima del disco. Este parámetro solo surte efecto si establece DestinationResource como SystemDisk o DataDisk.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=DescribeAvailableResource
&RegionId=cn-hangzhou
&DestinationResource=InstanceType
&IoOptimized=optimized
&InstanceType=ecs.g5.large
&<Common request parameters>

Respuestas de éxito de ejemplo

XML formato

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAvailableResourceResponse>
    <RequestId>0041D94C-FB92-4C49-B115-259DA1C*****</RequestId>
    <AvailableZones>
        <AvailableZone>
            <Status>Available</Status>
            <RegionId>cn-hangzhou</RegionId>
            <AvailableResources>
                <AvailableResource>
                    <Type>InstanceType</Type>
                    <SupportedResources>
                        <SupportedResource>
                            <Status>Available</Status>
                            <Value>ecs.g5.large</Value>
                            <StatusCategory>WithStock</StatusCategory>
                        </SupportedResource>
                    </SupportedResources>
                </AvailableResource>
            </AvailableResources>
            <ZoneId>cn-hangzhou-i</ZoneId>
            <StatusCategory>WithStock</StatusCategory>
        </AvailableZone>
    </AvailableZones>
</DescribeAvailableResourceResponse>

JSON formato

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0041D94C-FB92-4C49-B115-259DA1C*****",
  "AvailableZones" : {
    "AvailableZone" : [ {
      "Status" : "Available",
      "RegionId" : "cn-hangzhou",
      "AvailableResources" : {
        "AvailableResource" : [ {
          "Type" : "InstanceType",
          "SupportedResources" : {
            "SupportedResource" : [ {
              "Status" : "Available",
              "Value" : "ecs.g5.large",
              "StatusCategory" : "WithStock"
            } ]
          }
        } ]
      },
      "ZoneId" : "cn-hangzhou-i",
      "StatusCategory" : "WithStock"
    } ]
  }
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	Valor de InstanceChargeType no válido.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	Valor de DestinationResource no válido.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	Valor de RegionId no válido.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	Valor de DedicatedHostId no válido.
404	Invalid.RegionId	The specified RegionId does not exist.	Valor de RegionId no válido.
404	Unavailable.Regions	The available regions does not exists	Valor de RegionId no válido.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	Valor de ResourceType no válido.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	Valor de DestinationResource no válido.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	Valor de IoOptimized no válido.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	Valor de NetworkCategory no válido.
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	Valor de SpotStrategy no válido.
404	Invalid.NetworkType	The specified NetworkType is not valid.	Valor de NetworkType no válido.
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records	Valor de ResourceId no válido. Compruebe si el recurso existe.

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