
describe-spot-price-history
***************************


DESCRIPTION
===========

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 conceptual information about Spot Instances, refer to the Amazon
Elastic Compute Cloud Developer Guide  or Amazon Elastic Compute Cloud
User Guide  .


SYNOPSIS
========

   aws ec2 describe-spot-price-history
     [--availability-zone <value>]
     [--next-token <value>]
     [--start-time <value>]
     [--instance-types <value>]
     [--max-results <value>]
     [--product-descriptions <value>]
     [--filters <value>]
     [--end-time <value>]


REQUIRED PARAMETERS
===================

None


OPTIONAL PARAMETERS
===================

"--availability-zone"  (string)
   --filters the results by availability zone (ex: 'us-east-1a').

"--next-token"  (string)
   Specifies the next set of rows to return.

"--start-time"  (timestamp)
   The start date and time of the Spot Instance price history data.

"--instance-types"  (list of string)
   Specifies the instance type to return.

   *Parameter Syntax*

      ["t1.micro"|"m1.small"|"m1.medium"|"m1.large"|"m1.xlarge"|"m2.xlarge"|"m2.2x
      large"|"m2.4xlarge"|"m3.xlarge"|"m3.2xlarge"|"c1.medium"|"c1.xlarge"|"hi1.4x
      large"|"hs1.8xlarge"|"cc1.4xlarge"|"cc2.8xlarge"|"cg1.4xlarge", ...]

"--max-results"  (integer)
   Specifies the number of rows to return.

"--product-descriptions"  (list of string)
   The description of the AMI.

   *Parameter Syntax*

      ["string", ...]

"--filters"  (list)
   A list of filters used to match properties for SpotPriceHistory.
   For a complete reference to the available filter keys for this
   operation, see the Amazon EC2 API reference .

      (structure)
         A filter used to limit results when describing tags. Multiple
         values can be specified per filter. A tag must match at least
         one of the specified values for it to be returned from an
         operation.

         Wildcards can be included in filter values; "*" specifies
         that zero or more characters must match, and "?" specifies
         that exactly one character must match. Use a backslash to
         escape special characters. For example, a filter value of
         "\*amazon\?\\" specifies the literal string "*amazon?\" .

         "values"  (list of string)
            Contains one or more values for the filter.

         "name"  (string)
            Specifies the name of the filter.

   *Parameter Syntax*

      [
        {
          "values":
            ["string", ...],
          "name": "string"
        }
        ...
      ]

"--end-time"  (timestamp)
   The end date and time of the Spot Instance price history data.
