Amazon Elastic Compute Cloud
API Reference (API Version 2014-10-01)
Did this page help you?  Yes | No |  Tell us about it...
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.

DescribeSpotPriceHistory

Describes the Spot Price history. Spot Instances are instances that Amazon EC2 starts on your behalf when the maximum price that you specify exceeds the current Spot Price. Amazon EC2 periodically sets the Spot Price based on available Spot Instance capacity and current Spot Instance requests. For more information about Spot Instances, see Spot Instances in the Amazon Elastic Compute Cloud User Guide for Linux.

When you specify an Availability Zone, this operation describes the price history for the specified Availability Zone with the most recent set of prices listed first. If you don't specify an Availability Zone, you get the prices across all Availability Zones, starting with the most recent set. However, if you're using an API version earlier than 2011-05-15, you get the lowest price across the region for the specified time period. The prices returned are listed in chronological order, from the oldest to the most recent.

When you specify the start and end time options, this operation returns two pieces of data: the prices of the instance types within the time range that you specified and the time when the price changed. The price is valid within the time period that you specified; the response merely indicates the last time that the price changed.

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters.

AvailabilityZone

The Availability Zone.

Type: String

Required: No

DryRun

Type: Boolean

Required: No

EndTime

The end date and time of the Spot Price history data.

Type: DateTime

Required: No

Filter.N

One or more filters.

  • availability-zone - The Availability Zone for which prices should be returned.

  • instance-type - The type of instance (for example, m1.small).

  • product-description - The product description for the Spot Price (Linux/UNIX | SUSE Linux | Windows | Linux/UNIX (Amazon VPC) | SUSE Linux (Amazon VPC) | Windows (Amazon VPC)).

  • spot-price - The Spot Price. The value must match exactly (or use wildcards; greater than or less than comparison is not supported).

  • timestamp - The timestamp of the Spot Price history (for example, 2010-08-16T05:06:11.000Z). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

Type: Filter list

Required: No

InstanceType.N

One or more instance types.

Type: String list

Valid Values: t1.micro | m1.small | m1.medium | m1.large | m1.xlarge | m3.medium | m3.large | m3.xlarge | m3.2xlarge | t2.micro | t2.small | t2.medium | m2.xlarge | m2.2xlarge | m2.4xlarge | cr1.8xlarge | i2.xlarge | i2.2xlarge | i2.4xlarge | i2.8xlarge | hi1.4xlarge | hs1.8xlarge | c1.medium | c1.xlarge | c3.large | c3.xlarge | c3.2xlarge | c3.4xlarge | c3.8xlarge | cc1.4xlarge | cc2.8xlarge | g2.2xlarge | cg1.4xlarge | r3.large | r3.xlarge | r3.2xlarge | r3.4xlarge | r3.8xlarge

Required: No

MaxResults

The number of rows to return.

Type: Integer

Required: No

NextToken

The next set of rows to return.

Type: String

Required: No

ProductDescription.N

One or more basic product descriptions.

Type: String list

Required: No

StartTime

The start date and time of the Spot Price history data.

Type: DateTime

Required: No

Response Elements

The following elements are returned.

nextToken

The string marking the next set of results. This is empty if there are no more results.

Type: String

requestId

The ID of the request.

Type: String

spotPriceHistorySet

The historical Spot Prices.

Type: SpotPrice list

Errors

For information about the errors that are common to all actions, see Common Client Errors.

Examples

Example

This example gets Spot Price history for a particular day in December 2009 for the specified Availability Zone.

Sample Request

https://ec2.amazonaws.com/?Action=DescribeSpotPriceHistory
&StartTime=2009-12-04T00:00:00.000Z
&EndTime=2009-12-04T23:59:59.000Z
&AvailabilityZone=us-east-1a
&AUTHPARAMS

Sample Response

<DescribeSpotPriceHistoryResponse xmlns="http://ec2.amazonaws.com/doc/2014-10-01/">
  <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
  <spotPriceHistorySet>
    <item>
      <instanceType>m1.small</instanceType>
      <productDescription>Linux/UNIX</productDescription>
      <spotPrice>0.287</spotPrice>
      <timestamp>2009-12-04T20:56:05.000Z</timestamp>
      <availabilityZone>us-east-1a</availabilityZone>
    </item>
    <item>
      <instanceType>m1.small</instanceType>
      <productDescription>Windows</productDescription>
      <spotPrice>0.033</spotPrice>
      <timestamp>2009-12-04T22:33:47.000Z</timestamp>
      <availabilityZone>us-east-1a</availabilityZone>
    </item>
  </spotPriceHistorySet>
  <nextToken/>
</DescribeSpotPriceHistoryResponse>

Example with Filters

This example uses filters to get the same results as the previous example.

Sample Request

https://ec2.amazonaws.com/?Action=DescribeSpotPriceHistory
&Filter.1.Name=timestamp
&Filter.1.Value.1=2009-12-04*
&Filter.2.Name=availability-zone
&Filter.2.Value.1=us-east-1a
&AUTHPARAMS