Struct aws_sdk_ec2::client::fluent_builders::RequestSpotFleet

pub struct RequestSpotFleet { /* private fields */ }

Fluent builder constructing a request to RequestSpotFleet.

Creates a Spot Fleet request.

The Spot Fleet request specifies the total target capacity and the On-Demand target capacity. Amazon EC2 calculates the difference between the total capacity and On-Demand capacity, and launches the difference as Spot capacity.

You can submit a single request that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.

By default, the Spot Fleet requests Spot Instances in the Spot Instance pool where the price per unit is the lowest. Each launch specification can include its own instance weighting that reflects the value of the instance type to your application workload.

Alternatively, you can specify that the Spot Fleet distribute the target capacity across the Spot pools included in its launch specifications. By ensuring that the Spot Instances in your Spot Fleet are in different Spot pools, you can improve the availability of your fleet.

You can specify tags for the Spot Fleet request and instances launched by the fleet. You cannot tag other resource types in a Spot Fleet request because only the spot-fleet-request and instance resource types are supported.

For more information, see Spot Fleet requests in the Amazon EC2 User Guide.

We strongly discourage using the RequestSpotFleet 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.

Implementations

impl RequestSpotFleet

pub async fn customize(
    self
) -> Result<CustomizableOperation<RequestSpotFleet, AwsResponseRetryClassifier>, SdkError<RequestSpotFleetError>>

Consume this builder, creating a customizable operation that can be modified before being sent. The operation’s inner http::Request can be modified as well.

pub async fn send(
    self
) -> Result<RequestSpotFleetOutput, SdkError<RequestSpotFleetError>>

Sends the request and returns the response.

If an error occurs, an SdkError will be returned with additional details that can be matched against.

By default, any retryable failures will be retried twice. Retry behavior is configurable with the RetryConfig, which can be set when configuring the client.

pub fn dry_run(self, input: bool) -> Self

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

pub fn set_dry_run(self, input: Option<bool>) -> Self

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

pub fn spot_fleet_request_config(self, input: SpotFleetRequestConfigData) -> Self

The configuration for the Spot Fleet request.

pub fn set_spot_fleet_request_config(
    self,
    input: Option<SpotFleetRequestConfigData>
) -> Self

The configuration for the Spot Fleet request.

Trait Implementations

impl Clone for RequestSpotFleet

fn clone(&self) -> RequestSpotFleet

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RequestSpotFleet

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.