|« PreviousNext »|
|Did this page help you? Yes | No | Tell us about it...|
Describes the Spot Instance requests that belong to your account. 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.
One or more Spot Instance request IDs.
The name of a filter. See the Supported Filters section for a list of supported filter names.
A value for the filter. See the Supported Filters section for a list of supported values for each filter.
You can specify filters so that the response includes information for only certain Spot Instance requests. For example, you can use a filter to specify that you're interested in requests where the Spot Price is a specific value. (You can't use a greater than or less than comparison, however you can use * and ? wildcards.) You can specify multiple values for a filter. The response includes information for a Spot Instance request only if it matches at least one of the filter values that you specified.
You can specify multiple filters; for example, specify that the Spot Price is a specific value, and that the instance type is m1.small. The response includes information for a request only if it matches all the filters that you specified. If there's no match, no special message is returned, the response is simply empty.
You can use wildcards in a filter value. An asterisk (*) matches zero or more characters, and a question mark (?) matches exactly one character. You can escape special characters using a backslash (\) before the character. For example, a value of
\*amazon\?\\ searches for the literal string
The following are the available filters.
The 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.
The time stamp when the Spot Instance request was created.
The fault code related to the request.
The fault message related to the request.
The ID of the instance that fulfilled the request.
The Spot Instance launch group. Launch groups are Spot Instances that launch together and terminate together.
Whether the Amazon EBS volume is deleted on instance termination.
The device name (for example, /dev/sdh) for the Amazon EBS volume.
The ID of the snapshot used for the Amazon EBS volume.
The volume size of the Amazon EBS volume, in GiB.
The volume type of the Amazon EBS volume.
The security group for the instance.
The ID of the AMI.
The type of instance (for example,
The kernel ID.
The name of the key pair the instance launched with.
Whether monitoring is enabled for the Spot Instance.
The RAM disk ID.
The ID of the network interface.
The index of the device for the network interface attachment on the instance.
The ID of the subnet for the instance.
A description of the network interface.
The primary private IP address of the network interface.
Indicates whether the network interface is deleted when the instance is terminated.
The ID of the security group associated with the network interface.
The name of the security group associated with the network interface.
Indicates whether the IP address is the primary private IP address.
The product description associated with the instance.
The Spot Instance request ID.
The maximum hourly price for any Spot Instance launched to fulfill the request.
The state of the Spot Instance request. Spot bid status information can help you track your Amazon EC2 Spot Instance requests. For information, see Tracking Spot Requests with Bid Status Codes in the Amazon Elastic Compute Cloud User Guide.
The short code describing the most recent evaluation of your Spot Instance request. For more information, see Spot Bid Status in the Amazon Elastic Compute Cloud User Guide.
The message explaining the status of the Spot Instance request.
The 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 is X, see the
For more information about tags, see Tagging Your Resources in the Amazon Elastic Compute Cloud User Guide.
The value of a tag assigned to the resource. This filter is independent of the
Filters the response based on a specific tag/value combination.
Example: To list just the resources that have been assigned tag Purpose=X, specify:
Example: To list just resources that have been assigned tag Purpose=X OR Purpose=Y, specify:
The type of Spot Instance request.
The Availability Zone in which the bid is launched.
The start date of the request.
The end date of the request.
The following elements are returned in a
This example returns information about current Spot Instance requests.
This example describes all persistent Spot Instance requests that have resulted in the launch of at least one m1.small instance, that has been fulfilled in the us-east-1a Availability Zone, and that also has monitoring enabled.
You can use
DescribeSpotInstanceRequests to find a
running Spot Instance by examining the response. If the
the Spot Instance is
appear in the response and contain the identifier of the instance.
Alternatively, you can use DescribeInstances and use a filter to
look for instances where
spot. The following is an example request.
The following is an example response.