aws_sdk_ec2/operation/get_ipam_address_history/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::get_ipam_address_history::_get_ipam_address_history_output::GetIpamAddressHistoryOutputBuilder;
3
4pub use crate::operation::get_ipam_address_history::_get_ipam_address_history_input::GetIpamAddressHistoryInputBuilder;
5
6impl crate::operation::get_ipam_address_history::builders::GetIpamAddressHistoryInputBuilder {
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::get_ipam_address_history::GetIpamAddressHistoryOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::get_ipam_address_history::GetIpamAddressHistoryError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.get_ipam_address_history();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `GetIpamAddressHistory`.
24///
25/// <p>Retrieve historical information about a CIDR within an IPAM scope. For more information, see <a href="https://docs.aws.amazon.com/vpc/latest/ipam/view-history-cidr-ipam.html">View the history of IP addresses</a> in the <i>Amazon VPC IPAM User Guide</i>.</p>
26#[derive(::std::clone::Clone, ::std::fmt::Debug)]
27pub struct GetIpamAddressHistoryFluentBuilder {
28    handle: ::std::sync::Arc<crate::client::Handle>,
29    inner: crate::operation::get_ipam_address_history::builders::GetIpamAddressHistoryInputBuilder,
30    config_override: ::std::option::Option<crate::config::Builder>,
31}
32impl
33    crate::client::customize::internal::CustomizableSend<
34        crate::operation::get_ipam_address_history::GetIpamAddressHistoryOutput,
35        crate::operation::get_ipam_address_history::GetIpamAddressHistoryError,
36    > for GetIpamAddressHistoryFluentBuilder
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::get_ipam_address_history::GetIpamAddressHistoryOutput,
44            crate::operation::get_ipam_address_history::GetIpamAddressHistoryError,
45        >,
46    > {
47        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
48    }
49}
50impl GetIpamAddressHistoryFluentBuilder {
51    /// Creates a new `GetIpamAddressHistoryFluentBuilder`.
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 GetIpamAddressHistory as a reference.
60    pub fn as_input(&self) -> &crate::operation::get_ipam_address_history::builders::GetIpamAddressHistoryInputBuilder {
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::get_ipam_address_history::GetIpamAddressHistoryOutput,
75        ::aws_smithy_runtime_api::client::result::SdkError<
76            crate::operation::get_ipam_address_history::GetIpamAddressHistoryError,
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::get_ipam_address_history::GetIpamAddressHistory::operation_runtime_plugins(
85            self.handle.runtime_plugins.clone(),
86            &self.handle.conf,
87            self.config_override,
88        );
89        crate::operation::get_ipam_address_history::GetIpamAddressHistory::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::get_ipam_address_history::GetIpamAddressHistoryOutput,
97        crate::operation::get_ipam_address_history::GetIpamAddressHistoryError,
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    /// Create a paginator for this request
112    ///
113    /// Paginators are used by calling [`send().await`](crate::operation::get_ipam_address_history::paginator::GetIpamAddressHistoryPaginator::send) which returns a [`PaginationStream`](aws_smithy_async::future::pagination_stream::PaginationStream).
114    pub fn into_paginator(self) -> crate::operation::get_ipam_address_history::paginator::GetIpamAddressHistoryPaginator {
115        crate::operation::get_ipam_address_history::paginator::GetIpamAddressHistoryPaginator::new(self.handle, self.inner)
116    }
117    /// <p>A check for 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>
118    pub fn dry_run(mut self, input: bool) -> Self {
119        self.inner = self.inner.dry_run(input);
120        self
121    }
122    /// <p>A check for 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>
123    pub fn set_dry_run(mut self, input: ::std::option::Option<bool>) -> Self {
124        self.inner = self.inner.set_dry_run(input);
125        self
126    }
127    /// <p>A check for 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>
128    pub fn get_dry_run(&self) -> &::std::option::Option<bool> {
129        self.inner.get_dry_run()
130    }
131    /// <p>The CIDR you want the history of. The CIDR can be an IPv4 or IPv6 IP address range. If you enter a /16 IPv4 CIDR, you will get records that match it exactly. You will not get records for any subnets within the /16 CIDR.</p>
132    pub fn cidr(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
133        self.inner = self.inner.cidr(input.into());
134        self
135    }
136    /// <p>The CIDR you want the history of. The CIDR can be an IPv4 or IPv6 IP address range. If you enter a /16 IPv4 CIDR, you will get records that match it exactly. You will not get records for any subnets within the /16 CIDR.</p>
137    pub fn set_cidr(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
138        self.inner = self.inner.set_cidr(input);
139        self
140    }
141    /// <p>The CIDR you want the history of. The CIDR can be an IPv4 or IPv6 IP address range. If you enter a /16 IPv4 CIDR, you will get records that match it exactly. You will not get records for any subnets within the /16 CIDR.</p>
142    pub fn get_cidr(&self) -> &::std::option::Option<::std::string::String> {
143        self.inner.get_cidr()
144    }
145    /// <p>The ID of the IPAM scope that the CIDR is in.</p>
146    pub fn ipam_scope_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
147        self.inner = self.inner.ipam_scope_id(input.into());
148        self
149    }
150    /// <p>The ID of the IPAM scope that the CIDR is in.</p>
151    pub fn set_ipam_scope_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
152        self.inner = self.inner.set_ipam_scope_id(input);
153        self
154    }
155    /// <p>The ID of the IPAM scope that the CIDR is in.</p>
156    pub fn get_ipam_scope_id(&self) -> &::std::option::Option<::std::string::String> {
157        self.inner.get_ipam_scope_id()
158    }
159    /// <p>The ID of the VPC you want your history records filtered by.</p>
160    pub fn vpc_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
161        self.inner = self.inner.vpc_id(input.into());
162        self
163    }
164    /// <p>The ID of the VPC you want your history records filtered by.</p>
165    pub fn set_vpc_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
166        self.inner = self.inner.set_vpc_id(input);
167        self
168    }
169    /// <p>The ID of the VPC you want your history records filtered by.</p>
170    pub fn get_vpc_id(&self) -> &::std::option::Option<::std::string::String> {
171        self.inner.get_vpc_id()
172    }
173    /// <p>The start of the time period for which you are looking for history. If you omit this option, it will default to the value of EndTime.</p>
174    pub fn start_time(mut self, input: ::aws_smithy_types::DateTime) -> Self {
175        self.inner = self.inner.start_time(input);
176        self
177    }
178    /// <p>The start of the time period for which you are looking for history. If you omit this option, it will default to the value of EndTime.</p>
179    pub fn set_start_time(mut self, input: ::std::option::Option<::aws_smithy_types::DateTime>) -> Self {
180        self.inner = self.inner.set_start_time(input);
181        self
182    }
183    /// <p>The start of the time period for which you are looking for history. If you omit this option, it will default to the value of EndTime.</p>
184    pub fn get_start_time(&self) -> &::std::option::Option<::aws_smithy_types::DateTime> {
185        self.inner.get_start_time()
186    }
187    /// <p>The end of the time period for which you are looking for history. If you omit this option, it will default to the current time.</p>
188    pub fn end_time(mut self, input: ::aws_smithy_types::DateTime) -> Self {
189        self.inner = self.inner.end_time(input);
190        self
191    }
192    /// <p>The end of the time period for which you are looking for history. If you omit this option, it will default to the current time.</p>
193    pub fn set_end_time(mut self, input: ::std::option::Option<::aws_smithy_types::DateTime>) -> Self {
194        self.inner = self.inner.set_end_time(input);
195        self
196    }
197    /// <p>The end of the time period for which you are looking for history. If you omit this option, it will default to the current time.</p>
198    pub fn get_end_time(&self) -> &::std::option::Option<::aws_smithy_types::DateTime> {
199        self.inner.get_end_time()
200    }
201    /// <p>The maximum number of historical results you would like returned per page. Defaults to 100.</p>
202    pub fn max_results(mut self, input: i32) -> Self {
203        self.inner = self.inner.max_results(input);
204        self
205    }
206    /// <p>The maximum number of historical results you would like returned per page. Defaults to 100.</p>
207    pub fn set_max_results(mut self, input: ::std::option::Option<i32>) -> Self {
208        self.inner = self.inner.set_max_results(input);
209        self
210    }
211    /// <p>The maximum number of historical results you would like returned per page. Defaults to 100.</p>
212    pub fn get_max_results(&self) -> &::std::option::Option<i32> {
213        self.inner.get_max_results()
214    }
215    /// <p>The token for the next page of results.</p>
216    pub fn next_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
217        self.inner = self.inner.next_token(input.into());
218        self
219    }
220    /// <p>The token for the next page of results.</p>
221    pub fn set_next_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
222        self.inner = self.inner.set_next_token(input);
223        self
224    }
225    /// <p>The token for the next page of results.</p>
226    pub fn get_next_token(&self) -> &::std::option::Option<::std::string::String> {
227        self.inner.get_next_token()
228    }
229}