aws_sdk_route53resolver/operation/create_resolver_query_log_config/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::create_resolver_query_log_config::_create_resolver_query_log_config_output::CreateResolverQueryLogConfigOutputBuilder;
3
4pub use crate::operation::create_resolver_query_log_config::_create_resolver_query_log_config_input::CreateResolverQueryLogConfigInputBuilder;
5
6impl crate::operation::create_resolver_query_log_config::builders::CreateResolverQueryLogConfigInputBuilder {
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_query_log_config::CreateResolverQueryLogConfigOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfigError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.create_resolver_query_log_config();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `CreateResolverQueryLogConfig`.
24///
25/// <p>Creates a Resolver query logging configuration, which defines where you want Resolver to save DNS query logs that originate in your VPCs. Resolver can log queries only for VPCs that are in the same Region as the query logging configuration.</p>
26/// <p>To specify which VPCs you want to log queries for, you use <code>AssociateResolverQueryLogConfig</code>. For more information, see <a href="https://docs.aws.amazon.com/Route53/latest/APIReference/API_route53resolver_AssociateResolverQueryLogConfig.html">AssociateResolverQueryLogConfig</a>.</p>
27/// <p>You can optionally use Resource Access Manager (RAM) to share a query logging configuration with other Amazon Web Services accounts. The other accounts can then associate VPCs with the configuration. The query logs that Resolver creates for a configuration include all DNS queries that originate in all VPCs that are associated with the configuration.</p>
28#[derive(::std::clone::Clone, ::std::fmt::Debug)]
29pub struct CreateResolverQueryLogConfigFluentBuilder {
30    handle: ::std::sync::Arc<crate::client::Handle>,
31    inner: crate::operation::create_resolver_query_log_config::builders::CreateResolverQueryLogConfigInputBuilder,
32    config_override: ::std::option::Option<crate::config::Builder>,
33}
34impl
35    crate::client::customize::internal::CustomizableSend<
36        crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfigOutput,
37        crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfigError,
38    > for CreateResolverQueryLogConfigFluentBuilder
39{
40    fn send(
41        self,
42        config_override: crate::config::Builder,
43    ) -> crate::client::customize::internal::BoxFuture<
44        crate::client::customize::internal::SendResult<
45            crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfigOutput,
46            crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfigError,
47        >,
48    > {
49        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
50    }
51}
52impl CreateResolverQueryLogConfigFluentBuilder {
53    /// Creates a new `CreateResolverQueryLogConfigFluentBuilder`.
54    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
55        Self {
56            handle,
57            inner: ::std::default::Default::default(),
58            config_override: ::std::option::Option::None,
59        }
60    }
61    /// Access the CreateResolverQueryLogConfig as a reference.
62    pub fn as_input(&self) -> &crate::operation::create_resolver_query_log_config::builders::CreateResolverQueryLogConfigInputBuilder {
63        &self.inner
64    }
65    /// Sends the request and returns the response.
66    ///
67    /// If an error occurs, an `SdkError` will be returned with additional details that
68    /// can be matched against.
69    ///
70    /// By default, any retryable failures will be retried twice. Retry behavior
71    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
72    /// set when configuring the client.
73    pub async fn send(
74        self,
75    ) -> ::std::result::Result<
76        crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfigOutput,
77        ::aws_smithy_runtime_api::client::result::SdkError<
78            crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfigError,
79            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
80        >,
81    > {
82        let input = self
83            .inner
84            .build()
85            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
86        let runtime_plugins = crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfig::operation_runtime_plugins(
87            self.handle.runtime_plugins.clone(),
88            &self.handle.conf,
89            self.config_override,
90        );
91        crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfig::orchestrate(&runtime_plugins, input).await
92    }
93
94    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
95    pub fn customize(
96        self,
97    ) -> crate::client::customize::CustomizableOperation<
98        crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfigOutput,
99        crate::operation::create_resolver_query_log_config::CreateResolverQueryLogConfigError,
100        Self,
101    > {
102        crate::client::customize::CustomizableOperation::new(self)
103    }
104    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
105        self.set_config_override(::std::option::Option::Some(config_override.into()));
106        self
107    }
108
109    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
110        self.config_override = config_override;
111        self
112    }
113    /// <p>The name that you want to give the query logging configuration.</p>
114    pub fn name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
115        self.inner = self.inner.name(input.into());
116        self
117    }
118    /// <p>The name that you want to give the query logging configuration.</p>
119    pub fn set_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
120        self.inner = self.inner.set_name(input);
121        self
122    }
123    /// <p>The name that you want to give the query logging configuration.</p>
124    pub fn get_name(&self) -> &::std::option::Option<::std::string::String> {
125        self.inner.get_name()
126    }
127    /// <p>The ARN of the resource that you want Resolver to send query logs. You can send query logs to an S3 bucket, a CloudWatch Logs log group, or a Kinesis Data Firehose delivery stream. Examples of valid values include the following:</p>
128    /// <ul>
129    /// <li>
130    /// <p><b>S3 bucket</b>:</p>
131    /// <p><code>arn:aws:s3:::amzn-s3-demo-bucket</code></p>
132    /// <p>You can optionally append a file prefix to the end of the ARN.</p>
133    /// <p><code>arn:aws:s3:::amzn-s3-demo-bucket/development/</code></p></li>
134    /// <li>
135    /// <p><b>CloudWatch Logs log group</b>:</p>
136    /// <p><code>arn:aws:logs:us-west-1:123456789012:log-group:/mystack-testgroup-12ABC1AB12A1:*</code></p></li>
137    /// <li>
138    /// <p><b>Kinesis Data Firehose delivery stream</b>:</p>
139    /// <p><code>arn:aws:kinesis:us-east-2:0123456789:stream/my_stream_name</code></p></li>
140    /// </ul>
141    pub fn destination_arn(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
142        self.inner = self.inner.destination_arn(input.into());
143        self
144    }
145    /// <p>The ARN of the resource that you want Resolver to send query logs. You can send query logs to an S3 bucket, a CloudWatch Logs log group, or a Kinesis Data Firehose delivery stream. Examples of valid values include the following:</p>
146    /// <ul>
147    /// <li>
148    /// <p><b>S3 bucket</b>:</p>
149    /// <p><code>arn:aws:s3:::amzn-s3-demo-bucket</code></p>
150    /// <p>You can optionally append a file prefix to the end of the ARN.</p>
151    /// <p><code>arn:aws:s3:::amzn-s3-demo-bucket/development/</code></p></li>
152    /// <li>
153    /// <p><b>CloudWatch Logs log group</b>:</p>
154    /// <p><code>arn:aws:logs:us-west-1:123456789012:log-group:/mystack-testgroup-12ABC1AB12A1:*</code></p></li>
155    /// <li>
156    /// <p><b>Kinesis Data Firehose delivery stream</b>:</p>
157    /// <p><code>arn:aws:kinesis:us-east-2:0123456789:stream/my_stream_name</code></p></li>
158    /// </ul>
159    pub fn set_destination_arn(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
160        self.inner = self.inner.set_destination_arn(input);
161        self
162    }
163    /// <p>The ARN of the resource that you want Resolver to send query logs. You can send query logs to an S3 bucket, a CloudWatch Logs log group, or a Kinesis Data Firehose delivery stream. Examples of valid values include the following:</p>
164    /// <ul>
165    /// <li>
166    /// <p><b>S3 bucket</b>:</p>
167    /// <p><code>arn:aws:s3:::amzn-s3-demo-bucket</code></p>
168    /// <p>You can optionally append a file prefix to the end of the ARN.</p>
169    /// <p><code>arn:aws:s3:::amzn-s3-demo-bucket/development/</code></p></li>
170    /// <li>
171    /// <p><b>CloudWatch Logs log group</b>:</p>
172    /// <p><code>arn:aws:logs:us-west-1:123456789012:log-group:/mystack-testgroup-12ABC1AB12A1:*</code></p></li>
173    /// <li>
174    /// <p><b>Kinesis Data Firehose delivery stream</b>:</p>
175    /// <p><code>arn:aws:kinesis:us-east-2:0123456789:stream/my_stream_name</code></p></li>
176    /// </ul>
177    pub fn get_destination_arn(&self) -> &::std::option::Option<::std::string::String> {
178        self.inner.get_destination_arn()
179    }
180    /// <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>
181    pub fn creator_request_id(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
182        self.inner = self.inner.creator_request_id(input.into());
183        self
184    }
185    /// <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>
186    pub fn set_creator_request_id(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
187        self.inner = self.inner.set_creator_request_id(input);
188        self
189    }
190    /// <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>
191    pub fn get_creator_request_id(&self) -> &::std::option::Option<::std::string::String> {
192        self.inner.get_creator_request_id()
193    }
194    ///
195    /// Appends an item to `Tags`.
196    ///
197    /// To override the contents of this collection use [`set_tags`](Self::set_tags).
198    ///
199    /// <p>A list of the tag keys and values that you want to associate with the query logging configuration.</p>
200    pub fn tags(mut self, input: crate::types::Tag) -> Self {
201        self.inner = self.inner.tags(input);
202        self
203    }
204    /// <p>A list of the tag keys and values that you want to associate with the query logging configuration.</p>
205    pub fn set_tags(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::Tag>>) -> Self {
206        self.inner = self.inner.set_tags(input);
207        self
208    }
209    /// <p>A list of the tag keys and values that you want to associate with the query logging configuration.</p>
210    pub fn get_tags(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::Tag>> {
211        self.inner.get_tags()
212    }
213}