aws_sdk_s3control/operation/submit_multi_region_access_point_routes/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::submit_multi_region_access_point_routes::_submit_multi_region_access_point_routes_output::SubmitMultiRegionAccessPointRoutesOutputBuilder;
3
4pub use crate::operation::submit_multi_region_access_point_routes::_submit_multi_region_access_point_routes_input::SubmitMultiRegionAccessPointRoutesInputBuilder;
5
6impl crate::operation::submit_multi_region_access_point_routes::builders::SubmitMultiRegionAccessPointRoutesInputBuilder {
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::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.submit_multi_region_access_point_routes();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `SubmitMultiRegionAccessPointRoutes`.
24///
25/// <note>
26/// <p>This operation is not supported by directory buckets.</p>
27/// </note>
28/// <p>Submits an updated route configuration for a Multi-Region Access Point. This API operation updates the routing status for the specified Regions from active to passive, or from passive to active. A value of <code>0</code> indicates a passive status, which means that traffic won't be routed to the specified Region. A value of <code>100</code> indicates an active status, which means that traffic will be routed to the specified Region. At least one Region must be active at all times.</p>
29/// <p>When the routing configuration is changed, any in-progress operations (uploads, copies, deletes, and so on) to formerly active Regions will continue to run to their final completion state (success or failure). The routing configurations of any Regions that aren’t specified remain unchanged.</p><note>
30/// <p>Updated routing configurations might not be immediately applied. It can take up to 2 minutes for your changes to take effect.</p>
31/// </note>
32/// <p>To submit routing control changes and failover requests, use the Amazon S3 failover control infrastructure endpoints in these five Amazon Web Services Regions:</p>
33/// <ul>
34/// <li>
35/// <p><code>us-east-1</code></p></li>
36/// <li>
37/// <p><code>us-west-2</code></p></li>
38/// <li>
39/// <p><code>ap-southeast-2</code></p></li>
40/// <li>
41/// <p><code>ap-northeast-1</code></p></li>
42/// <li>
43/// <p><code>eu-west-1</code></p></li>
44/// </ul>
45#[derive(::std::clone::Clone, ::std::fmt::Debug)]
46pub struct SubmitMultiRegionAccessPointRoutesFluentBuilder {
47    handle: ::std::sync::Arc<crate::client::Handle>,
48    inner: crate::operation::submit_multi_region_access_point_routes::builders::SubmitMultiRegionAccessPointRoutesInputBuilder,
49    config_override: ::std::option::Option<crate::config::Builder>,
50}
51impl
52    crate::client::customize::internal::CustomizableSend<
53        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesOutput,
54        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesError,
55    > for SubmitMultiRegionAccessPointRoutesFluentBuilder
56{
57    fn send(
58        self,
59        config_override: crate::config::Builder,
60    ) -> crate::client::customize::internal::BoxFuture<
61        crate::client::customize::internal::SendResult<
62            crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesOutput,
63            crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesError,
64        >,
65    > {
66        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
67    }
68}
69impl SubmitMultiRegionAccessPointRoutesFluentBuilder {
70    /// Creates a new `SubmitMultiRegionAccessPointRoutesFluentBuilder`.
71    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
72        Self {
73            handle,
74            inner: ::std::default::Default::default(),
75            config_override: ::std::option::Option::None,
76        }
77    }
78    /// Access the SubmitMultiRegionAccessPointRoutes as a reference.
79    pub fn as_input(&self) -> &crate::operation::submit_multi_region_access_point_routes::builders::SubmitMultiRegionAccessPointRoutesInputBuilder {
80        &self.inner
81    }
82    /// Sends the request and returns the response.
83    ///
84    /// If an error occurs, an `SdkError` will be returned with additional details that
85    /// can be matched against.
86    ///
87    /// By default, any retryable failures will be retried twice. Retry behavior
88    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
89    /// set when configuring the client.
90    pub async fn send(
91        self,
92    ) -> ::std::result::Result<
93        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesOutput,
94        ::aws_smithy_runtime_api::client::result::SdkError<
95            crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesError,
96            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
97        >,
98    > {
99        let input = self
100            .inner
101            .build()
102            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
103        let runtime_plugins =
104            crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutes::operation_runtime_plugins(
105                self.handle.runtime_plugins.clone(),
106                &self.handle.conf,
107                self.config_override,
108            );
109        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutes::orchestrate(&runtime_plugins, input).await
110    }
111
112    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
113    pub fn customize(
114        self,
115    ) -> crate::client::customize::CustomizableOperation<
116        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesOutput,
117        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesError,
118        Self,
119    > {
120        crate::client::customize::CustomizableOperation::new(self)
121    }
122    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
123        self.set_config_override(::std::option::Option::Some(config_override.into()));
124        self
125    }
126
127    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
128        self.config_override = config_override;
129        self
130    }
131    /// <p>The Amazon Web Services account ID for the owner of the Multi-Region Access Point.</p>
132    pub fn account_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
133        self.inner = self.inner.account_id(input.into());
134        self
135    }
136    /// <p>The Amazon Web Services account ID for the owner of the Multi-Region Access Point.</p>
137    pub fn set_account_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
138        self.inner = self.inner.set_account_id(input);
139        self
140    }
141    /// <p>The Amazon Web Services account ID for the owner of the Multi-Region Access Point.</p>
142    pub fn get_account_id(&self) -> &::std::option::Option<::std::string::String> {
143        self.inner.get_account_id()
144    }
145    /// <p>The Multi-Region Access Point ARN.</p>
146    pub fn mrap(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
147        self.inner = self.inner.mrap(input.into());
148        self
149    }
150    /// <p>The Multi-Region Access Point ARN.</p>
151    pub fn set_mrap(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
152        self.inner = self.inner.set_mrap(input);
153        self
154    }
155    /// <p>The Multi-Region Access Point ARN.</p>
156    pub fn get_mrap(&self) -> &::std::option::Option<::std::string::String> {
157        self.inner.get_mrap()
158    }
159    ///
160    /// Appends an item to `RouteUpdates`.
161    ///
162    /// To override the contents of this collection use [`set_route_updates`](Self::set_route_updates).
163    ///
164    /// <p>The different routes that make up the new route configuration. Active routes return a value of <code>100</code>, and passive routes return a value of <code>0</code>.</p>
165    pub fn route_updates(mut self, input: crate::types::MultiRegionAccessPointRoute) -> Self {
166        self.inner = self.inner.route_updates(input);
167        self
168    }
169    /// <p>The different routes that make up the new route configuration. Active routes return a value of <code>100</code>, and passive routes return a value of <code>0</code>.</p>
170    pub fn set_route_updates(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::MultiRegionAccessPointRoute>>) -> Self {
171        self.inner = self.inner.set_route_updates(input);
172        self
173    }
174    /// <p>The different routes that make up the new route configuration. Active routes return a value of <code>100</code>, and passive routes return a value of <code>0</code>.</p>
175    pub fn get_route_updates(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::MultiRegionAccessPointRoute>> {
176        self.inner.get_route_updates()
177    }
178}
aws_sdk_s3control/operation/submit_multi_region_access_point_routes/builders.rs

aws_sdk_s3control/operation/submit_multi_region_access_point_routes/
builders.rs
