Tous les produits
Search

Ce produit

    Elastic Compute Service:DescribeSpotAdvice

    Centre de documentation

    Elastic Compute Service:DescribeSpotAdvice

    Dernière mise à jour :Aug 18, 2026

    Consulte les informations sur les instances spot dans une région au cours des 30 derniers jours. Ces informations incluent le taux d'interruption moyen des instances spot et le pourcentage du prix moyen des instances spot par rapport au prix des instances à la demande.

    Description de l'opération

    • Cette opération s'applique uniquement aux instances spot optimisées pour les E/S qui résident dans des réseaux privés virtuels (VPC).

    • Vous pouvez utiliser l'une des méthodes suivantes pour appeler cette opération :

      • Spécifiez Cores et Memory ou MinCores et MinMemory pour consulter les informations sur les types d'instances qui répondent aux exigences spécifiées en matière de vCPU et de mémoire.

      • Spécifiez InstanceTypes.N pour consulter les informations sur les types d'instances spécifiés.

      • Spécifiez Cores et Memory ou MinCores et MinMemory, puis spécifiez InstanceTypeFamily ou InstanceFamilyLevel pour consulter les informations sur les types d'instances qui répondent aux exigences spécifiées en matière de vCPU et de mémoire au sein de la famille d'instances spécifiée ou à un niveau de famille d'instances spécifié.

    • Vous pouvez calculer le prix moyen des instances spot en fonction du pourcentage du prix moyen des instances spot par rapport au prix des instances à la demande et du prix des instances à la demande.

    Testez maintenant

    Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

    Test

    Autorisation RAM

    Aucune autorisation n'est requise pour cette opération. En cas de problème, contactez le support technique.

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    RegionId

    string

    Oui

    L'identifiant de la région. Vous pouvez appeler l'opération DescribeRegions pour consulter la liste des régions la plus récente.

    cn-hangzhou
    Cores

    integer

    Non

    Le nombre de vCPU du type d'instance. Pour plus d'informations, consultez Familles d'instances.

    2
    Memory

    number

    Non

    La taille de la mémoire du type d'instance. Unité : Gio. Pour plus d'informations, consultez Familles d'instances.

    8.0
    MinCores

    integer

    Non

    Le nombre minimal de vCPU du type d'instance. Pour plus d'informations, consultez Familles d'instances.

    2
    MinMemory

    number

    Non

    La taille minimale de la mémoire du type d'instance. Pour plus d'informations, consultez Familles d'instances.

    8.0
    ZoneId

    string

    Non

    L'identifiant 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 consultées.

    cn-hangzhou-i
    InstanceTypeFamily

    string

    Non

    La famille d'instances. Pour plus d'informations, consultez Familles d'instances.

    ecs.c5
    InstanceFamilyLevel

    string

    Non

    Le niveau de la famille d'instances. Valeurs valides :

    Ce paramètre est vide par défaut, ce qui indique que les familles d'instances de tous les niveaux sont consultées.

    EntryLevel
    GpuSpec

    string

    Non

    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 consultés. Pour plus d'informations, consultez Familles d'instances optimisées pour le calcul accéléré par GPU et accéléré par vGPU.

    NVIDIA T4
    GpuAmount

    integer

    Non

    Le nombre de GPU dont dispose une instance accélérée par GPU. Pour plus d'informations sur les valeurs valides, consultez Types d'instances optimisées pour le calcul accéléré par GPU.

    2
    InstanceTypes

    array

    Non

    Les types d'instances. Vous pouvez spécifier jusqu'à 10 types d'instances.

    ecs.c5.large

    string

    Non

    Le type d'instance. Pour plus d'informations, consultez Familles d'instances.

    ecs.c5.large

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    RegionId

    string

    L'identifiant de la région.

    cn-hangzhou
    RequestId

    string

    L'identifiant de la requête.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    AvailableSpotZones

    object

    AvailableSpotZone

    array<object>

    Détails sur les instances spot dans les zones de la région spécifiée.

    Remarque

    Les valeurs de retour sont triées en fonction des pourcentages historiques des prix moyens des instances spot par rapport aux prix des instances à la demande pour les types d'instances.

    array<object>

    ZoneId

    string

    The zone ID.

    cn-hangzhou-i
    AvailableSpotResources

    object

    AvailableSpotResource

    array<object>

    The array that consists of the release rate, discount rate, and other information about spot instances over the last 30 days.

    object

    InterruptRateDesc

    string

    The range of the release rate of spot instances over the last 30 days, which corresponds to the InterruptionRate return value. Valid values:

    • 0-3%

    • 3-5%

    • 5-10%

    • 10-100%

    0-3%
    AverageSpotDiscount

    integer

    The discount rate of the average price of spot instances compared to the price of pay-as-you-go instances over the last 30 days. Unit: %. Valid values: 1 to 100.

    You can use this return value to calculate the average price of spot instances. For example, if the price of a pay-as-you-go instance is 1 and this return value is 20 (20%), the average price of spot instances over the last 30 days is 0.2.

    20
    InstanceType

    string

    The instance type.

    ecs.c5.large
    InterruptionRate

    number

    The average release rate of spot instances over the last 30 days. Unit: %.

    0

    Exemples

    JSON format

    {
  "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
            }
          ]
        }
      }
    ]
  }
}

    Codes d'erreur

    Code de statut HTTP

    Code d'erreur

    Message d'erreur

    Description
    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.

    Consultez Codes d'erreur pour la liste complète.

    Notes de version

    Consultez Notes de version pour la liste complète.