ec2-describe-spot-instance-requests

availability-zone-group

Availability Zone group. If you specify the same Availability Zone group for all Spot Instance requests, all Spot Instances are launched in the same Availability Zone.

Type: String

create-time

Time stamp when the Spot Instance request was created.

Type: String

fault-code

Fault code related to the request.

Type: String

fault-message

Fault message related to the request.

Type: String

instance-id

ID of the instance that fulfilled the request.

Type: String

launch-group

Spot Instance launch group. Launch groups are Spot Instances that launch together and terminate together.

Type: String

launch.block-device-mapping.delete-on-termination

Whether an Amazon EBS volume mapped to the instance is deleted on instance termination.

Type: Boolean

launch.block-device-mapping.device-name

Device name (e.g., /dev/sdh) for an Amazon EBS volume mapped to the instance.

Type: String

launch.block-device-mapping.snapshot-id

ID for a snapshot mapped to the instance.

Type: String

launch.block-device-mapping.volume-size

Size of an Amazon EBS volume mapped to the instance (in GiB).

Type: String

launch.group-id

A security group the instance is in.

Type: String

launch.image-id

The AMI ID.

Type: String

launch.instance-type

Type of instance (e.g., m1.small).

Type: String

launch.kernel-id

Kernel ID.

Type: String

launch.key-name

Name of the key pair the instance launched with.

Type: String

launch.monitoring-enabled

Whether monitoring is enabled for the Spot Instance.

Type: Boolean

launch.ramdisk-id

RAM disk ID.

Type: String

product-description

Product description associated with the instance.

Type: String

Valid Values: Linux/UNIX | Windows

spot-instance-request-id

Spot Instance request ID.

Type: String

spot-price

Maximum hourly price for any Spot Instance launched to fulfill the request.

Type: String

state

State of the Spot Instance request.

Type: String

Valid Values: active | cancelled | open | closed | failed

tag-key

Key of a tag assigned to the resource. This filter is independent of the tag-value filter. For example, if you use both the filter tag-key=Purpose and the filter tag-value=X, you get any resources assigned both the tag key Purpose (regardless of what the tag's value is), and the tag value X (regardless of what the tag's key is). If you want to list only resources where Purpose=X, see the tag:key filter later in this table.

For more information about tags, go to Using Tags in the Amazon Elastic Compute Cloud User Guide.

Type: String

tag-value

Value of a tag assigned to the resource. This filter is independent of the tag-key filter.

Type: String

tag:key

Filters the results based on a specific tag/value combination.

Example: To list just the resources assigned tag Purpose=X, then specify:

--filter tag:Purpose=X

Example: To list just resources assigned tag Purpose=X OR Purpose=Y, then specify:

--filter tag:Purpose=X --filter tag:Purpose=Y

type

Type of Spot Instance request.

Type: String

Valid Values: one-time | persistent

launched-availability-zone

The Availability Zone in which the bid is launched.

Type: String

Valid Values: us-east-1a, etc.

valid-from

Start date of the request.

Type: xsd:dateTime

valid-until

End date of the request.

Type: xsd:dateTime

request_id

Specifies the ID of the Spot Instance request.

Type: String

Default: None

Example: sir-8456a32b

No

--filter name=value

A filter for limiting the results. See the preceding table for a list of allowed filter names and values. If you're using the command line tools on a Windows system, you might need to use quotation marks (i.e., "name=value").

Type: String

Default: Describes all Spot Instance requests you own, or those otherwise specified.

Example: --filter "tag-key=Production"

No

--region REGION

Overrides the Region specified in the EC2_URL environment variable and the URL specified by the -U option.

Default: The EC2_URL environment variable, or us-east-1 if the environment variable is not set.

Example: --region eu-west-1

-U, --url URL

URL is the uniform resource locator of the Amazon EC2 web service entry point.

Default: The EC2_URL environment variable, or https://ec2.amazonaws.com if the environment variable is not set.

Example: -U https://ec2.amazonaws.com

-K, --private-key EC2-PRIVATE-KEY

The private key to use when constructing requests to Amazon EC2.

Default: The value of the EC2_PRIVATE_KEY environment variable.

Example: -K pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem

-C, --cert EC2-CERT

The X.509 certificate to use when constructing requests to Amazon EC2.

Default: The value of the EC2_CERT environment variable.

Example: -C cert-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem

--connection-timeout TIMEOUT

Specifies a connection timeout (in seconds).

Example: --connection-timeout 30

--request-timeout TIMEOUT

Specifies a request timeout (in seconds).

Example: --request-timeout 45

-v, --verbose

Displays verbose output by showing the SOAP request and response on the command line. This is particularly useful if you are building tools to talk directly to our SOAP API.

-H, --headers

Displays column headers in the output.

--show-empty-fields

Shows empty columns as (nil).

--hide-tags

Do not display tags for tagged resources.

--debug

Prints internal debugging information. This is useful to assist us when troubleshooting problems.

-?, --help, -h

Displays Help.

-

If - is specified as an argument to one of the parameters, a list of arguments is read from standard input. This is useful for piping the output of one command into the input of another.

Example: ec2-describe-instances | grep stopped | cut -f 2 | ec2-start-instances -