aws_sdk_ec2/operation/detach_network_interface/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::detach_network_interface::_detach_network_interface_output::DetachNetworkInterfaceOutputBuilder;
3
4pub use crate::operation::detach_network_interface::_detach_network_interface_input::DetachNetworkInterfaceInputBuilder;
5
6impl crate::operation::detach_network_interface::builders::DetachNetworkInterfaceInputBuilder {
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::detach_network_interface::DetachNetworkInterfaceOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::detach_network_interface::DetachNetworkInterfaceError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.detach_network_interface();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `DetachNetworkInterface`.
24///
25/// <p>Detaches a network interface from an instance.</p>
26#[derive(::std::clone::Clone, ::std::fmt::Debug)]
27pub struct DetachNetworkInterfaceFluentBuilder {
28    handle: ::std::sync::Arc<crate::client::Handle>,
29    inner: crate::operation::detach_network_interface::builders::DetachNetworkInterfaceInputBuilder,
30    config_override: ::std::option::Option<crate::config::Builder>,
31}
32impl
33    crate::client::customize::internal::CustomizableSend<
34        crate::operation::detach_network_interface::DetachNetworkInterfaceOutput,
35        crate::operation::detach_network_interface::DetachNetworkInterfaceError,
36    > for DetachNetworkInterfaceFluentBuilder
37{
38    fn send(
39        self,
40        config_override: crate::config::Builder,
41    ) -> crate::client::customize::internal::BoxFuture<
42        crate::client::customize::internal::SendResult<
43            crate::operation::detach_network_interface::DetachNetworkInterfaceOutput,
44            crate::operation::detach_network_interface::DetachNetworkInterfaceError,
45        >,
46    > {
47        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
48    }
49}
50impl DetachNetworkInterfaceFluentBuilder {
51    /// Creates a new `DetachNetworkInterfaceFluentBuilder`.
52    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
53        Self {
54            handle,
55            inner: ::std::default::Default::default(),
56            config_override: ::std::option::Option::None,
57        }
58    }
59    /// Access the DetachNetworkInterface as a reference.
60    pub fn as_input(&self) -> &crate::operation::detach_network_interface::builders::DetachNetworkInterfaceInputBuilder {
61        &self.inner
62    }
63    /// Sends the request and returns the response.
64    ///
65    /// If an error occurs, an `SdkError` will be returned with additional details that
66    /// can be matched against.
67    ///
68    /// By default, any retryable failures will be retried twice. Retry behavior
69    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
70    /// set when configuring the client.
71    pub async fn send(
72        self,
73    ) -> ::std::result::Result<
74        crate::operation::detach_network_interface::DetachNetworkInterfaceOutput,
75        ::aws_smithy_runtime_api::client::result::SdkError<
76            crate::operation::detach_network_interface::DetachNetworkInterfaceError,
77            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
78        >,
79    > {
80        let input = self
81            .inner
82            .build()
83            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
84        let runtime_plugins = crate::operation::detach_network_interface::DetachNetworkInterface::operation_runtime_plugins(
85            self.handle.runtime_plugins.clone(),
86            &self.handle.conf,
87            self.config_override,
88        );
89        crate::operation::detach_network_interface::DetachNetworkInterface::orchestrate(&runtime_plugins, input).await
90    }
91
92    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
93    pub fn customize(
94        self,
95    ) -> crate::client::customize::CustomizableOperation<
96        crate::operation::detach_network_interface::DetachNetworkInterfaceOutput,
97        crate::operation::detach_network_interface::DetachNetworkInterfaceError,
98        Self,
99    > {
100        crate::client::customize::CustomizableOperation::new(self)
101    }
102    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
103        self.set_config_override(::std::option::Option::Some(config_override.into()));
104        self
105    }
106
107    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
108        self.config_override = config_override;
109        self
110    }
111    /// <p>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 <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
112    pub fn dry_run(mut self, input: bool) -> Self {
113        self.inner = self.inner.dry_run(input);
114        self
115    }
116    /// <p>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 <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
117    pub fn set_dry_run(mut self, input: ::std::option::Option<bool>) -> Self {
118        self.inner = self.inner.set_dry_run(input);
119        self
120    }
121    /// <p>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 <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.</p>
122    pub fn get_dry_run(&self) -> &::std::option::Option<bool> {
123        self.inner.get_dry_run()
124    }
125    /// <p>The ID of the attachment.</p>
126    pub fn attachment_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
127        self.inner = self.inner.attachment_id(input.into());
128        self
129    }
130    /// <p>The ID of the attachment.</p>
131    pub fn set_attachment_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
132        self.inner = self.inner.set_attachment_id(input);
133        self
134    }
135    /// <p>The ID of the attachment.</p>
136    pub fn get_attachment_id(&self) -> &::std::option::Option<::std::string::String> {
137        self.inner.get_attachment_id()
138    }
139    /// <p>Specifies whether to force a detachment.</p><note>
140    /// <ul>
141    /// <li>
142    /// <p>Use the <code>Force</code> parameter only as a last resort to detach a network interface from a failed instance.</p></li>
143    /// <li>
144    /// <p>If you use the <code>Force</code> parameter to detach a network interface, you might not be able to attach a different network interface to the same index on the instance without first stopping and starting the instance.</p></li>
145    /// <li>
146    /// <p>If you force the detachment of a network interface, the <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html">instance metadata</a> might not get updated. This means that the attributes associated with the detached network interface might still be visible. The instance metadata will get updated when you stop and start the instance.</p></li>
147    /// </ul>
148    /// </note>
149    pub fn force(mut self, input: bool) -> Self {
150        self.inner = self.inner.force(input);
151        self
152    }
153    /// <p>Specifies whether to force a detachment.</p><note>
154    /// <ul>
155    /// <li>
156    /// <p>Use the <code>Force</code> parameter only as a last resort to detach a network interface from a failed instance.</p></li>
157    /// <li>
158    /// <p>If you use the <code>Force</code> parameter to detach a network interface, you might not be able to attach a different network interface to the same index on the instance without first stopping and starting the instance.</p></li>
159    /// <li>
160    /// <p>If you force the detachment of a network interface, the <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html">instance metadata</a> might not get updated. This means that the attributes associated with the detached network interface might still be visible. The instance metadata will get updated when you stop and start the instance.</p></li>
161    /// </ul>
162    /// </note>
163    pub fn set_force(mut self, input: ::std::option::Option<bool>) -> Self {
164        self.inner = self.inner.set_force(input);
165        self
166    }
167    /// <p>Specifies whether to force a detachment.</p><note>
168    /// <ul>
169    /// <li>
170    /// <p>Use the <code>Force</code> parameter only as a last resort to detach a network interface from a failed instance.</p></li>
171    /// <li>
172    /// <p>If you use the <code>Force</code> parameter to detach a network interface, you might not be able to attach a different network interface to the same index on the instance without first stopping and starting the instance.</p></li>
173    /// <li>
174    /// <p>If you force the detachment of a network interface, the <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html">instance metadata</a> might not get updated. This means that the attributes associated with the detached network interface might still be visible. The instance metadata will get updated when you stop and start the instance.</p></li>
175    /// </ul>
176    /// </note>
177    pub fn get_force(&self) -> &::std::option::Option<bool> {
178        self.inner.get_force()
179    }
180}