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.

Note:

For .NET Core and PCL 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 abstract 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. If your account supports EC2-Classic, Amazon EC2 launches the instances in EC2-Classic in the specified Availability Zone.

To create a one-time Spot Instance request


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 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

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also