1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::modify_spot_fleet_request::_modify_spot_fleet_request_output::ModifySpotFleetRequestOutputBuilder;
pub use crate::operation::modify_spot_fleet_request::_modify_spot_fleet_request_input::ModifySpotFleetRequestInputBuilder;
/// Fluent builder constructing a request to `ModifySpotFleetRequest`.
///
/// <p>Modifies the specified Spot Fleet request.</p>
/// <p>You can only modify a Spot Fleet request of type <code>maintain</code>.</p>
/// <p>While the Spot Fleet request is being modified, it is in the <code>modifying</code> state.</p>
/// <p>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 <code>lowestPrice</code>, the Spot Fleet launches instances using the Spot Instance pool with the lowest price. If the allocation strategy is <code>diversified</code>, the Spot Fleet distributes the instances across the Spot Instance pools. If the allocation strategy is <code>capacityOptimized</code>, Spot Fleet launches instances from Spot Instance pools with optimal capacity for the number of instances that are launching.</p>
/// <p>To scale down your Spot Fleet, decrease its target capacity. First, the Spot Fleet cancels any open requests 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 <code>lowestPrice</code>, the Spot Fleet terminates the instances with the highest price per unit. If the allocation strategy is <code>capacityOptimized</code>, the Spot Fleet terminates the instances in the Spot Instance pools that have the least available Spot Instance capacity. If the allocation strategy is <code>diversified</code>, the Spot Fleet terminates instances across the Spot Instance 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.</p>
/// <p>If you are finished with your Spot Fleet for now, but will use it again later, you can set the target capacity to 0.</p>
#[derive(std::clone::Clone, std::fmt::Debug)]
pub struct ModifySpotFleetRequestFluentBuilder {
handle: std::sync::Arc<crate::client::Handle>,
inner:
crate::operation::modify_spot_fleet_request::builders::ModifySpotFleetRequestInputBuilder,
}
impl ModifySpotFleetRequestFluentBuilder {
/// Creates a new `ModifySpotFleetRequest`.
pub(crate) fn new(handle: std::sync::Arc<crate::client::Handle>) -> Self {
Self {
handle,
inner: Default::default(),
}
}
/// 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 customize(
self,
) -> std::result::Result<
crate::client::customize::CustomizableOperation<
crate::operation::modify_spot_fleet_request::ModifySpotFleetRequest,
aws_http::retry::AwsResponseRetryClassifier,
>,
aws_smithy_http::result::SdkError<
crate::operation::modify_spot_fleet_request::ModifySpotFleetRequestError,
>,
> {
let handle = self.handle.clone();
let operation = self
.inner
.build()
.map_err(aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&handle.conf)
.await
.map_err(aws_smithy_http::result::SdkError::construction_failure)?;
Ok(crate::client::customize::CustomizableOperation { handle, operation })
}
/// 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](aws_smithy_types::retry::RetryConfig), which can be
/// set when configuring the client.
pub async fn send(
self,
) -> std::result::Result<
crate::operation::modify_spot_fleet_request::ModifySpotFleetRequestOutput,
aws_smithy_http::result::SdkError<
crate::operation::modify_spot_fleet_request::ModifySpotFleetRequestError,
>,
> {
let op = self
.inner
.build()
.map_err(aws_smithy_http::result::SdkError::construction_failure)?
.make_operation(&self.handle.conf)
.await
.map_err(aws_smithy_http::result::SdkError::construction_failure)?;
self.handle.client.call(op).await
}
/// <p>Indicates whether running instances should be terminated if the target capacity of the Spot Fleet request is decreased below the current size of the Spot Fleet.</p>
/// <p>Supported only for fleets of type <code>maintain</code>.</p>
pub fn excess_capacity_termination_policy(
mut self,
input: crate::types::ExcessCapacityTerminationPolicy,
) -> Self {
self.inner = self.inner.excess_capacity_termination_policy(input);
self
}
/// <p>Indicates whether running instances should be terminated if the target capacity of the Spot Fleet request is decreased below the current size of the Spot Fleet.</p>
/// <p>Supported only for fleets of type <code>maintain</code>.</p>
pub fn set_excess_capacity_termination_policy(
mut self,
input: std::option::Option<crate::types::ExcessCapacityTerminationPolicy>,
) -> Self {
self.inner = self.inner.set_excess_capacity_termination_policy(input);
self
}
/// Appends an item to `LaunchTemplateConfigs`.
///
/// To override the contents of this collection use [`set_launch_template_configs`](Self::set_launch_template_configs).
///
/// <p>The launch template and overrides. You can only use this parameter if you specified a launch template (<code>LaunchTemplateConfigs</code>) in your Spot Fleet request. If you specified <code>LaunchSpecifications</code> in your Spot Fleet request, then omit this parameter.</p>
pub fn launch_template_configs(mut self, input: crate::types::LaunchTemplateConfig) -> Self {
self.inner = self.inner.launch_template_configs(input);
self
}
/// <p>The launch template and overrides. You can only use this parameter if you specified a launch template (<code>LaunchTemplateConfigs</code>) in your Spot Fleet request. If you specified <code>LaunchSpecifications</code> in your Spot Fleet request, then omit this parameter.</p>
pub fn set_launch_template_configs(
mut self,
input: std::option::Option<std::vec::Vec<crate::types::LaunchTemplateConfig>>,
) -> Self {
self.inner = self.inner.set_launch_template_configs(input);
self
}
/// <p>The ID of the Spot Fleet request.</p>
pub fn spot_fleet_request_id(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.spot_fleet_request_id(input.into());
self
}
/// <p>The ID of the Spot Fleet request.</p>
pub fn set_spot_fleet_request_id(
mut self,
input: std::option::Option<std::string::String>,
) -> Self {
self.inner = self.inner.set_spot_fleet_request_id(input);
self
}
/// <p>The size of the fleet.</p>
pub fn target_capacity(mut self, input: i32) -> Self {
self.inner = self.inner.target_capacity(input);
self
}
/// <p>The size of the fleet.</p>
pub fn set_target_capacity(mut self, input: std::option::Option<i32>) -> Self {
self.inner = self.inner.set_target_capacity(input);
self
}
/// <p>The number of On-Demand Instances in the fleet.</p>
pub fn on_demand_target_capacity(mut self, input: i32) -> Self {
self.inner = self.inner.on_demand_target_capacity(input);
self
}
/// <p>The number of On-Demand Instances in the fleet.</p>
pub fn set_on_demand_target_capacity(mut self, input: std::option::Option<i32>) -> Self {
self.inner = self.inner.set_on_demand_target_capacity(input);
self
}
/// <p>Reserved.</p>
pub fn context(mut self, input: impl Into<std::string::String>) -> Self {
self.inner = self.inner.context(input.into());
self
}
/// <p>Reserved.</p>
pub fn set_context(mut self, input: std::option::Option<std::string::String>) -> Self {
self.inner = self.inner.set_context(input);
self
}
}