aws_sdk_autoscaling/operation/rollback_instance_refresh/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::rollback_instance_refresh::_rollback_instance_refresh_output::RollbackInstanceRefreshOutputBuilder;
3
4pub use crate::operation::rollback_instance_refresh::_rollback_instance_refresh_input::RollbackInstanceRefreshInputBuilder;
5
6impl crate::operation::rollback_instance_refresh::builders::RollbackInstanceRefreshInputBuilder {
7    /// Sends a request with this input using the given client.
8    pub async fn send_with(
9        self,
10        client: &crate::Client,
11    ) -> ::std::result::Result<
12        crate::operation::rollback_instance_refresh::RollbackInstanceRefreshOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::rollback_instance_refresh::RollbackInstanceRefreshError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.rollback_instance_refresh();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `RollbackInstanceRefresh`.
24///
25/// <p>Cancels an instance refresh that is in progress and rolls back any changes that it made. Amazon EC2 Auto Scaling replaces any instances that were replaced during the instance refresh. This restores your Auto Scaling group to the configuration that it was using before the start of the instance refresh.</p>
26/// <p>This operation is part of the <a href="https://docs.aws.amazon.com/autoscaling/ec2/userguide/asg-instance-refresh.html">instance refresh feature</a> in Amazon EC2 Auto Scaling, which helps you update instances in your Auto Scaling group after you make configuration changes.</p>
27/// <p>A rollback is not supported in the following situations:</p>
28/// <ul>
29/// <li>
30/// <p>There is no desired configuration specified for the instance refresh.</p></li>
31/// <li>
32/// <p>The Auto Scaling group has a launch template that uses an Amazon Web Services Systems Manager parameter instead of an AMI ID for the <code>ImageId</code> property.</p></li>
33/// <li>
34/// <p>The Auto Scaling group uses the launch template's <code>$Latest</code> or <code>$Default</code> version.</p></li>
35/// </ul>
36/// <p>When you receive a successful response from this operation, Amazon EC2 Auto Scaling immediately begins replacing instances. You can check the status of this operation through the <a href="https://docs.aws.amazon.com/autoscaling/ec2/APIReference/API_DescribeInstanceRefreshes.html">DescribeInstanceRefreshes</a> API operation.</p>
37#[derive(::std::clone::Clone, ::std::fmt::Debug)]
38pub struct RollbackInstanceRefreshFluentBuilder {
39    handle: ::std::sync::Arc<crate::client::Handle>,
40    inner: crate::operation::rollback_instance_refresh::builders::RollbackInstanceRefreshInputBuilder,
41    config_override: ::std::option::Option<crate::config::Builder>,
42}
43impl
44    crate::client::customize::internal::CustomizableSend<
45        crate::operation::rollback_instance_refresh::RollbackInstanceRefreshOutput,
46        crate::operation::rollback_instance_refresh::RollbackInstanceRefreshError,
47    > for RollbackInstanceRefreshFluentBuilder
48{
49    fn send(
50        self,
51        config_override: crate::config::Builder,
52    ) -> crate::client::customize::internal::BoxFuture<
53        crate::client::customize::internal::SendResult<
54            crate::operation::rollback_instance_refresh::RollbackInstanceRefreshOutput,
55            crate::operation::rollback_instance_refresh::RollbackInstanceRefreshError,
56        >,
57    > {
58        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
59    }
60}
61impl RollbackInstanceRefreshFluentBuilder {
62    /// Creates a new `RollbackInstanceRefreshFluentBuilder`.
63    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
64        Self {
65            handle,
66            inner: ::std::default::Default::default(),
67            config_override: ::std::option::Option::None,
68        }
69    }
70    /// Access the RollbackInstanceRefresh as a reference.
71    pub fn as_input(&self) -> &crate::operation::rollback_instance_refresh::builders::RollbackInstanceRefreshInputBuilder {
72        &self.inner
73    }
74    /// Sends the request and returns the response.
75    ///
76    /// If an error occurs, an `SdkError` will be returned with additional details that
77    /// can be matched against.
78    ///
79    /// By default, any retryable failures will be retried twice. Retry behavior
80    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
81    /// set when configuring the client.
82    pub async fn send(
83        self,
84    ) -> ::std::result::Result<
85        crate::operation::rollback_instance_refresh::RollbackInstanceRefreshOutput,
86        ::aws_smithy_runtime_api::client::result::SdkError<
87            crate::operation::rollback_instance_refresh::RollbackInstanceRefreshError,
88            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
89        >,
90    > {
91        let input = self
92            .inner
93            .build()
94            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
95        let runtime_plugins = crate::operation::rollback_instance_refresh::RollbackInstanceRefresh::operation_runtime_plugins(
96            self.handle.runtime_plugins.clone(),
97            &self.handle.conf,
98            self.config_override,
99        );
100        crate::operation::rollback_instance_refresh::RollbackInstanceRefresh::orchestrate(&runtime_plugins, input).await
101    }
102
103    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
104    pub fn customize(
105        self,
106    ) -> crate::client::customize::CustomizableOperation<
107        crate::operation::rollback_instance_refresh::RollbackInstanceRefreshOutput,
108        crate::operation::rollback_instance_refresh::RollbackInstanceRefreshError,
109        Self,
110    > {
111        crate::client::customize::CustomizableOperation::new(self)
112    }
113    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
114        self.set_config_override(::std::option::Option::Some(config_override.into()));
115        self
116    }
117
118    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
119        self.config_override = config_override;
120        self
121    }
122    /// <p>The name of the Auto Scaling group.</p>
123    pub fn auto_scaling_group_name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
124        self.inner = self.inner.auto_scaling_group_name(input.into());
125        self
126    }
127    /// <p>The name of the Auto Scaling group.</p>
128    pub fn set_auto_scaling_group_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
129        self.inner = self.inner.set_auto_scaling_group_name(input);
130        self
131    }
132    /// <p>The name of the Auto Scaling group.</p>
133    pub fn get_auto_scaling_group_name(&self) -> &::std::option::Option<::std::string::String> {
134        self.inner.get_auto_scaling_group_name()
135    }
136}