aws_sdk_ec2/operation/release_hosts/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::release_hosts::_release_hosts_output::ReleaseHostsOutputBuilder;
3
4pub use crate::operation::release_hosts::_release_hosts_input::ReleaseHostsInputBuilder;
5
6impl crate::operation::release_hosts::builders::ReleaseHostsInputBuilder {
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::release_hosts::ReleaseHostsOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::release_hosts::ReleaseHostsError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.release_hosts();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `ReleaseHosts`.
24///
25/// <p>When you no longer want to use an On-Demand Dedicated Host it can be released. On-Demand billing is stopped and the host goes into <code>released</code> state. The host ID of Dedicated Hosts that have been released can no longer be specified in another request, for example, to modify the host. You must stop or terminate all instances on a host before it can be released.</p>
26/// <p>When Dedicated Hosts are released, it may take some time for them to stop counting toward your limit and you may receive capacity errors when trying to allocate new Dedicated Hosts. Wait a few minutes and then try again.</p>
27/// <p>Released hosts still appear in a <code>DescribeHosts</code> response.</p>
28#[derive(::std::clone::Clone, ::std::fmt::Debug)]
29pub struct ReleaseHostsFluentBuilder {
30    handle: ::std::sync::Arc<crate::client::Handle>,
31    inner: crate::operation::release_hosts::builders::ReleaseHostsInputBuilder,
32    config_override: ::std::option::Option<crate::config::Builder>,
33}
34impl
35    crate::client::customize::internal::CustomizableSend<
36        crate::operation::release_hosts::ReleaseHostsOutput,
37        crate::operation::release_hosts::ReleaseHostsError,
38    > for ReleaseHostsFluentBuilder
39{
40    fn send(
41        self,
42        config_override: crate::config::Builder,
43    ) -> crate::client::customize::internal::BoxFuture<
44        crate::client::customize::internal::SendResult<
45            crate::operation::release_hosts::ReleaseHostsOutput,
46            crate::operation::release_hosts::ReleaseHostsError,
47        >,
48    > {
49        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
50    }
51}
52impl ReleaseHostsFluentBuilder {
53    /// Creates a new `ReleaseHostsFluentBuilder`.
54    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
55        Self {
56            handle,
57            inner: ::std::default::Default::default(),
58            config_override: ::std::option::Option::None,
59        }
60    }
61    /// Access the ReleaseHosts as a reference.
62    pub fn as_input(&self) -> &crate::operation::release_hosts::builders::ReleaseHostsInputBuilder {
63        &self.inner
64    }
65    /// Sends the request and returns the response.
66    ///
67    /// If an error occurs, an `SdkError` will be returned with additional details that
68    /// can be matched against.
69    ///
70    /// By default, any retryable failures will be retried twice. Retry behavior
71    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
72    /// set when configuring the client.
73    pub async fn send(
74        self,
75    ) -> ::std::result::Result<
76        crate::operation::release_hosts::ReleaseHostsOutput,
77        ::aws_smithy_runtime_api::client::result::SdkError<
78            crate::operation::release_hosts::ReleaseHostsError,
79            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
80        >,
81    > {
82        let input = self
83            .inner
84            .build()
85            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
86        let runtime_plugins = crate::operation::release_hosts::ReleaseHosts::operation_runtime_plugins(
87            self.handle.runtime_plugins.clone(),
88            &self.handle.conf,
89            self.config_override,
90        );
91        crate::operation::release_hosts::ReleaseHosts::orchestrate(&runtime_plugins, input).await
92    }
93
94    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
95    pub fn customize(
96        self,
97    ) -> crate::client::customize::CustomizableOperation<
98        crate::operation::release_hosts::ReleaseHostsOutput,
99        crate::operation::release_hosts::ReleaseHostsError,
100        Self,
101    > {
102        crate::client::customize::CustomizableOperation::new(self)
103    }
104    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
105        self.set_config_override(::std::option::Option::Some(config_override.into()));
106        self
107    }
108
109    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
110        self.config_override = config_override;
111        self
112    }
113    ///
114    /// Appends an item to `HostIds`.
115    ///
116    /// To override the contents of this collection use [`set_host_ids`](Self::set_host_ids).
117    ///
118    /// <p>The IDs of the Dedicated Hosts to release.</p>
119    pub fn host_ids(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
120        self.inner = self.inner.host_ids(input.into());
121        self
122    }
123    /// <p>The IDs of the Dedicated Hosts to release.</p>
124    pub fn set_host_ids(mut self, input: ::std::option::Option<::std::vec::Vec<::std::string::String>>) -> Self {
125        self.inner = self.inner.set_host_ids(input);
126        self
127    }
128    /// <p>The IDs of the Dedicated Hosts to release.</p>
129    pub fn get_host_ids(&self) -> &::std::option::Option<::std::vec::Vec<::std::string::String>> {
130        self.inner.get_host_ids()
131    }
132}