ec2-describe-spot-instance-requests

Description

Describes Spot Instance requests. 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.

Syntax

ec2-describe-spot-instance-requests [request_id [request_id...]]

Options

NameDescriptionRequired

request_id

Specifies the ID of the Spot Instance request.

Type: String

Default: None

Example: sir-8456a32b

No

Output

The command returns a table that contains the following information:

  • Request ID

  • Spot Price

  • Type

  • State

  • Fault

  • Valid From

  • Valid Until

  • Launch Group

  • Availability Zone Group

  • Launch Specification

  • Create Time

  • Description

Amazon EC2 displays errors on stderr.

Examples

Example Request

This example returns information about current Spot Instance requests.

PROMPT> ec2-describe-spot-instance-requests sir-f102a405
SPOTINSTANCEREQUEST sir-f102a405 0.1 one-time Linux/UNIX active
							2009-12-12T22:58:47+0200 i-3597b470 ami-7d3b6a38 m1.small default
							monitoring-enabled