AmazonEC2Client.DescribeSpotInstanceRequests Method (DescribeSpotInstanceRequestsRequest)

Describes the specified Spot Instance requests.

You can use DescribeSpotInstanceRequests to find a running Spot Instance by examining the response. If the status of the Spot Instance is fulfilled, the instance ID appears in the response and contains the identifier of the instance. Alternatively, you can use DescribeInstances with a filter to look for instances where the instance lifecycle is spot.

We recommend that you set MaxResults to a value between 5 and 1000 to limit the number of items returned. This paginates the output, which makes the list more manageable and returns the items faster. If the list of items exceeds your MaxResults value, then that number of items is returned along with a NextToken value that can be passed to a subsequent DescribeSpotInstanceRequests request to retrieve the remaining items.

Spot Instance requests are deleted four hours after they are canceled and their instances are terminated.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to DescribeSpotInstanceRequestsAsync.

Namespace: Amazon.EC2
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z

Syntax

public virtual DescribeSpotInstanceRequestsResponse DescribeSpotInstanceRequests(
         DescribeSpotInstanceRequestsRequest request
)

Parameters

request: Type: Amazon.EC2.Model.DescribeSpotInstanceRequestsRequest

Container for the necessary parameters to execute the DescribeSpotInstanceRequests service method.

Return Value

Type: DescribeSpotInstanceRequestsResponse

The response from the DescribeSpotInstanceRequests service method, as returned by EC2.

Examples

This example describes the specified Spot Instance request.

To describe a Spot Instance request


var client = new AmazonEC2Client();
var response = client.DescribeSpotInstanceRequests(new DescribeSpotInstanceRequestsRequest 
{
    SpotInstanceRequestIds = new List<string> {
        "sir-08b93456"
    }
});

List<SpotInstanceRequest> spotInstanceRequests = response.SpotInstanceRequests;

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

AmazonEC2Client.DescribeSpotInstanceRequests (DescribeSpotInstanceRequestsRequest)