DescribeSpotPriceHistory - - Centre de documentation Alibaba Cloud

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

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeSpotPriceHistory	L'opération à effectuer. Définissez la valeur sur DescribeSpotPriceHistory.
RegionId	String	Yes	cn-hangzhou	L'ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions la plus récente.
ZoneId	String	No	cn-hangzhou-g	L'ID de zone de l'instance.
NetworkType	String	Yes	vpc	Le type de réseau de l'instance préemptible. Valeurs possibles : classic vpc
InstanceType	String	Yes	ecs.t1.xsmall	Le type d'instance.
SpotDuration	Integer	No	1	La période de protection de l'instance préemptible. Unité : heures. Valeur par défaut : 1. Valeurs possibles : 1 : Après la création d'une instance préemptible, Alibaba Cloud garantit que l'instance ne sera pas libérée automatiquement pendant 1 heure. À la fin de cette période de protection, le système compare le prix d'enchère au prix du marché et vérifie les ressources disponibles pour déterminer s'il faut conserver ou libérer l'instance. 0 : Après la création d'une instance préemptible, Alibaba Cloud ne garantit pas que l'instance fonctionnera pendant 1 heure. Le système compare le prix d'enchère au prix du marché et vérifie les ressources disponibles pour déterminer s'il faut conserver ou libérer l'instance. Alibaba Cloud envoie des événements système Elastic Compute Service (ECS) pour vous avertir 5 minutes avant la libération de l'instance. Les instances préemptibles sont facturées à la seconde. Nous vous recommandons de spécifier une période de protection adaptée à vos besoins métier. Remarque Si vous définissez SpotStrategy sur SpotWithPriceLimit ou SpotAsPriceGo, ce paramètre prend effet.
IoOptimized	String	No	optimized	Indique si l'instance est optimisée pour les E/S. Valeurs possibles : optimized : L'instance est optimisée pour les E/S. none : L'instance n'est pas optimisée pour les E/S. Pour les familles d'instances de première génération, la valeur par défaut est none. Pour les autres familles d'instances, la valeur par défaut est optimized.
StartTime	String	No	2017-08-22T08:45:08Z	Le début de la plage de temps à interroger. Spécifiez l'heure selon la norme ISO 8601 au format `yyyy-MM-ddTHH:mm:ssZ`. L'heure doit être exprimée en UTC. Par défaut, ce paramètre est vide. Dans ce cas, l'heure utilisée correspond à celle spécifiée par EndTime moins 3 heures.
EndTime	String	No	2017-08-22T08:45:08Z	L'heure de fin de la requête. Spécifiez l'heure selon la norme ISO 8601 au format `yyyy-MM-ddTHH:mm:ssZ`. L'heure doit être exprimée en UTC. Par défaut, ce paramètre est vide. Dans ce cas, l'heure actuelle est utilisée.
OSType	String	No	linux	Le type de système d'exploitation. Valeurs possibles : linux windows
Offset	Integer	No	0	La ligne à partir de laquelle la requête commence. Valeur par défaut : 0.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	L'ID de la requête.
Currency	String	CNY	L'unité monétaire du prix. Site Alibaba Cloud Chine (aliyun.com) : CNY Site Alibaba Cloud International (alibabacloud.com) : USD.
NextOffset	Integer	1000	La ligne de début de la page suivante. Il s'agit de la valeur de `Offset`.
SpotPrices	Array of SpotPriceType		Les détails des prix spot.
SpotPriceType
IoOptimized	String	optimized	Indique si l'instance préemptible est optimisée pour les E/S.
ZoneId	String	cn-hangzhou-c	L'ID de zone de l'instance préemptible.
SpotPrice	Float	0.036	Le prix spot de l'instance préemptible.
Timestamp	String	2019-11-19T06:00:00Z	L'heure correspondant au prix spot interrogé. L'heure suit la norme ISO 8601 au format `YYYY-MM-DDThh:mm:ss`. L'heure est affichée en UTC.
NetworkType	String	vpc	Le type de réseau de l'instance préemptible.
InstanceType	String	ecs.g5.large	Le type d'instance de l'instance préemptible.
OriginPrice	Float	0.354	Le prix d'une instance à la demande ayant la même configuration que l'instance préemptible spécifiée.

Exemples

Exemples de requêtes

