AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Container for the parameters to the DescribeSpotPriceHistory operation. Describes the Spot price history. For more information, see Spot Instance Pricing History in the Amazon Elastic Compute Cloud User Guide.

When you specify a start and end time, this operation returns 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.

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonWebServiceRequest
    Amazon.EC2.AmazonEC2Request
      Amazon.EC2.Model.DescribeSpotPriceHistoryRequest

Namespace: Amazon.EC2.Model
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z

Syntax

C#
public class DescribeSpotPriceHistoryRequest : AmazonEC2Request
         IAmazonWebServiceRequest

The DescribeSpotPriceHistoryRequest type exposes the following members

Constructors

Properties

NameTypeDescription
Public Property AvailabilityZone System.String

Gets and sets the property AvailabilityZone.

Filters the results by the specified Availability Zone.

Public Property EndTime System.DateTime

Gets and sets the property EndTime.

The date and time, up to the current date, from which to stop retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

Public Property Filters System.Collections.Generic.List<Amazon.EC2.Model.Filter>

Gets and sets the property Filters.

One or more filters.

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

  • instance-type - The type of instance (for example, m3.medium).

  • 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, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). You can use wildcards (* and ?). Greater than or less than comparison is not supported.

Public Property InstanceTypes System.Collections.Generic.List<System.String>

Gets and sets the property InstanceTypes.

Filters the results by the specified instance types. Note that T2 and HS1 instance types are not supported.

Public Property MaxResults System.Int32

Gets and sets the property MaxResults.

The maximum number of results to return in a single call. Specify a value between 1 and 1000. The default value is 1000. To retrieve the remaining results, make another call with the returned NextToken value.

Public Property NextToken System.String

Gets and sets the property NextToken.

The token for the next set of results.

Public Property ProductDescriptions System.Collections.Generic.List<System.String>

Gets and sets the property ProductDescriptions.

Filters the results by the specified basic product descriptions.

Public Property StartTime System.DateTime

Gets and sets the property StartTime.

The date and time, up to the past 90 days, from which to start retrieving the price history data, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

Examples

This example returns the Spot Price history for m1.xlarge, Linux/UNIX (Amazon VPC) instances for a particular day in January.

To describe Spot price history for Linux/UNIX (Amazon VPC)


var response = client.DescribeSpotPriceHistory(new DescribeSpotPriceHistoryRequest 
{
    EndTime = new DateTime(2014, 1, 6, 8, 9, 10),
    InstanceTypes = new List {
        "m1.xlarge"
    },
    ProductDescriptions = new List {
        "Linux/UNIX (Amazon VPC)"
    },
    StartTime = new DateTime(2014, 1, 6, 7, 8, 9)
});

List spotPriceHistory = response.SpotPriceHistory;

            

Version Information

.NET Standard:
Supported in: 1.3

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms