aws_sdk_route53resolver/operation/create_resolver_rule/builders.rs
1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::create_resolver_rule::_create_resolver_rule_output::CreateResolverRuleOutputBuilder;
3
4pub use crate::operation::create_resolver_rule::_create_resolver_rule_input::CreateResolverRuleInputBuilder;
5
6impl crate::operation::create_resolver_rule::builders::CreateResolverRuleInputBuilder {
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_resolver_rule::CreateResolverRuleOutput,
13 ::aws_smithy_runtime_api::client::result::SdkError<
14 crate::operation::create_resolver_rule::CreateResolverRuleError,
15 ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16 >,
17 > {
18 let mut fluent_builder = client.create_resolver_rule();
19 fluent_builder.inner = self;
20 fluent_builder.send().await
21 }
22}
23/// Fluent builder constructing a request to `CreateResolverRule`.
24///
25/// <p>For DNS queries that originate in your VPCs, specifies which Resolver endpoint the queries pass through, one domain name that you want to forward to your network, and the IP addresses of the DNS resolvers in your network.</p>
26#[derive(::std::clone::Clone, ::std::fmt::Debug)]
27pub struct CreateResolverRuleFluentBuilder {
28 handle: ::std::sync::Arc<crate::client::Handle>,
29 inner: crate::operation::create_resolver_rule::builders::CreateResolverRuleInputBuilder,
30 config_override: ::std::option::Option<crate::config::Builder>,
31}
32impl
33 crate::client::customize::internal::CustomizableSend<
34 crate::operation::create_resolver_rule::CreateResolverRuleOutput,
35 crate::operation::create_resolver_rule::CreateResolverRuleError,
36 > for CreateResolverRuleFluentBuilder
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::create_resolver_rule::CreateResolverRuleOutput,
44 crate::operation::create_resolver_rule::CreateResolverRuleError,
45 >,
46 > {
47 ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
48 }
49}
50impl CreateResolverRuleFluentBuilder {
51 /// Creates a new `CreateResolverRuleFluentBuilder`.
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 CreateResolverRule as a reference.
60 pub fn as_input(&self) -> &crate::operation::create_resolver_rule::builders::CreateResolverRuleInputBuilder {
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::create_resolver_rule::CreateResolverRuleOutput,
75 ::aws_smithy_runtime_api::client::result::SdkError<
76 crate::operation::create_resolver_rule::CreateResolverRuleError,
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::create_resolver_rule::CreateResolverRule::operation_runtime_plugins(
85 self.handle.runtime_plugins.clone(),
86 &self.handle.conf,
87 self.config_override,
88 );
89 crate::operation::create_resolver_rule::CreateResolverRule::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::create_resolver_rule::CreateResolverRuleOutput,
97 crate::operation::create_resolver_rule::CreateResolverRuleError,
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 /// <p>A unique string that identifies the request and that allows failed requests to be retried without the risk of running the operation twice. <code>CreatorRequestId</code> can be any unique string, for example, a date/time stamp.</p>
112 pub fn creator_request_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
113 self.inner = self.inner.creator_request_id(input.into());
114 self
115 }
116 /// <p>A unique string that identifies the request and that allows failed requests to be retried without the risk of running the operation twice. <code>CreatorRequestId</code> can be any unique string, for example, a date/time stamp.</p>
117 pub fn set_creator_request_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
118 self.inner = self.inner.set_creator_request_id(input);
119 self
120 }
121 /// <p>A unique string that identifies the request and that allows failed requests to be retried without the risk of running the operation twice. <code>CreatorRequestId</code> can be any unique string, for example, a date/time stamp.</p>
122 pub fn get_creator_request_id(&self) -> &::std::option::Option<::std::string::String> {
123 self.inner.get_creator_request_id()
124 }
125 /// <p>A friendly name that lets you easily find a rule in the Resolver dashboard in the Route 53 console.</p>
126 /// <p>The name can be up to 64 characters long and can contain letters (a-z, A-Z), numbers (0-9), hyphens (-), underscores (_), and spaces. The name cannot consist of only numbers.</p>
127 pub fn name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
128 self.inner = self.inner.name(input.into());
129 self
130 }
131 /// <p>A friendly name that lets you easily find a rule in the Resolver dashboard in the Route 53 console.</p>
132 /// <p>The name can be up to 64 characters long and can contain letters (a-z, A-Z), numbers (0-9), hyphens (-), underscores (_), and spaces. The name cannot consist of only numbers.</p>
133 pub fn set_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
134 self.inner = self.inner.set_name(input);
135 self
136 }
137 /// <p>A friendly name that lets you easily find a rule in the Resolver dashboard in the Route 53 console.</p>
138 /// <p>The name can be up to 64 characters long and can contain letters (a-z, A-Z), numbers (0-9), hyphens (-), underscores (_), and spaces. The name cannot consist of only numbers.</p>
139 pub fn get_name(&self) -> &::std::option::Option<::std::string::String> {
140 self.inner.get_name()
141 }
142 /// <p>When you want to forward DNS queries for specified domain name to resolvers on your network, specify <code>FORWARD</code> or <code>DELEGATE</code>.</p>
143 /// <p>When you have a forwarding rule to forward DNS queries for a domain to your network and you want Resolver to process queries for a subdomain of that domain, specify <code>SYSTEM</code>.</p>
144 /// <p>For example, to forward DNS queries for example.com to resolvers on your network, you create a rule and specify <code>FORWARD</code> for <code>RuleType</code>. To then have Resolver process queries for apex.example.com, you create a rule and specify <code>SYSTEM</code> for <code>RuleType</code>.</p>
145 /// <p>Currently, only Resolver can create rules that have a value of <code>RECURSIVE</code> for <code>RuleType</code>.</p>
146 pub fn rule_type(mut self, input: crate::types::RuleTypeOption) -> Self {
147 self.inner = self.inner.rule_type(input);
148 self
149 }
150 /// <p>When you want to forward DNS queries for specified domain name to resolvers on your network, specify <code>FORWARD</code> or <code>DELEGATE</code>.</p>
151 /// <p>When you have a forwarding rule to forward DNS queries for a domain to your network and you want Resolver to process queries for a subdomain of that domain, specify <code>SYSTEM</code>.</p>
152 /// <p>For example, to forward DNS queries for example.com to resolvers on your network, you create a rule and specify <code>FORWARD</code> for <code>RuleType</code>. To then have Resolver process queries for apex.example.com, you create a rule and specify <code>SYSTEM</code> for <code>RuleType</code>.</p>
153 /// <p>Currently, only Resolver can create rules that have a value of <code>RECURSIVE</code> for <code>RuleType</code>.</p>
154 pub fn set_rule_type(mut self, input: ::std::option::Option<crate::types::RuleTypeOption>) -> Self {
155 self.inner = self.inner.set_rule_type(input);
156 self
157 }
158 /// <p>When you want to forward DNS queries for specified domain name to resolvers on your network, specify <code>FORWARD</code> or <code>DELEGATE</code>.</p>
159 /// <p>When you have a forwarding rule to forward DNS queries for a domain to your network and you want Resolver to process queries for a subdomain of that domain, specify <code>SYSTEM</code>.</p>
160 /// <p>For example, to forward DNS queries for example.com to resolvers on your network, you create a rule and specify <code>FORWARD</code> for <code>RuleType</code>. To then have Resolver process queries for apex.example.com, you create a rule and specify <code>SYSTEM</code> for <code>RuleType</code>.</p>
161 /// <p>Currently, only Resolver can create rules that have a value of <code>RECURSIVE</code> for <code>RuleType</code>.</p>
162 pub fn get_rule_type(&self) -> &::std::option::Option<crate::types::RuleTypeOption> {
163 self.inner.get_rule_type()
164 }
165 /// <p>DNS queries for this domain name are forwarded to the IP addresses that you specify in <code>TargetIps</code>. If a query matches multiple Resolver rules (example.com and www.example.com), outbound DNS queries are routed using the Resolver rule that contains the most specific domain name (www.example.com).</p>
166 pub fn domain_name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
167 self.inner = self.inner.domain_name(input.into());
168 self
169 }
170 /// <p>DNS queries for this domain name are forwarded to the IP addresses that you specify in <code>TargetIps</code>. If a query matches multiple Resolver rules (example.com and www.example.com), outbound DNS queries are routed using the Resolver rule that contains the most specific domain name (www.example.com).</p>
171 pub fn set_domain_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
172 self.inner = self.inner.set_domain_name(input);
173 self
174 }
175 /// <p>DNS queries for this domain name are forwarded to the IP addresses that you specify in <code>TargetIps</code>. If a query matches multiple Resolver rules (example.com and www.example.com), outbound DNS queries are routed using the Resolver rule that contains the most specific domain name (www.example.com).</p>
176 pub fn get_domain_name(&self) -> &::std::option::Option<::std::string::String> {
177 self.inner.get_domain_name()
178 }
179 ///
180 /// Appends an item to `TargetIps`.
181 ///
182 /// To override the contents of this collection use [`set_target_ips`](Self::set_target_ips).
183 ///
184 /// <p>The IPs that you want Resolver to forward DNS queries to. You can specify either Ipv4 or Ipv6 addresses but not both in the same rule. Separate IP addresses with a space.</p>
185 /// <p><code>TargetIps</code> is available only when the value of <code>Rule type</code> is <code>FORWARD</code>. You should not provide TargetIps when the Rule type is <code>DELEGATE</code>.</p><note>
186 /// <p>when creating a DELEGATE rule, you must not provide the <code>TargetIps</code> parameter. If you provide the <code>TargetIps</code>, you may receive an ERROR message similar to "Delegate resolver rules need to specify a nameserver name". This error means you should not provide <code>TargetIps</code>.</p>
187 /// </note>
188 pub fn target_ips(mut self, input: crate::types::TargetAddress) -> Self {
189 self.inner = self.inner.target_ips(input);
190 self
191 }
192 /// <p>The IPs that you want Resolver to forward DNS queries to. You can specify either Ipv4 or Ipv6 addresses but not both in the same rule. Separate IP addresses with a space.</p>
193 /// <p><code>TargetIps</code> is available only when the value of <code>Rule type</code> is <code>FORWARD</code>. You should not provide TargetIps when the Rule type is <code>DELEGATE</code>.</p><note>
194 /// <p>when creating a DELEGATE rule, you must not provide the <code>TargetIps</code> parameter. If you provide the <code>TargetIps</code>, you may receive an ERROR message similar to "Delegate resolver rules need to specify a nameserver name". This error means you should not provide <code>TargetIps</code>.</p>
195 /// </note>
196 pub fn set_target_ips(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::TargetAddress>>) -> Self {
197 self.inner = self.inner.set_target_ips(input);
198 self
199 }
200 /// <p>The IPs that you want Resolver to forward DNS queries to. You can specify either Ipv4 or Ipv6 addresses but not both in the same rule. Separate IP addresses with a space.</p>
201 /// <p><code>TargetIps</code> is available only when the value of <code>Rule type</code> is <code>FORWARD</code>. You should not provide TargetIps when the Rule type is <code>DELEGATE</code>.</p><note>
202 /// <p>when creating a DELEGATE rule, you must not provide the <code>TargetIps</code> parameter. If you provide the <code>TargetIps</code>, you may receive an ERROR message similar to "Delegate resolver rules need to specify a nameserver name". This error means you should not provide <code>TargetIps</code>.</p>
203 /// </note>
204 pub fn get_target_ips(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::TargetAddress>> {
205 self.inner.get_target_ips()
206 }
207 /// <p>The ID of the outbound Resolver endpoint that you want to use to route DNS queries to the IP addresses that you specify in <code>TargetIps</code>.</p>
208 pub fn resolver_endpoint_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
209 self.inner = self.inner.resolver_endpoint_id(input.into());
210 self
211 }
212 /// <p>The ID of the outbound Resolver endpoint that you want to use to route DNS queries to the IP addresses that you specify in <code>TargetIps</code>.</p>
213 pub fn set_resolver_endpoint_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
214 self.inner = self.inner.set_resolver_endpoint_id(input);
215 self
216 }
217 /// <p>The ID of the outbound Resolver endpoint that you want to use to route DNS queries to the IP addresses that you specify in <code>TargetIps</code>.</p>
218 pub fn get_resolver_endpoint_id(&self) -> &::std::option::Option<::std::string::String> {
219 self.inner.get_resolver_endpoint_id()
220 }
221 ///
222 /// Appends an item to `Tags`.
223 ///
224 /// To override the contents of this collection use [`set_tags`](Self::set_tags).
225 ///
226 /// <p>A list of the tag keys and values that you want to associate with the endpoint.</p>
227 pub fn tags(mut self, input: crate::types::Tag) -> Self {
228 self.inner = self.inner.tags(input);
229 self
230 }
231 /// <p>A list of the tag keys and values that you want to associate with the endpoint.</p>
232 pub fn set_tags(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::Tag>>) -> Self {
233 self.inner = self.inner.set_tags(input);
234 self
235 }
236 /// <p>A list of the tag keys and values that you want to associate with the endpoint.</p>
237 pub fn get_tags(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::Tag>> {
238 self.inner.get_tags()
239 }
240 /// <p>DNS queries with the delegation records that match this domain name are forwarded to the resolvers on your network.</p>
241 pub fn delegation_record(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
242 self.inner = self.inner.delegation_record(input.into());
243 self
244 }
245 /// <p>DNS queries with the delegation records that match this domain name are forwarded to the resolvers on your network.</p>
246 pub fn set_delegation_record(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
247 self.inner = self.inner.set_delegation_record(input);
248 self
249 }
250 /// <p>DNS queries with the delegation records that match this domain name are forwarded to the resolvers on your network.</p>
251 pub fn get_delegation_record(&self) -> &::std::option::Option<::std::string::String> {
252 self.inner.get_delegation_record()
253 }
254}