aws_sdk_dsql/operation/create_multi_region_clusters/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::create_multi_region_clusters::_create_multi_region_clusters_output::CreateMultiRegionClustersOutputBuilder;
3
4pub use crate::operation::create_multi_region_clusters::_create_multi_region_clusters_input::CreateMultiRegionClustersInputBuilder;
5
6impl crate::operation::create_multi_region_clusters::builders::CreateMultiRegionClustersInputBuilder {
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::create_multi_region_clusters::CreateMultiRegionClustersOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::create_multi_region_clusters::CreateMultiRegionClustersError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.create_multi_region_clusters();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `CreateMultiRegionClusters`.
24///
25/// <p>Creates multi-Region clusters in Amazon Aurora DSQL. Multi-Region clusters require a linked Region list, which is an array of the Regions in which you want to create linked clusters. Multi-Region clusters require a witness Region, which participates in quorum in failure scenarios.</p>
26#[deprecated(
27    note = "The CreateMultiRegionClusters API is deprecated. Use the CreateCluster API with multi-Region properties to create a multi-Region cluster.",
28    since = "5/13/2025"
29)]
30#[derive(::std::clone::Clone, ::std::fmt::Debug)]
31pub struct CreateMultiRegionClustersFluentBuilder {
32    handle: ::std::sync::Arc<crate::client::Handle>,
33    inner: crate::operation::create_multi_region_clusters::builders::CreateMultiRegionClustersInputBuilder,
34    config_override: ::std::option::Option<crate::config::Builder>,
35}
36impl
37    crate::client::customize::internal::CustomizableSend<
38        crate::operation::create_multi_region_clusters::CreateMultiRegionClustersOutput,
39        crate::operation::create_multi_region_clusters::CreateMultiRegionClustersError,
40    > for CreateMultiRegionClustersFluentBuilder
41{
42    fn send(
43        self,
44        config_override: crate::config::Builder,
45    ) -> crate::client::customize::internal::BoxFuture<
46        crate::client::customize::internal::SendResult<
47            crate::operation::create_multi_region_clusters::CreateMultiRegionClustersOutput,
48            crate::operation::create_multi_region_clusters::CreateMultiRegionClustersError,
49        >,
50    > {
51        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
52    }
53}
54impl CreateMultiRegionClustersFluentBuilder {
55    /// Creates a new `CreateMultiRegionClustersFluentBuilder`.
56    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
57        Self {
58            handle,
59            inner: ::std::default::Default::default(),
60            config_override: ::std::option::Option::None,
61        }
62    }
63    /// Access the CreateMultiRegionClusters as a reference.
64    pub fn as_input(&self) -> &crate::operation::create_multi_region_clusters::builders::CreateMultiRegionClustersInputBuilder {
65        &self.inner
66    }
67    /// Sends the request and returns the response.
68    ///
69    /// If an error occurs, an `SdkError` will be returned with additional details that
70    /// can be matched against.
71    ///
72    /// By default, any retryable failures will be retried twice. Retry behavior
73    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
74    /// set when configuring the client.
75    pub async fn send(
76        self,
77    ) -> ::std::result::Result<
78        crate::operation::create_multi_region_clusters::CreateMultiRegionClustersOutput,
79        ::aws_smithy_runtime_api::client::result::SdkError<
80            crate::operation::create_multi_region_clusters::CreateMultiRegionClustersError,
81            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
82        >,
83    > {
84        let input = self
85            .inner
86            .build()
87            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
88        let runtime_plugins = crate::operation::create_multi_region_clusters::CreateMultiRegionClusters::operation_runtime_plugins(
89            self.handle.runtime_plugins.clone(),
90            &self.handle.conf,
91            self.config_override,
92        );
93        crate::operation::create_multi_region_clusters::CreateMultiRegionClusters::orchestrate(&runtime_plugins, input).await
94    }
95
96    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
97    pub fn customize(
98        self,
99    ) -> crate::client::customize::CustomizableOperation<
100        crate::operation::create_multi_region_clusters::CreateMultiRegionClustersOutput,
101        crate::operation::create_multi_region_clusters::CreateMultiRegionClustersError,
102        Self,
103    > {
104        crate::client::customize::CustomizableOperation::new(self)
105    }
106    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
107        self.set_config_override(::std::option::Option::Some(config_override.into()));
108        self
109    }
110
111    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
112        self.config_override = config_override;
113        self
114    }
115    ///
116    /// Appends an item to `linkedRegionList`.
117    ///
118    /// To override the contents of this collection use [`set_linked_region_list`](Self::set_linked_region_list).
119    ///
120    /// <p>An array of the Regions in which you want to create additional clusters.</p>
121    pub fn linked_region_list(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
122        self.inner = self.inner.linked_region_list(input.into());
123        self
124    }
125    /// <p>An array of the Regions in which you want to create additional clusters.</p>
126    pub fn set_linked_region_list(mut self, input: ::std::option::Option<::std::vec::Vec<::std::string::String>>) -> Self {
127        self.inner = self.inner.set_linked_region_list(input);
128        self
129    }
130    /// <p>An array of the Regions in which you want to create additional clusters.</p>
131    pub fn get_linked_region_list(&self) -> &::std::option::Option<::std::vec::Vec<::std::string::String>> {
132        self.inner.get_linked_region_list()
133    }
134    ///
135    /// Adds a key-value pair to `clusterProperties`.
136    ///
137    /// To override the contents of this collection use [`set_cluster_properties`](Self::set_cluster_properties).
138    ///
139    /// <p>A mapping of properties to use when creating linked clusters.</p>
140    pub fn cluster_properties(mut self, k: impl ::std::convert::Into<::std::string::String>, v: crate::types::LinkedClusterProperties) -> Self {
141        self.inner = self.inner.cluster_properties(k.into(), v);
142        self
143    }
144    /// <p>A mapping of properties to use when creating linked clusters.</p>
145    pub fn set_cluster_properties(
146        mut self,
147        input: ::std::option::Option<::std::collections::HashMap<::std::string::String, crate::types::LinkedClusterProperties>>,
148    ) -> Self {
149        self.inner = self.inner.set_cluster_properties(input);
150        self
151    }
152    /// <p>A mapping of properties to use when creating linked clusters.</p>
153    pub fn get_cluster_properties(
154        &self,
155    ) -> &::std::option::Option<::std::collections::HashMap<::std::string::String, crate::types::LinkedClusterProperties>> {
156        self.inner.get_cluster_properties()
157    }
158    /// <p>The witness Region of multi-Region clusters.</p>
159    pub fn witness_region(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
160        self.inner = self.inner.witness_region(input.into());
161        self
162    }
163    /// <p>The witness Region of multi-Region clusters.</p>
164    pub fn set_witness_region(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
165        self.inner = self.inner.set_witness_region(input);
166        self
167    }
168    /// <p>The witness Region of multi-Region clusters.</p>
169    pub fn get_witness_region(&self) -> &::std::option::Option<::std::string::String> {
170        self.inner.get_witness_region()
171    }
172    /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully. The subsequent retries with the same client token return the result from the original successful request and they have no additional effect.</p>
173    /// <p>If you don't specify a client token, the Amazon Web Services SDK automatically generates one.</p>
174    pub fn client_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
175        self.inner = self.inner.client_token(input.into());
176        self
177    }
178    /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully. The subsequent retries with the same client token return the result from the original successful request and they have no additional effect.</p>
179    /// <p>If you don't specify a client token, the Amazon Web Services SDK automatically generates one.</p>
180    pub fn set_client_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
181        self.inner = self.inner.set_client_token(input);
182        self
183    }
184    /// <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. Idempotency ensures that an API request completes only once. With an idempotent request, if the original request completes successfully. The subsequent retries with the same client token return the result from the original successful request and they have no additional effect.</p>
185    /// <p>If you don't specify a client token, the Amazon Web Services SDK automatically generates one.</p>
186    pub fn get_client_token(&self) -> &::std::option::Option<::std::string::String> {
187        self.inner.get_client_token()
188    }
189}
aws_sdk_dsql/operation/create_multi_region_clusters/builders.rs

aws_sdk_dsql/operation/create_multi_region_clusters/
builders.rs