https://ecs.aliyuncs.com/?Action=DescribeSpotPriceHistory
&NetworkType=vpc
&RegionId=cn-hangzhou
&InstanceType=ecs.g5.large
&StartTime=2019-11-19T00:00:00Z
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<DescribeSpotPriceHistoryResponse>
    <RequestId>5E2D59BA-4EB0-45C4-A0D7-D98C1A4B320B</RequestId>
    <SpotPrices>
        <SpotPriceType>
            <IoOptimized>optimized</IoOptimized>
            <OriginPrice>0.354</OriginPrice>
            <NetworkType>vpc</NetworkType>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <Timestamp>2019-11-19T06:00:00Z</Timestamp>
            <SpotPrice>0.036</SpotPrice>
            <InstanceType>ecs.g5.large</InstanceType>
        </SpotPriceType>
        <SpotPriceType>
            <IoOptimized>optimized</IoOptimized>
            <OriginPrice>0.354</OriginPrice>
            <NetworkType>vpc</NetworkType>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <Timestamp>2019-11-19T07:00:00Z</Timestamp>
            <SpotPrice>0.036</SpotPrice>
            <InstanceType>ecs.g5.large</InstanceType>
        </SpotPriceType>
    </SpotPrices>
    <Currency>CNY</Currency>
</DescribeSpotPriceHistoryResponse>

JSON format

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

{
  "RequestId" : "5E2D59BA-4EB0-45C4-A0D7-D98C1A4B320B",
  "SpotPrices" : {
    "SpotPriceType" : [ {
      "IoOptimized" : "optimized",
      "OriginPrice" : 0.354,
      "NetworkType" : "vpc",
      "ZoneId" : "cn-hangzhou-g",
      "Timestamp" : "2019-11-19T06:00:00Z",
      "SpotPrice" : 0.036,
      "InstanceType" : "ecs.g5.large"
    }, {
      "IoOptimized" : "optimized",
      "OriginPrice" : 0.354,
      "NetworkType" : "vpc",
      "ZoneId" : "cn-hangzhou-g",
      "Timestamp" : "2019-11-19T07:00:00Z",
      "SpotPrice" : 0.036,
      "InstanceType" : "ecs.g5.large"
    } ]
  },
  "Currency" : "CNY"
}

Codes d'erreur

HttpCode	Error code	Error message	Description
400	MissingParameter	%s	Un paramètre requis n'est pas spécifié.
400	UnsupportedParameter	%s	Un paramètre spécifié n'est pas pris en charge.
400	InvalidParameter	%s	Valeur de paramètre non valide.
400	InvalidInstanceID.Malformed	%s	Format InstanceId non valide.
400	InvalidParams.StartTime	%s	Valeur StartTime non valide.
400	InvalidParams.EndTime	%s	Le paramètre EndTime spécifié n'est pas valide.
400	Abs.Abs.InvalidSpotInstanceUID	%s	Le format de l'ID d'instance préemptible n'est pas valide.
400	InvalidParams.NetworkType	%s	Valeur NetworkType non valide.
400	InvalidParams.IoOptimized	%s	Valeur IoOptimized non valide.
400	InvalidParams.OSType	%s	Le paramètre OSType spécifié n'est pas valide.
400	Abs.IoOptimized.ValueNotSupported	%s	L'attribut d'optimisation des E/S de l'instance n'est pas valide. Vérifiez si la valeur IoOptimized spécifiée est valide.
400	InvalidZoneId.NotFound	The specified zone does not exist.	Valeur ZoneId non valide.
400	InvalidParams.ZoneId	%s	Valeur ZoneId non valide.
400	InvalidParams.RegionId	%s	Valeur RegionId non valide.
400	InvalidParams.InstanceType	%s	Valeur InstanceType non valide.
400	InvalidParams.PageSize	%s	Valeur PageSize non valide.
400	InvalidParams.Offset	%s	Valeur Offset non valide.
400	InvalidInstanceType.ValueNotSupported	%s	Le type d'instance ne prend pas en charge cette opération.
400	DependencyViolation.IoOptimized	The specified instancetype must be IoOptimized instance.	Le type d'instance spécifié doit être optimisé pour les E/S.
400	InvalidSpotDuration	The specified SpotDuration is not valid.	Valeur SpotDuration non valide.
403	InvalidUserType.NotSupported	%s	Le compte ne prend pas en charge cette opération.
403	Abs.InvalidAccount.NotFound	%s	Votre compte Alibaba Cloud n'existe pas ou votre paire AccessKey a expiré.
403	Forbedden.NotSupportRAM	%s	Les utilisateurs Resource Access Management (RAM) n'ont pas les autorisations nécessaires pour effectuer cette opération.
403	Forbbiden.SubUser	%s	Vous n'avez pas l'autorisation d'accéder à la ressource. Contactez le propriétaire du compte Alibaba Cloud pour demander les autorisations requises.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.