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.

Container for the parameters to the ModifySpotFleetRequest operation. Modifies the specified Spot fleet request.

While the Spot fleet request is being modified, it is in the modifying state.

To scale up your Spot fleet, increase its target capacity. The Spot fleet launches the additional Spot instances according to the allocation strategy for the Spot fleet request. If the allocation strategy is lowestPrice, the Spot fleet launches instances using the Spot pool with the lowest price. If the allocation strategy is diversified, the Spot fleet distributes the instances across the Spot pools.

To scale down your Spot fleet, decrease its target capacity. First, the Spot fleet cancels any open bids that exceed the new target capacity. You can request that the Spot fleet terminate Spot instances until the size of the fleet no longer exceeds the new target capacity. If the allocation strategy is lowestPrice, the Spot fleet terminates the instances with the highest price per unit. If the allocation strategy is diversified, the Spot fleet terminates instances across the Spot pools. Alternatively, you can request that the Spot fleet keep the fleet at its current size, but not replace any Spot instances that are interrupted or that you terminate manually.

Inheritance Hierarchy

System.Object
  Amazon.Runtime.AmazonWebServiceRequest
    Amazon.EC2.AmazonEC2Request
      Amazon.EC2.Model.ModifySpotFleetRequestRequest

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

Syntax

C#
public class ModifySpotFleetRequestRequest : AmazonEC2Request
         IAmazonWebServiceRequest

The ModifySpotFleetRequestRequest type exposes the following members

Constructors

Properties

NameTypeDescription
Public Property ExcessCapacityTerminationPolicy Amazon.EC2.ExcessCapacityTerminationPolicy

Gets and sets the property ExcessCapacityTerminationPolicy.

Indicates whether running Spot instances should be terminated if the target capacity of the Spot fleet request is decreased below the current size of the Spot fleet.

Public Property SpotFleetRequestId System.String

Gets and sets the property SpotFleetRequestId.

The ID of the Spot fleet request.

Public Property TargetCapacity System.Int32

Gets and sets the property TargetCapacity.

The size of the fleet.

Examples

This example increases the target capacity of the specified Spot fleet request.

To increase the target capacity of a Spot fleet request


var response = client.ModifySpotFleetRequest(new ModifySpotFleetRequestRequest 
{
    SpotFleetRequestId = "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
    TargetCapacity = 20
});

bool return = response.Return;

            

This example decreases the target capacity of the specified Spot fleet request without terminating any Spot Instances as a result.

To decrease the target capacity of a Spot fleet request


var response = client.ModifySpotFleetRequest(new ModifySpotFleetRequestRequest 
{
    ExcessCapacityTerminationPolicy = "NoTermination ",
    SpotFleetRequestId = "sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE",
    TargetCapacity = 10
});

bool return = response.Return;

            

Version Information

.NET Standard:
Supported in: 1.3

.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