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><important>
45/// <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
46/// </important>
47#[derive(::std::clone::Clone, ::std::fmt::Debug)]
48pub struct SubmitMultiRegionAccessPointRoutesFluentBuilder {
49    handle: ::std::sync::Arc<crate::client::Handle>,
50    inner: crate::operation::submit_multi_region_access_point_routes::builders::SubmitMultiRegionAccessPointRoutesInputBuilder,
51    config_override: ::std::option::Option<crate::config::Builder>,
52}
53impl
54    crate::client::customize::internal::CustomizableSend<
55        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesOutput,
56        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesError,
57    > for SubmitMultiRegionAccessPointRoutesFluentBuilder
58{
59    fn send(
60        self,
61        config_override: crate::config::Builder,
62    ) -> crate::client::customize::internal::BoxFuture<
63        crate::client::customize::internal::SendResult<
64            crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesOutput,
65            crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesError,
66        >,
67    > {
68        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
69    }
70}
71impl SubmitMultiRegionAccessPointRoutesFluentBuilder {
72    /// Creates a new `SubmitMultiRegionAccessPointRoutesFluentBuilder`.
73    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
74        Self {
75            handle,
76            inner: ::std::default::Default::default(),
77            config_override: ::std::option::Option::None,
78        }
79    }
80    /// Access the SubmitMultiRegionAccessPointRoutes as a reference.
81    pub fn as_input(&self) -> &crate::operation::submit_multi_region_access_point_routes::builders::SubmitMultiRegionAccessPointRoutesInputBuilder {
82        &self.inner
83    }
84    /// Sends the request and returns the response.
85    ///
86    /// If an error occurs, an `SdkError` will be returned with additional details that
87    /// can be matched against.
88    ///
89    /// By default, any retryable failures will be retried twice. Retry behavior
90    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
91    /// set when configuring the client.
92    pub async fn send(
93        self,
94    ) -> ::std::result::Result<
95        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesOutput,
96        ::aws_smithy_runtime_api::client::result::SdkError<
97            crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesError,
98            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
99        >,
100    > {
101        let input = self
102            .inner
103            .build()
104            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
105        let runtime_plugins =
106            crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutes::operation_runtime_plugins(
107                self.handle.runtime_plugins.clone(),
108                &self.handle.conf,
109                self.config_override,
110            );
111        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutes::orchestrate(&runtime_plugins, input).await
112    }
113
114    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
115    pub fn customize(
116        self,
117    ) -> crate::client::customize::CustomizableOperation<
118        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesOutput,
119        crate::operation::submit_multi_region_access_point_routes::SubmitMultiRegionAccessPointRoutesError,
120        Self,
121    > {
122        crate::client::customize::CustomizableOperation::new(self)
123    }
124    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
125        self.set_config_override(::std::option::Option::Some(config_override.into()));
126        self
127    }
128
129    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
130        self.config_override = config_override;
131        self
132    }
133    /// <p>The Amazon Web Services account ID for the owner of the Multi-Region Access Point.</p>
134    pub fn account_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
135        self.inner = self.inner.account_id(input.into());
136        self
137    }
138    /// <p>The Amazon Web Services account ID for the owner of the Multi-Region Access Point.</p>
139    pub fn set_account_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
140        self.inner = self.inner.set_account_id(input);
141        self
142    }
143    /// <p>The Amazon Web Services account ID for the owner of the Multi-Region Access Point.</p>
144    pub fn get_account_id(&self) -> &::std::option::Option<::std::string::String> {
145        self.inner.get_account_id()
146    }
147    /// <p>The Multi-Region Access Point ARN.</p>
148    pub fn mrap(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
149        self.inner = self.inner.mrap(input.into());
150        self
151    }
152    /// <p>The Multi-Region Access Point ARN.</p>
153    pub fn set_mrap(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
154        self.inner = self.inner.set_mrap(input);
155        self
156    }
157    /// <p>The Multi-Region Access Point ARN.</p>
158    pub fn get_mrap(&self) -> &::std::option::Option<::std::string::String> {
159        self.inner.get_mrap()
160    }
161    ///
162    /// Appends an item to `RouteUpdates`.
163    ///
164    /// To override the contents of this collection use [`set_route_updates`](Self::set_route_updates).
165    ///
166    /// <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>
167    pub fn route_updates(mut self, input: crate::types::MultiRegionAccessPointRoute) -> Self {
168        self.inner = self.inner.route_updates(input);
169        self
170    }
171    /// <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>
172    pub fn set_route_updates(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::MultiRegionAccessPointRoute>>) -> Self {
173        self.inner = self.inner.set_route_updates(input);
174        self
175    }
176    /// <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>
177    pub fn get_route_updates(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::MultiRegionAccessPointRoute>> {
178        self.inner.get_route_updates()
179    }
180}
aws_sdk_s3control/operation/submit_multi_region_access_point_routes/builders.rs

aws_sdk_s3control/operation/submit_multi_region_access_point_routes/
builders.rs
