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.
You can filter the results to return information only about Spot Instance requests that match
criteria you specify. For example, you could get information about requests where the Spot
Price you specified is a certain value (you can’t use greater than or less than comparison, but
you can use *
and ?
wildcards). You can specify multiple values for a
filter. A Spot Instance request must match at least one of the specified values for it to be
included in the results.
You can specify multiple filters (e.g., the Spot Price is equal to a particular value, and the
instance type is m1.small
). The result includes information for a particular
request only if it matches all your filters. If there’s no match, no special message is
returned; the response is simply empty.
You can use wildcards with the filter values: an asterisk matches zero or more characters, and
?
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 *amazon?\
.
Access
public
Parameters
Parameter |
Type |
Required |
Description |
---|---|---|---|
|
Optional |
An associative array of parameters that can have the following keys:
|
Returns
Type |
Description |
---|---|
A |
Examples
Describe spot instance requests.
$ec2 = new AmazonEC2(); $response = $ec2->describe_spot_instance_requests(); var_dump($response->isOK());Result:
bool(true)
Describe spot instance requests.
$ec2 = new AmazonEC2(); $response = $ec2->describe_spot_instance_requests(array( 'Filter' => array( array('Name' => 'product-description', 'Value' => 'Linux/UNIX'), array('Name' => 'state', 'Value' => 'active' ), array('Name' => 'type', 'Value' => 'one-time' ), ) )); var_dump($response->isOK());Result:
bool(true)
Related Methods
Source
Method defined in services/ec2.class.php | Toggle source view (24 lines) | View on GitHub