DescribeSpotAdvice - - Centre de documentation Alibaba Cloud

Description

Appelez cette opération pour interroger les informations générées pour les instances préemptibles au cours des 30 derniers jours et sélectionnez les types d'instance appropriés en fonction des résultats de la requête. Les informations que vous pouvez obtenir via cette opération incluent :
- Le taux moyen de libération des instances préemptibles
- Le pourcentage du prix moyen des instances préemptibles par rapport au prix des instances à la demande
- Le prix moyen des instances préemptibles calculé sur la base du pourcentage précédent
Cette opération s'applique uniquement aux instances préemptibles optimisées pour les E/S situées dans des réseaux privés virtuels (VPC).
Vous pouvez utiliser l'une des méthodes suivantes pour interroger les informations générées pour les instances préemptibles au cours des 30 derniers jours :
- Définissez les paramètres Cores et Memory ou les paramètres MinCores et MinMemory pour interroger les informations sur les types d'instance disposant du nombre spécifié de vCPU et de la taille de mémoire indiquée.
- Définissez le paramètre InstanceTypes.N pour interroger les informations relatives aux types d'instance spécifiés.
- Définissez les paramètres Cores et Memory ou les paramètres MinCores et MinMemory, ainsi que le paramètre InstanceTypeFamily ou InstanceFamilyLevel pour interroger les informations sur les types d'instance ayant le nombre spécifié de vCPU et la taille de mémoire indiquée au sein de la famille d'instances spécifiée ou au niveau de famille d'instances indiqué.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Non	DescribeSpotAdvice	L'opération que vous souhaitez effectuer. Définissez la valeur sur DescribeSpotAdvice.
RegionId	String	Oui	cn-hangzhou	L'ID de la région. Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.
Cores	Integer	Non	2	Le nombre de vCPU du type d'instance. Pour connaître les valeurs valides, consultez Families d'instances.
Memory	Float	Non	8.0	La taille de la mémoire du type d'instance. Unité : GiB. Pour connaître les valeurs valides, consultez Families d'instances.
MinCores	Integer	Non	2	Le nombre minimal de vCPU du type d'instance. Pour connaître les valeurs valides, consultez Families d'instances.
MinMemory	Float	Non	8.0	La taille minimale de la mémoire du type d'instance. Pour connaître les valeurs valides, consultez Families d'instances.
ZoneId	String	Non	cn-hangzhou-i	L'ID de la zone. Ce paramètre est vide par défaut, ce qui indique que toutes les zones de la région spécifiée sont interrogées.
InstanceTypes.N	RepeatList	Non	ecs.c5.large	Type d'instance N. Valeurs valides pour N : 1 à 10. Pour connaître les valeurs valides, consultez Families d'instances.
InstanceTypeFamily	String	Non	ecs.c5	La famille d'instances. Pour connaître les valeurs valides, consultez Families d'instances.
InstanceFamilyLevel	String	Non	EntryLevel	Le niveau de la famille d'instances. Valeurs valides : EntryLevel EnterpriseLevel CreditEntryLevel. Pour plus d'informations, consultez Présentation des instances à performance variable. Ce paramètre est vide par défaut, ce qui indique que les familles d'instances de tous les niveaux sont interrogées.
GpuSpec	String	Non	NVIDIA T4	Le type de GPU. Valeurs valides : NVIDIA P4 NVIDIA T4 NVIDIA P100 NVIDIA V100 Ce paramètre est vide par défaut, ce qui indique que tous les types de GPU sont interrogés. Pour plus d'informations, consultez Types d'instances optimisées pour le calcul accéléré par GPU.
GpuAmount	Integer	Non	2	Le nombre de GPU par instance accélérée par GPU. Pour connaître les valeurs valides, consultez Types d'instances optimisées pour le calcul accéléré par GPU.

Paramètres de réponse

