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

Consulta información sobre instancias spot en una región durante los últimos 30 días. La información incluye la tasa promedio de liberación de instancias spot y el porcentaje del precio promedio de la instancia spot respecto al precio de la instancia de pago por uso.

Descripción de la operación

Esta operación solo es aplicable a instancias spot optimizadas para E/S que residen en redes privadas virtuales (VPC).
Puede utilizar uno de los siguientes métodos para invocar esta operación:
- Especifique Cores y Memory, o MinCores y MinMemory, para consultar información sobre los tipos de instancia que cumplen con los requisitos de vCPU y memoria especificados.
- Especifique InstanceTypes.N para consultar información sobre los tipos de instancia especificados.
- Especifique Cores y Memory, o MinCores y MinMemory, y luego especifique InstanceTypeFamily o InstanceFamilyLevel para consultar información sobre los tipos de instancia que cumplen con los requisitos de vCPU y memoria especificados dentro de la familia de instancias indicada o en un nivel de familia de instancias específico.
Puede calcular el precio promedio de las instancias spot basándose en el porcentaje del precio promedio de la instancia spot respecto al precio de la instancia de pago por uso y en el precio de la instancia de pago por uso.

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. Puede invocar la operación DescribeRegions para consultar la lista de regiones más reciente.	cn-hangzhou
Cores	integer	No	El número de vCPU del tipo de instancia. Para obtener más información, consulte Familias de instancias.	2
Memory	number	No	El tamaño de memoria del tipo de instancia. Unidad: GiB. Para obtener más información, consulte Familias de instancias.	8.0
MinCores	integer	No	El número mínimo de vCPU del tipo de instancia. Para obtener más información, consulte Familias de instancias.	2
MinMemory	number	No	El tamaño mínimo de memoria del tipo de instancia. Para obtener más información, consulte Familias de instancias.	8.0
ZoneId	string	No	El ID de la zona. Este parámetro se deja vacío de forma predeterminada, lo que indica que se consultan todas las zonas de la región especificada.	cn-hangzhou-i
InstanceTypeFamily	string	No	La familia de instancias. Para obtener más información, consulte Familias de instancias.	ecs.c5
InstanceFamilyLevel	string	No	El nivel de la familia de instancias. Valores válidos: EntryLevel. EnterpriseLevel. CreditEntryLevel. Para obtener más información, consulte Descripción general de instancias ampliables. Este parámetro se deja vacío de forma predeterminada, lo que indica que se consultan familias de instancias de todos los niveles.	EntryLevel
GpuSpec	string	No	El tipo de GPU. Valores válidos: NVIDIA P4 NVIDIA T4 NVIDIA P100 NVIDIA V100 Este parámetro se deja vacío de forma predeterminada, lo que indica que se consultan todos los tipos de GPU. Para obtener más información, consulte Familias de instancias optimizadas para computación acelerada por GPU y aceleradas por vGPU.	NVIDIA T4
GpuAmount	integer	No	El número de GPU que tiene una instancia acelerada por GPU. Para obtener información sobre los valores válidos, consulte Tipos de instancias optimizadas para computación acelerada por GPU.	2
InstanceTypes	array	No	Los tipos de instancia. Puede especificar hasta 10 tipos de instancia.	ecs.c5.large
	string	No	El tipo de instancia. Para obtener más información, consulte Familias de instancias.	ecs.c5.large

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RegionId	string	El ID de la región.	cn-hangzhou
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
AvailableSpotZones	object
AvailableSpotZone	array<object>	Detalles sobre las instancias spot en las zonas de la región especificada. Nota Los valores devueltos se ordenan según los porcentajes históricos de los precios promedio de las instancias spot respecto a los precios de las instancias de pago por uso para los tipos de instancia.
	array<object>
ZoneId	string	El ID de la zona.	cn-hangzhou-i
AvailableSpotResources	object
AvailableSpotResource	array<object>	Detalles sobre las instancias spot en los últimos 30 días, incluida la tasa de liberación de instancias spot y los porcentajes de los precios promedio de las instancias spot respecto a los precios de las instancias de pago por uso.
	object
InterruptRateDesc	string	El rango de la tasa de liberación de instancias spot en los últimos 30 días, que corresponde al valor de `InterruptionRate`. Valores válidos: 0-3% 3-5% 5-10% 10-100%	0-3%
AverageSpotDiscount	integer	El porcentaje del precio promedio de la instancia spot respecto al precio de la instancia de pago por uso en los últimos 30 días. Unidad: %. Valores válidos: de 1 a 100. Puede calcular el precio promedio de la instancia spot basándose en el valor devuelto. Por ejemplo, si el precio de la instancia de pago por uso es 1 y el valor devuelto de este parámetro es 20, el precio promedio de la instancia spot en los últimos 30 días es 0.2.	20
InstanceType	string	El tipo de instancia.	ecs.c5.large
InterruptionRate	number	La tasa promedio de liberación de instancias spot en los últimos 30 días. Unidad: %.	0

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RegionId": "cn-hangzhou",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "AvailableSpotZones": {
    "AvailableSpotZone": [
      {
        "ZoneId": "cn-hangzhou-i",
        "AvailableSpotResources": {
          "AvailableSpotResource": [
            {
              "InterruptRateDesc": "0-3%",
              "AverageSpotDiscount": 20,
              "InstanceType": "ecs.c5.large",
              "InterruptionRate": 0
            }
          ]
        }
      }
    ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	Invalid.SaleStrategy	The specified saleStrategy is not valid.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	The specified DestinationResource parameter is invalid.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	The specified RegionId parameter is invalid.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist in our records.	The specified dedicated host does not exist.
403	InvalidParam.TypeAndCpuMem.Conflict	The specified 'InstanceType' and 'Cores','Memory' are not blank at the same time.	You cannot specify the instance type, number of vCPUs, and memory size at the same time.
403	InvalidParam.Cores	The specified parameter 'Cores' should not be empty
403	InvalidParam.Memory	The specified parameter 'Memory' should not be empty
403	OperationDenied.RegionIdNotSupported	region not support spot duration instance.
403	OperationDenied.FlavorNotSupported	flavor not support spot duration instance.
403	OperationDenied.TimestampNotSupported	timestamp not support spot duration instance.
404	Invalid.RegionId	The specified RegionId does not exist.	The specified RegionId parameter is invalid.
404	Unavailable.Regions	The available regions does not exists	The specified RegionId parameter is invalid.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	The specified resource type is invalid.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	The specified DestinationResource parameter is invalid.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	The specified IoOptimized parameter is invalid.
404	Invalid.NetworkType	The specified NetworkType is not valid.	The specified NetworkType parameter is invalid.

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.