aws_sdk_fsx/operation/associate_file_system_aliases/builders.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::associate_file_system_aliases::_associate_file_system_aliases_output::AssociateFileSystemAliasesOutputBuilder;
3
4pub use crate::operation::associate_file_system_aliases::_associate_file_system_aliases_input::AssociateFileSystemAliasesInputBuilder;
5
6impl crate::operation::associate_file_system_aliases::builders::AssociateFileSystemAliasesInputBuilder {
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::associate_file_system_aliases::AssociateFileSystemAliasesOutput,
13 ::aws_smithy_runtime_api::client::result::SdkError<
14 crate::operation::associate_file_system_aliases::AssociateFileSystemAliasesError,
15 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16 >,
17 > {
18 let mut fluent_builder = client.associate_file_system_aliases();
19 fluent_builder.inner = self;
20 fluent_builder.send().await
21 }
22}
23/// Fluent builder constructing a request to `AssociateFileSystemAliases`.
24///
25/// <p>Use this action to associate one or more Domain Name Server (DNS) aliases with an existing Amazon FSx for Windows File Server file system. A file system can have a maximum of 50 DNS aliases associated with it at any one time. If you try to associate a DNS alias that is already associated with the file system, FSx takes no action on that alias in the request. For more information, see <a href="https://docs.aws.amazon.com/fsx/latest/WindowsGuide/managing-dns-aliases.html">Working with DNS Aliases</a> and <a href="https://docs.aws.amazon.com/fsx/latest/WindowsGuide/walkthrough05-file-system-custom-CNAME.html">Walkthrough 5: Using DNS aliases to access your file system</a>, including additional steps you must take to be able to access your file system using a DNS alias.</p>
26/// <p>The system response shows the DNS aliases that Amazon FSx is attempting to associate with the file system. Use the API operation to monitor the status of the aliases Amazon FSx is associating with the file system.</p>
27#[derive(::std::clone::Clone, ::std::fmt::Debug)]
28pub struct AssociateFileSystemAliasesFluentBuilder {
29 handle: ::std::sync::Arc<crate::client::Handle>,
30 inner: crate::operation::associate_file_system_aliases::builders::AssociateFileSystemAliasesInputBuilder,
31 config_override: ::std::option::Option<crate::config::Builder>,
32}
33impl
34 crate::client::customize::internal::CustomizableSend<
35 crate::operation::associate_file_system_aliases::AssociateFileSystemAliasesOutput,
36 crate::operation::associate_file_system_aliases::AssociateFileSystemAliasesError,
37 > for AssociateFileSystemAliasesFluentBuilder
38{
39 fn send(
40 self,
41 config_override: crate::config::Builder,
42 ) -> crate::client::customize::internal::BoxFuture<
43 crate::client::customize::internal::SendResult<
44 crate::operation::associate_file_system_aliases::AssociateFileSystemAliasesOutput,
45 crate::operation::associate_file_system_aliases::AssociateFileSystemAliasesError,
46 >,
47 > {
48 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
49 }
50}
51impl AssociateFileSystemAliasesFluentBuilder {
52 /// Creates a new `AssociateFileSystemAliasesFluentBuilder`.
53 pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
54 Self {
55 handle,
56 inner: ::std::default::Default::default(),
57 config_override: ::std::option::Option::None,
58 }
59 }
60 /// Access the AssociateFileSystemAliases as a reference.
61 pub fn as_input(&self) -> &crate::operation::associate_file_system_aliases::builders::AssociateFileSystemAliasesInputBuilder {
62 &self.inner
63 }
64 /// Sends the request and returns the response.
65 ///
66 /// If an error occurs, an `SdkError` will be returned with additional details that
67 /// can be matched against.
68 ///
69 /// By default, any retryable failures will be retried twice. Retry behavior
70 /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
71 /// set when configuring the client.
72 pub async fn send(
73 self,
74 ) -> ::std::result::Result<
75 crate::operation::associate_file_system_aliases::AssociateFileSystemAliasesOutput,
76 ::aws_smithy_runtime_api::client::result::SdkError<
77 crate::operation::associate_file_system_aliases::AssociateFileSystemAliasesError,
78 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
79 >,
80 > {
81 let input = self
82 .inner
83 .build()
84 .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
85 let runtime_plugins = crate::operation::associate_file_system_aliases::AssociateFileSystemAliases::operation_runtime_plugins(
86 self.handle.runtime_plugins.clone(),
87 &self.handle.conf,
88 self.config_override,
89 );
90 crate::operation::associate_file_system_aliases::AssociateFileSystemAliases::orchestrate(&runtime_plugins, input).await
91 }
92
93 /// Consumes this builder, creating a customizable operation that can be modified before being sent.
94 pub fn customize(
95 self,
96 ) -> crate::client::customize::CustomizableOperation<
97 crate::operation::associate_file_system_aliases::AssociateFileSystemAliasesOutput,
98 crate::operation::associate_file_system_aliases::AssociateFileSystemAliasesError,
99 Self,
100 > {
101 crate::client::customize::CustomizableOperation::new(self)
102 }
103 pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
104 self.set_config_override(::std::option::Option::Some(config_override.into()));
105 self
106 }
107
108 pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
109 self.config_override = config_override;
110 self
111 }
112 /// <p>(Optional) An idempotency token for resource creation, in a string of up to 63 ASCII characters. This token is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.</p>
113 pub fn client_request_token(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
114 self.inner = self.inner.client_request_token(input.into());
115 self
116 }
117 /// <p>(Optional) An idempotency token for resource creation, in a string of up to 63 ASCII characters. This token is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.</p>
118 pub fn set_client_request_token(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
119 self.inner = self.inner.set_client_request_token(input);
120 self
121 }
122 /// <p>(Optional) An idempotency token for resource creation, in a string of up to 63 ASCII characters. This token is automatically filled on your behalf when you use the Command Line Interface (CLI) or an Amazon Web Services SDK.</p>
123 pub fn get_client_request_token(&self) -> &::std::option::Option<::std::string::String> {
124 self.inner.get_client_request_token()
125 }
126 /// <p>Specifies the file system with which you want to associate one or more DNS aliases.</p>
127 pub fn file_system_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
128 self.inner = self.inner.file_system_id(input.into());
129 self
130 }
131 /// <p>Specifies the file system with which you want to associate one or more DNS aliases.</p>
132 pub fn set_file_system_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
133 self.inner = self.inner.set_file_system_id(input);
134 self
135 }
136 /// <p>Specifies the file system with which you want to associate one or more DNS aliases.</p>
137 pub fn get_file_system_id(&self) -> &::std::option::Option<::std::string::String> {
138 self.inner.get_file_system_id()
139 }
140 ///
141 /// Appends an item to `Aliases`.
142 ///
143 /// To override the contents of this collection use [`set_aliases`](Self::set_aliases).
144 ///
145 /// <p>An array of one or more DNS alias names to associate with the file system. The alias name has to comply with the following formatting requirements:</p>
146 /// <ul>
147 /// <li>
148 /// <p>Formatted as a fully-qualified domain name (FQDN), <i> <code>hostname.domain</code> </i>, for example, <code>accounting.corp.example.com</code>.</p></li>
149 /// <li>
150 /// <p>Can contain alphanumeric characters and the hyphen (-).</p></li>
151 /// <li>
152 /// <p>Cannot start or end with a hyphen.</p></li>
153 /// <li>
154 /// <p>Can start with a numeric.</p></li>
155 /// </ul>
156 /// <p>For DNS alias names, Amazon FSx stores alphabetic characters as lowercase letters (a-z), regardless of how you specify them: as uppercase letters, lowercase letters, or the corresponding letters in escape codes.</p>
157 pub fn aliases(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
158 self.inner = self.inner.aliases(input.into());
159 self
160 }
161 /// <p>An array of one or more DNS alias names to associate with the file system. The alias name has to comply with the following formatting requirements:</p>
162 /// <ul>
163 /// <li>
164 /// <p>Formatted as a fully-qualified domain name (FQDN), <i> <code>hostname.domain</code> </i>, for example, <code>accounting.corp.example.com</code>.</p></li>
165 /// <li>
166 /// <p>Can contain alphanumeric characters and the hyphen (-).</p></li>
167 /// <li>
168 /// <p>Cannot start or end with a hyphen.</p></li>
169 /// <li>
170 /// <p>Can start with a numeric.</p></li>
171 /// </ul>
172 /// <p>For DNS alias names, Amazon FSx stores alphabetic characters as lowercase letters (a-z), regardless of how you specify them: as uppercase letters, lowercase letters, or the corresponding letters in escape codes.</p>
173 pub fn set_aliases(mut self, input: ::std::option::Option<::std::vec::Vec<::std::string::String>>) -> Self {
174 self.inner = self.inner.set_aliases(input);
175 self
176 }
177 /// <p>An array of one or more DNS alias names to associate with the file system. The alias name has to comply with the following formatting requirements:</p>
178 /// <ul>
179 /// <li>
180 /// <p>Formatted as a fully-qualified domain name (FQDN), <i> <code>hostname.domain</code> </i>, for example, <code>accounting.corp.example.com</code>.</p></li>
181 /// <li>
182 /// <p>Can contain alphanumeric characters and the hyphen (-).</p></li>
183 /// <li>
184 /// <p>Cannot start or end with a hyphen.</p></li>
185 /// <li>
186 /// <p>Can start with a numeric.</p></li>
187 /// </ul>
188 /// <p>For DNS alias names, Amazon FSx stores alphabetic characters as lowercase letters (a-z), regardless of how you specify them: as uppercase letters, lowercase letters, or the corresponding letters in escape codes.</p>
189 pub fn get_aliases(&self) -> &::std::option::Option<::std::vec::Vec<::std::string::String>> {
190 self.inner.get_aliases()
191 }
192}