Parameter	Type	Example	Description
AvailableSpotZones	Array of AvailableSpotZone		Détails sur les instances à prix réduit dans les zones de la région spécifiée. Remarque Les valeurs renvoyées sont triées en fonction des pourcentages historiques des prix moyens des instances à prix réduit par rapport aux prix des instances à la demande pour les types d'instance.
AvailableSpotZone
AvailableSpotResources	Array of AvailableSpotResource		Détails sur les instances à prix réduit au cours des 30 derniers jours, y compris les taux de libération et les pourcentages des prix moyens des instances à prix réduit par rapport aux prix des instances à la demande.
AvailableSpotResource
AverageSpotDiscount	Integer	20	Pourcentage du prix moyen de l'instance à prix réduit par rapport au prix de l'instance à la demande au cours des 30 derniers jours. Unité : pourcentage (%). Valeurs valides : 1 à 100. Vous pouvez calculer le prix moyen de l'instance à prix réduit en vous basant sur la valeur renvoyée. Par exemple, si le prix de l'instance à la demande est de 1 et que la valeur renvoyée de ce paramètre est 20, le prix moyen de l'instance à prix réduit au cours des 30 derniers jours est de 0,2.
InstanceType	String	ecs.c5.large	Type d'instance.
InterruptRateDesc	String	0-3 %	Plage de taux de libération des instances à prix réduit au cours des 30 derniers jours, qui correspond à la valeur `InterruptionRate`. Valeurs valides : 0-3 % 3-5 % 5-10 % 10-100 %
InterruptionRate	Float	0	Taux de libération moyen des instances à prix réduit au cours des 30 derniers jours. Unité : pourcentage (%).
ZoneId	String	cn-hangzhou-i	ID de la zone.
RegionId	String	cn-hangzhou	ID de la région.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID de la requête.

Exemples

Exemple de requête

https://ecs.aliyuncs.com/?Action=DescribeSpotAdvice
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-i
&InstanceTypes.1=ecs.c5.large
&<Common request parameters>

Exemple de réponse réussie

XML format

<DescribeSpotAdviceResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
      <AvailableSpotZones>
            <AvailableSpotZone>
                  <ZoneId>cn-hangzhou-i</ZoneId>
            </AvailableSpotZone>
            <AvailableSpotZone>
                  <AvailableSpotResources>
                        <AvailableSpotResource>
                              <InterruptRateDesc>0-3%</InterruptRateDesc>
                              <InstanceType>ecs.c5.large</InstanceType>
                              <AverageSpotDiscount>20</AverageSpotDiscount>
                              <InterruptionRate>0</InterruptionRate>
                        </AvailableSpotResource>
                  </AvailableSpotResources>
            </AvailableSpotZone>
      </AvailableSpotZones>
      <RegionId>cn-hangzhou</RegionId>
</DescribeSpotAdviceResponse>

JSON format

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

Codes d'erreur

HTTP status code

Error code

Error message

Description

404

Invalid.RegionId

The specified RegionId does not exist.

The error message returned because the specified RegionId parameter is invalid.

404

Unavailable.Regions

The available regions does not exists

The error message returned because the specified RegionId parameter is invalid.

400

Invalid.Param

The input parameter DestinationResource that is mandatory for processing this request is not supplied.

The error message returned because the specified DestinationResource parameter is invalid.

404

Invalid.ResourceType

The ResourceType provided does not exist in our records.

The error message returned because the specified ResourceType parameter is invalid.

404

Invalid.DestinationResource

The specified DestinationResource is not valid.

The error message returned because the specified DestinationResource parameter is invalid.

404

Invalid.IoOptimized

The specified IoOptimized is not valid.

The error message returned because the specified IoOptimized parameter is invalid.

404

Invalid.NetworkType

The specified NetworkType is not valid.

The error message returned because the specified NetworkType parameter is invalid.

403

InvalidDedicatedHostId.NotFound

The specified DedicatedHostId does not exist in our records.

The error message returned because the specified dedicated host does not exist in the current region.

403

InvalidParam.TypeAndCpuMem.Conflict

The specified 'InstanceType' and 'Cores','Memory' are not blank at the same time.

The error message returned because the InstanceTypes.N, Cores, and Memory parameters are all empty.

400

InvalidRegionId.MalFormed

The specified parameter RegionId is not valid.

The error message returned because the specified RegionId parameter is invalid.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.