AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates a Spot Instance request.

For more information, see Spot Instance requests in the Amazon EC2 User Guide for Linux Instances.

We strongly discourage using the RequestSpotInstances API because it is a legacy API with no planned investment. For options for requesting Spot Instances, see Which is the best Spot request method to use? in the Amazon EC2 User Guide for Linux Instances.

Note:

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

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

Syntax

C#
public virtual RequestSpotInstancesResponse RequestSpotInstances(
         RequestSpotInstancesRequest request
)

Parameters

request
Type: Amazon.EC2.Model.RequestSpotInstancesRequest

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

Return Value


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

Examples

This example creates a one-time Spot Instance request for five instances in the specified Availability Zone. If your account supports EC2-VPC only, Amazon EC2 launches the instances in the default subnet of the specified Availability Zone.

To create a one-time Spot Instance request


var client = new AmazonEC2Client();
var response = client.RequestSpotInstances(new RequestSpotInstancesRequest 
{
    InstanceCount = 5,
    LaunchSpecification = new RequestSpotLaunchSpecification {
        IamInstanceProfile = new IamInstanceProfileSpecification { Arn = "arn:aws:iam::123456789012:instance-profile/my-iam-role" },
        ImageId = "ami-1a2b3c4d",
        InstanceType = "m3.medium",
        KeyName = "my-key-pair",
        Placement = new SpotPlacement { AvailabilityZone = "us-west-2a" },
                    
    },
    SpotPrice = "0.03",
    Type = "one-time"
});


            

This example command creates a one-time Spot Instance request for five instances in the specified subnet. Amazon EC2 launches the instances in the specified subnet. If the VPC is a nondefault VPC, the instances do not receive a public IP address by default.

To create a one-time Spot Instance request


var client = new AmazonEC2Client();
var response = client.RequestSpotInstances(new RequestSpotInstancesRequest 
{
    InstanceCount = 5,
    LaunchSpecification = new RequestSpotLaunchSpecification {
        IamInstanceProfile = new IamInstanceProfileSpecification { Arn = "arn:aws:iam::123456789012:instance-profile/my-iam-role" },
        ImageId = "ami-1a2b3c4d",
        InstanceType = "m3.medium",
        SubnetId = "subnet-1a2b3c4d"
    },
    SpotPrice = "0.050",
    Type = "one-time"
});


            

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also