DescribeSpotPriceHistory - Elastic Compute Service - Centre de documentation Alibaba Cloud

Consulte les prix historiques des instances spot. Vous pouvez interroger les données de prix des 30 derniers jours. Les données de prix historiques vous aident à définir un prix maximum raisonnable pour une instance spot.

Description de l'opération

Seules les instances spot optimisées pour les E/S sont prises en charge.
Les données renvoyées par cette opération peuvent être paginées. Si la réponse contient le paramètre NextOffset, définissez le paramètre de requête Offset sur la valeur de NextOffset pour interroger la page de données suivante.

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 de l'instance. Vous pouvez appeler DescribeRegions pour consulter la liste des régions la plus récente.	cn-hangzhou
RegionId	string	Oui	L'identifiant de la région de l'instance. Vous pouvez appeler DescribeRegions pour consulter la liste des régions la plus récente.	cn-hangzhou
ZoneId	string	Non	L'identifiant de la zone.	cn-hangzhou-g
NetworkType	string	Oui	Le type de réseau de l'instance spot. Valeurs valides : vpc : réseau privé virtuel (VPC). classic : réseau classique. Cette fonctionnalité a été retirée. Pour plus d'informations, consultez Avis de retrait.	vpc
InstanceType	string	Oui	Le type de l'instance.	ecs.t1.xsmall
SpotDuration	integer	Non	La période de protection de l'instance spot. Unité : heures. Valeur par défaut : 1. Valeurs valides : 1 : après la création d'une instance spot, Alibaba Cloud garantit que l'instance ne sera pas libérée automatiquement dans l'heure qui suit. Après 1 heure, le système compare le prix de l'offre au prix du marché et vérifie le stock de ressources pour déterminer s'il faut conserver ou libérer automatiquement l'instance. 0 : après la création d'une instance spot, Alibaba Cloud ne garantit pas que l'instance restera en cours d'exécution pendant 1 heure. Le système compare le prix de l'offre au prix du marché et vérifie le stock de ressources pour déterminer s'il faut conserver ou libérer automatiquement l'instance. Alibaba Cloud envoie une notification d'événement système ECS 5 minutes avant la libération de l'instance. Les instances spot sont facturées à la seconde. Spécifiez une période de protection appropriée en fonction de la durée d'exécution prévue de la tâche. Remarque Ce paramètre prend effet uniquement lorsque SpotStrategy est défini sur SpotWithPriceLimit ou SpotAsPriceGo.	1
IoOptimized	string	Non	Indique si l'instance spot est optimisée pour les E/S. Valeurs valides : optimized : l'instance spot est une instance optimisée pour les E/S. none : l'instance spot n'est pas une instance optimisée pour les E/S. Valeur par défaut pour les familles d'instances de génération I : none. Valeur par défaut pour les autres familles d'instances : optimized.	optimized
StartTime	string	Non	Le début de la plage horaire pour interroger les prix historiques des instances spot. La plage horaire maximale entre l'heure de début et l'heure de fin est de 30 jours. Spécifiez l'heure selon la norme ISO 8601 au format `yyyy-MM-ddTHH:mm:ssZ`. L'heure doit être en UTC. Valeur par défaut : null, ce qui indique 3 heures avant l'heure de fin.	2017-08-22T08:45:08Z
EndTime	string	Non	La fin de la plage horaire pour interroger les prix historiques des instances spot. Spécifiez l'heure selon la norme ISO 8601 au format `yyyy-MM-ddTHH:mm:ssZ`. L'heure doit être en UTC. Valeur par défaut : null, ce qui indique l'heure actuelle.	2017-08-22T08:45:08Z
OSType	string	Non	Le type de plateforme du système d'exploitation. Valeurs valides : linux. windows.	linux
Offset	integer	Non	La ligne à partir de laquelle la requête commence. Valeur par défaut : 0.	0

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Currency	string	L'unité monétaire du prix. Site Chine : CNY. Site international : USD.	CNY
NextOffset	integer	La ligne de début de la page suivante. Définissez le paramètre `Offset` sur cette valeur pour interroger la page de données suivante.	1000
SpotPrices	object
SpotPriceType	array<object>	Les détails des prix spot.
	object
IoOptimized	string	Indicates whether the spot instance is an I/O optimization instance.	optimized
ZoneId	string	The zone ID of the spot instance.	cn-hangzhou-c
SpotPrice	number	The price of the spot instance.	0.036
Timestamp	string	The timestamp of the price in the `yyyy-MM-ddTHH:mm:ssZ` format.	2019-11-19T06:00:00Z
NetworkType	string	The network type of the spot instance.	vpc
InstanceType	string	The instance type of the spot instance.	ecs.g5.large
OriginPrice	number	The original price of the pay-as-you-go instance.	0.354

Exemples

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Currency": "CNY",
  "NextOffset": 1000,
  "SpotPrices": {
    "SpotPriceType": [
      {
        "IoOptimized": "optimized",
        "ZoneId": "cn-hangzhou-c",
        "SpotPrice": 0.036,
        "Timestamp": "2019-11-19T06:00:00Z",
        "NetworkType": "vpc",
        "InstanceType": "ecs.g5.large",
        "OriginPrice": 0.354
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	MissingParameter	%s	A parameter is not specified.
400	UnsupportedParameter	%s	The parameter is not supported.
400	InvalidParameter	%s	The specified parameter is invalid.
400	InvalidInstanceID.Malformed	%s	The specified InstanceId parameter is invalid.
400	InvalidParams.StartTime	%s	The specified StartTime parameter is invalid.
400	InvalidParams.EndTime	%s	The specified EndTime parameter is invalid.
400	Abs.Abs.InvalidSpotInstanceUID	%s	The preemptible instance ID is invalid.
400	InvalidParams.NetworkType	%s	The specified NetworkType parameter is invalid.
400	InvalidParams.IoOptimized	%s	The specified IoOptimized parameter is invalid.
400	InvalidParams.OSType	%s	The specified OSType parameter is invalid.
400	Abs.IoOptimized.ValueNotSupported	%s	The I/O optimization attribute of the instance is invalid. Check whether the specified IoOptimized parameter is valid.
400	InvalidZoneId.NotFound	The specified zone does not exist.	The specified zone ID does not exist.
400	InvalidParams.ZoneId	%s	The specified ZoneId parameter is invalid.
400	InvalidParams.RegionId	%s	The specified RegionId parameter is invalid.
400	InvalidParams.InstanceType	%s	The specified InstanceType parameter is invalid.
400	InvalidParams.PageSize	%s	The specified PageSize parameter is invalid.
400	InvalidParams.Offset	%s	The specified Offset parameter is invalid.
400	InvalidInstanceType.ValueNotSupported	%s	The operation is not supported by the specified instance type.
400	DependencyViolation.IoOptimized	The specified instancetype must be IoOptimized instance.	The specified instance type must be I/O optimized. Check your instance type and try again.
400	InvalidSpotDuration	The specified SpotDuration is not valid.	The specified SpotDuration parameter is invalid.
400	OperationDenied.QueryFail	Query spot price fail, please retry later.
403	InvalidUserType.NotSupported	%s	Your account does not support this operation.
403	Abs.InvalidAccount.NotFound	%s	Your Alibaba Cloud account does not exist or your AccessKey pair has expired.
403	Forbedden.NotSupportRAM	%s	RAM users are not authorized to perform this operation.
403	Forbbiden.SubUser	%s	You are not authorized to manage this resource. Contact the owner of the Alibaba Cloud account for authorization.
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.

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

Notes de version

Consultez Notes de version pour la liste complète.