aws_sdk_firehose/operation/create_delivery_stream/
builders.rs

1// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
2pub use crate::operation::create_delivery_stream::_create_delivery_stream_output::CreateDeliveryStreamOutputBuilder;
3
4pub use crate::operation::create_delivery_stream::_create_delivery_stream_input::CreateDeliveryStreamInputBuilder;
5
6impl crate::operation::create_delivery_stream::builders::CreateDeliveryStreamInputBuilder {
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_delivery_stream::CreateDeliveryStreamOutput,
13        ::aws_smithy_runtime_api::client::result::SdkError<
14            crate::operation::create_delivery_stream::CreateDeliveryStreamError,
15            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
16        >,
17    > {
18        let mut fluent_builder = client.create_delivery_stream();
19        fluent_builder.inner = self;
20        fluent_builder.send().await
21    }
22}
23/// Fluent builder constructing a request to `CreateDeliveryStream`.
24///
25/// <p>Creates a Firehose stream.</p>
26/// <p>By default, you can create up to 5,000 Firehose streams per Amazon Web Services Region.</p>
27/// <p>This is an asynchronous operation that immediately returns. The initial status of the Firehose stream is <code>CREATING</code>. After the Firehose stream is created, its status is <code>ACTIVE</code> and it now accepts data. If the Firehose stream creation fails, the status transitions to <code>CREATING_FAILED</code>. Attempts to send data to a delivery stream that is not in the <code>ACTIVE</code> state cause an exception. To check the state of a Firehose stream, use <code>DescribeDeliveryStream</code>.</p>
28/// <p>If the status of a Firehose stream is <code>CREATING_FAILED</code>, this status doesn't change, and you can't invoke <code>CreateDeliveryStream</code> again on it. However, you can invoke the <code>DeleteDeliveryStream</code> operation to delete it.</p>
29/// <p>A Firehose stream can be configured to receive records directly from providers using <code>PutRecord</code> or <code>PutRecordBatch</code>, or it can be configured to use an existing Kinesis stream as its source. To specify a Kinesis data stream as input, set the <code>DeliveryStreamType</code> parameter to <code>KinesisStreamAsSource</code>, and provide the Kinesis stream Amazon Resource Name (ARN) and role ARN in the <code>KinesisStreamSourceConfiguration</code> parameter.</p>
30/// <p>To create a Firehose stream with server-side encryption (SSE) enabled, include <code>DeliveryStreamEncryptionConfigurationInput</code> in your request. This is optional. You can also invoke <code>StartDeliveryStreamEncryption</code> to turn on SSE for an existing Firehose stream that doesn't have SSE enabled.</p>
31/// <p>A Firehose stream is configured with a single destination, such as Amazon Simple Storage Service (Amazon S3), Amazon Redshift, Amazon OpenSearch Service, Amazon OpenSearch Serverless, Splunk, and any custom HTTP endpoint or HTTP endpoints owned by or supported by third-party service providers, including Datadog, Dynatrace, LogicMonitor, MongoDB, New Relic, and Sumo Logic. You must specify only one of the following destination configuration parameters: <code>ExtendedS3DestinationConfiguration</code>, <code>S3DestinationConfiguration</code>, <code>ElasticsearchDestinationConfiguration</code>, <code>RedshiftDestinationConfiguration</code>, or <code>SplunkDestinationConfiguration</code>.</p>
32/// <p>When you specify <code>S3DestinationConfiguration</code>, you can also provide the following optional values: BufferingHints, <code>EncryptionConfiguration</code>, and <code>CompressionFormat</code>. By default, if no <code>BufferingHints</code> value is provided, Firehose buffers data up to 5 MB or for 5 minutes, whichever condition is satisfied first. <code>BufferingHints</code> is a hint, so there are some cases where the service cannot adhere to these conditions strictly. For example, record boundaries might be such that the size is a little over or under the configured buffering size. By default, no encryption is performed. We strongly recommend that you enable encryption to ensure secure data storage in Amazon S3.</p>
33/// <p>A few notes about Amazon Redshift as a destination:</p>
34/// <ul>
35/// <li>
36/// <p>An Amazon Redshift destination requires an S3 bucket as intermediate location. Firehose first delivers data to Amazon S3 and then uses <code>COPY</code> syntax to load data into an Amazon Redshift table. This is specified in the <code>RedshiftDestinationConfiguration.S3Configuration</code> parameter.</p></li>
37/// <li>
38/// <p>The compression formats <code>SNAPPY</code> or <code>ZIP</code> cannot be specified in <code>RedshiftDestinationConfiguration.S3Configuration</code> because the Amazon Redshift <code>COPY</code> operation that reads from the S3 bucket doesn't support these compression formats.</p></li>
39/// <li>
40/// <p>We strongly recommend that you use the user name and password you provide exclusively with Firehose, and that the permissions for the account are restricted for Amazon Redshift <code>INSERT</code> permissions.</p></li>
41/// </ul>
42/// <p>Firehose assumes the IAM role that is configured as part of the destination. The role should allow the Firehose principal to assume the role, and the role should have permissions that allow the service to deliver the data. For more information, see <a href="https://docs.aws.amazon.com/firehose/latest/dev/controlling-access.html#using-iam-s3">Grant Firehose Access to an Amazon S3 Destination</a> in the <i>Amazon Firehose Developer Guide</i>.</p>
43#[derive(::std::clone::Clone, ::std::fmt::Debug)]
44pub struct CreateDeliveryStreamFluentBuilder {
45    handle: ::std::sync::Arc<crate::client::Handle>,
46    inner: crate::operation::create_delivery_stream::builders::CreateDeliveryStreamInputBuilder,
47    config_override: ::std::option::Option<crate::config::Builder>,
48}
49impl
50    crate::client::customize::internal::CustomizableSend<
51        crate::operation::create_delivery_stream::CreateDeliveryStreamOutput,
52        crate::operation::create_delivery_stream::CreateDeliveryStreamError,
53    > for CreateDeliveryStreamFluentBuilder
54{
55    fn send(
56        self,
57        config_override: crate::config::Builder,
58    ) -> crate::client::customize::internal::BoxFuture<
59        crate::client::customize::internal::SendResult<
60            crate::operation::create_delivery_stream::CreateDeliveryStreamOutput,
61            crate::operation::create_delivery_stream::CreateDeliveryStreamError,
62        >,
63    > {
64        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
65    }
66}
67impl CreateDeliveryStreamFluentBuilder {
68    /// Creates a new `CreateDeliveryStreamFluentBuilder`.
69    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
70        Self {
71            handle,
72            inner: ::std::default::Default::default(),
73            config_override: ::std::option::Option::None,
74        }
75    }
76    /// Access the CreateDeliveryStream as a reference.
77    pub fn as_input(&self) -> &crate::operation::create_delivery_stream::builders::CreateDeliveryStreamInputBuilder {
78        &self.inner
79    }
80    /// Sends the request and returns the response.
81    ///
82    /// If an error occurs, an `SdkError` will be returned with additional details that
83    /// can be matched against.
84    ///
85    /// By default, any retryable failures will be retried twice. Retry behavior
86    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
87    /// set when configuring the client.
88    pub async fn send(
89        self,
90    ) -> ::std::result::Result<
91        crate::operation::create_delivery_stream::CreateDeliveryStreamOutput,
92        ::aws_smithy_runtime_api::client::result::SdkError<
93            crate::operation::create_delivery_stream::CreateDeliveryStreamError,
94            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
95        >,
96    > {
97        let input = self
98            .inner
99            .build()
100            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
101        let runtime_plugins = crate::operation::create_delivery_stream::CreateDeliveryStream::operation_runtime_plugins(
102            self.handle.runtime_plugins.clone(),
103            &self.handle.conf,
104            self.config_override,
105        );
106        crate::operation::create_delivery_stream::CreateDeliveryStream::orchestrate(&runtime_plugins, input).await
107    }
108
109    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
110    pub fn customize(
111        self,
112    ) -> crate::client::customize::CustomizableOperation<
113        crate::operation::create_delivery_stream::CreateDeliveryStreamOutput,
114        crate::operation::create_delivery_stream::CreateDeliveryStreamError,
115        Self,
116    > {
117        crate::client::customize::CustomizableOperation::new(self)
118    }
119    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
120        self.set_config_override(::std::option::Option::Some(config_override.into()));
121        self
122    }
123
124    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
125        self.config_override = config_override;
126        self
127    }
128    /// <p>The name of the Firehose stream. This name must be unique per Amazon Web Services account in the same Amazon Web Services Region. If the Firehose streams are in different accounts or different Regions, you can have multiple Firehose streams with the same name.</p>
129    pub fn delivery_stream_name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
130        self.inner = self.inner.delivery_stream_name(input.into());
131        self
132    }
133    /// <p>The name of the Firehose stream. This name must be unique per Amazon Web Services account in the same Amazon Web Services Region. If the Firehose streams are in different accounts or different Regions, you can have multiple Firehose streams with the same name.</p>
134    pub fn set_delivery_stream_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
135        self.inner = self.inner.set_delivery_stream_name(input);
136        self
137    }
138    /// <p>The name of the Firehose stream. This name must be unique per Amazon Web Services account in the same Amazon Web Services Region. If the Firehose streams are in different accounts or different Regions, you can have multiple Firehose streams with the same name.</p>
139    pub fn get_delivery_stream_name(&self) -> &::std::option::Option<::std::string::String> {
140        self.inner.get_delivery_stream_name()
141    }
142    /// <p>The Firehose stream type. This parameter can be one of the following values:</p>
143    /// <ul>
144    /// <li>
145    /// <p><code>DirectPut</code>: Provider applications access the Firehose stream directly.</p></li>
146    /// <li>
147    /// <p><code>KinesisStreamAsSource</code>: The Firehose stream uses a Kinesis data stream as a source.</p></li>
148    /// </ul>
149    pub fn delivery_stream_type(mut self, input: crate::types::DeliveryStreamType) -> Self {
150        self.inner = self.inner.delivery_stream_type(input);
151        self
152    }
153    /// <p>The Firehose stream type. This parameter can be one of the following values:</p>
154    /// <ul>
155    /// <li>
156    /// <p><code>DirectPut</code>: Provider applications access the Firehose stream directly.</p></li>
157    /// <li>
158    /// <p><code>KinesisStreamAsSource</code>: The Firehose stream uses a Kinesis data stream as a source.</p></li>
159    /// </ul>
160    pub fn set_delivery_stream_type(mut self, input: ::std::option::Option<crate::types::DeliveryStreamType>) -> Self {
161        self.inner = self.inner.set_delivery_stream_type(input);
162        self
163    }
164    /// <p>The Firehose stream type. This parameter can be one of the following values:</p>
165    /// <ul>
166    /// <li>
167    /// <p><code>DirectPut</code>: Provider applications access the Firehose stream directly.</p></li>
168    /// <li>
169    /// <p><code>KinesisStreamAsSource</code>: The Firehose stream uses a Kinesis data stream as a source.</p></li>
170    /// </ul>
171    pub fn get_delivery_stream_type(&self) -> &::std::option::Option<crate::types::DeliveryStreamType> {
172        self.inner.get_delivery_stream_type()
173    }
174    /// <p>The structure that configures parameters such as <code>ThroughputHintInMBs</code> for a stream configured with Direct PUT as a source.</p>
175    pub fn direct_put_source_configuration(mut self, input: crate::types::DirectPutSourceConfiguration) -> Self {
176        self.inner = self.inner.direct_put_source_configuration(input);
177        self
178    }
179    /// <p>The structure that configures parameters such as <code>ThroughputHintInMBs</code> for a stream configured with Direct PUT as a source.</p>
180    pub fn set_direct_put_source_configuration(mut self, input: ::std::option::Option<crate::types::DirectPutSourceConfiguration>) -> Self {
181        self.inner = self.inner.set_direct_put_source_configuration(input);
182        self
183    }
184    /// <p>The structure that configures parameters such as <code>ThroughputHintInMBs</code> for a stream configured with Direct PUT as a source.</p>
185    pub fn get_direct_put_source_configuration(&self) -> &::std::option::Option<crate::types::DirectPutSourceConfiguration> {
186        self.inner.get_direct_put_source_configuration()
187    }
188    /// <p>When a Kinesis data stream is used as the source for the Firehose stream, a <code>KinesisStreamSourceConfiguration</code> containing the Kinesis data stream Amazon Resource Name (ARN) and the role ARN for the source stream.</p>
189    pub fn kinesis_stream_source_configuration(mut self, input: crate::types::KinesisStreamSourceConfiguration) -> Self {
190        self.inner = self.inner.kinesis_stream_source_configuration(input);
191        self
192    }
193    /// <p>When a Kinesis data stream is used as the source for the Firehose stream, a <code>KinesisStreamSourceConfiguration</code> containing the Kinesis data stream Amazon Resource Name (ARN) and the role ARN for the source stream.</p>
194    pub fn set_kinesis_stream_source_configuration(mut self, input: ::std::option::Option<crate::types::KinesisStreamSourceConfiguration>) -> Self {
195        self.inner = self.inner.set_kinesis_stream_source_configuration(input);
196        self
197    }
198    /// <p>When a Kinesis data stream is used as the source for the Firehose stream, a <code>KinesisStreamSourceConfiguration</code> containing the Kinesis data stream Amazon Resource Name (ARN) and the role ARN for the source stream.</p>
199    pub fn get_kinesis_stream_source_configuration(&self) -> &::std::option::Option<crate::types::KinesisStreamSourceConfiguration> {
200        self.inner.get_kinesis_stream_source_configuration()
201    }
202    /// <p>Used to specify the type and Amazon Resource Name (ARN) of the KMS key needed for Server-Side Encryption (SSE).</p>
203    pub fn delivery_stream_encryption_configuration_input(mut self, input: crate::types::DeliveryStreamEncryptionConfigurationInput) -> Self {
204        self.inner = self.inner.delivery_stream_encryption_configuration_input(input);
205        self
206    }
207    /// <p>Used to specify the type and Amazon Resource Name (ARN) of the KMS key needed for Server-Side Encryption (SSE).</p>
208    pub fn set_delivery_stream_encryption_configuration_input(
209        mut self,
210        input: ::std::option::Option<crate::types::DeliveryStreamEncryptionConfigurationInput>,
211    ) -> Self {
212        self.inner = self.inner.set_delivery_stream_encryption_configuration_input(input);
213        self
214    }
215    /// <p>Used to specify the type and Amazon Resource Name (ARN) of the KMS key needed for Server-Side Encryption (SSE).</p>
216    pub fn get_delivery_stream_encryption_configuration_input(
217        &self,
218    ) -> &::std::option::Option<crate::types::DeliveryStreamEncryptionConfigurationInput> {
219        self.inner.get_delivery_stream_encryption_configuration_input()
220    }
221    /// <p>\[Deprecated\] The destination in Amazon S3. You can specify only one destination.</p>
222    #[deprecated]
223    pub fn s3_destination_configuration(mut self, input: crate::types::S3DestinationConfiguration) -> Self {
224        self.inner = self.inner.s3_destination_configuration(input);
225        self
226    }
227    /// <p>\[Deprecated\] The destination in Amazon S3. You can specify only one destination.</p>
228    #[deprecated]
229    pub fn set_s3_destination_configuration(mut self, input: ::std::option::Option<crate::types::S3DestinationConfiguration>) -> Self {
230        self.inner = self.inner.set_s3_destination_configuration(input);
231        self
232    }
233    /// <p>\[Deprecated\] The destination in Amazon S3. You can specify only one destination.</p>
234    #[deprecated]
235    pub fn get_s3_destination_configuration(&self) -> &::std::option::Option<crate::types::S3DestinationConfiguration> {
236        self.inner.get_s3_destination_configuration()
237    }
238    /// <p>The destination in Amazon S3. You can specify only one destination.</p>
239    pub fn extended_s3_destination_configuration(mut self, input: crate::types::ExtendedS3DestinationConfiguration) -> Self {
240        self.inner = self.inner.extended_s3_destination_configuration(input);
241        self
242    }
243    /// <p>The destination in Amazon S3. You can specify only one destination.</p>
244    pub fn set_extended_s3_destination_configuration(
245        mut self,
246        input: ::std::option::Option<crate::types::ExtendedS3DestinationConfiguration>,
247    ) -> Self {
248        self.inner = self.inner.set_extended_s3_destination_configuration(input);
249        self
250    }
251    /// <p>The destination in Amazon S3. You can specify only one destination.</p>
252    pub fn get_extended_s3_destination_configuration(&self) -> &::std::option::Option<crate::types::ExtendedS3DestinationConfiguration> {
253        self.inner.get_extended_s3_destination_configuration()
254    }
255    /// <p>The destination in Amazon Redshift. You can specify only one destination.</p>
256    pub fn redshift_destination_configuration(mut self, input: crate::types::RedshiftDestinationConfiguration) -> Self {
257        self.inner = self.inner.redshift_destination_configuration(input);
258        self
259    }
260    /// <p>The destination in Amazon Redshift. You can specify only one destination.</p>
261    pub fn set_redshift_destination_configuration(mut self, input: ::std::option::Option<crate::types::RedshiftDestinationConfiguration>) -> Self {
262        self.inner = self.inner.set_redshift_destination_configuration(input);
263        self
264    }
265    /// <p>The destination in Amazon Redshift. You can specify only one destination.</p>
266    pub fn get_redshift_destination_configuration(&self) -> &::std::option::Option<crate::types::RedshiftDestinationConfiguration> {
267        self.inner.get_redshift_destination_configuration()
268    }
269    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
270    pub fn elasticsearch_destination_configuration(mut self, input: crate::types::ElasticsearchDestinationConfiguration) -> Self {
271        self.inner = self.inner.elasticsearch_destination_configuration(input);
272        self
273    }
274    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
275    pub fn set_elasticsearch_destination_configuration(
276        mut self,
277        input: ::std::option::Option<crate::types::ElasticsearchDestinationConfiguration>,
278    ) -> Self {
279        self.inner = self.inner.set_elasticsearch_destination_configuration(input);
280        self
281    }
282    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
283    pub fn get_elasticsearch_destination_configuration(&self) -> &::std::option::Option<crate::types::ElasticsearchDestinationConfiguration> {
284        self.inner.get_elasticsearch_destination_configuration()
285    }
286    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
287    pub fn amazonopensearchservice_destination_configuration(mut self, input: crate::types::AmazonopensearchserviceDestinationConfiguration) -> Self {
288        self.inner = self.inner.amazonopensearchservice_destination_configuration(input);
289        self
290    }
291    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
292    pub fn set_amazonopensearchservice_destination_configuration(
293        mut self,
294        input: ::std::option::Option<crate::types::AmazonopensearchserviceDestinationConfiguration>,
295    ) -> Self {
296        self.inner = self.inner.set_amazonopensearchservice_destination_configuration(input);
297        self
298    }
299    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
300    pub fn get_amazonopensearchservice_destination_configuration(
301        &self,
302    ) -> &::std::option::Option<crate::types::AmazonopensearchserviceDestinationConfiguration> {
303        self.inner.get_amazonopensearchservice_destination_configuration()
304    }
305    /// <p>The destination in Splunk. You can specify only one destination.</p>
306    pub fn splunk_destination_configuration(mut self, input: crate::types::SplunkDestinationConfiguration) -> Self {
307        self.inner = self.inner.splunk_destination_configuration(input);
308        self
309    }
310    /// <p>The destination in Splunk. You can specify only one destination.</p>
311    pub fn set_splunk_destination_configuration(mut self, input: ::std::option::Option<crate::types::SplunkDestinationConfiguration>) -> Self {
312        self.inner = self.inner.set_splunk_destination_configuration(input);
313        self
314    }
315    /// <p>The destination in Splunk. You can specify only one destination.</p>
316    pub fn get_splunk_destination_configuration(&self) -> &::std::option::Option<crate::types::SplunkDestinationConfiguration> {
317        self.inner.get_splunk_destination_configuration()
318    }
319    /// <p>Enables configuring Kinesis Firehose to deliver data to any HTTP endpoint destination. You can specify only one destination.</p>
320    pub fn http_endpoint_destination_configuration(mut self, input: crate::types::HttpEndpointDestinationConfiguration) -> Self {
321        self.inner = self.inner.http_endpoint_destination_configuration(input);
322        self
323    }
324    /// <p>Enables configuring Kinesis Firehose to deliver data to any HTTP endpoint destination. You can specify only one destination.</p>
325    pub fn set_http_endpoint_destination_configuration(
326        mut self,
327        input: ::std::option::Option<crate::types::HttpEndpointDestinationConfiguration>,
328    ) -> Self {
329        self.inner = self.inner.set_http_endpoint_destination_configuration(input);
330        self
331    }
332    /// <p>Enables configuring Kinesis Firehose to deliver data to any HTTP endpoint destination. You can specify only one destination.</p>
333    pub fn get_http_endpoint_destination_configuration(&self) -> &::std::option::Option<crate::types::HttpEndpointDestinationConfiguration> {
334        self.inner.get_http_endpoint_destination_configuration()
335    }
336    ///
337    /// Appends an item to `Tags`.
338    ///
339    /// To override the contents of this collection use [`set_tags`](Self::set_tags).
340    ///
341    /// <p>A set of tags to assign to the Firehose stream. A tag is a key-value pair that you can define and assign to Amazon Web Services resources. Tags are metadata. For example, you can add friendly names and descriptions or other types of information that can help you distinguish the Firehose stream. For more information about tags, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html">Using Cost Allocation Tags</a> in the Amazon Web Services Billing and Cost Management User Guide.</p>
342    /// <p>You can specify up to 50 tags when creating a Firehose stream.</p>
343    /// <p>If you specify tags in the <code>CreateDeliveryStream</code> action, Amazon Data Firehose performs an additional authorization on the <code>firehose:TagDeliveryStream</code> action to verify if users have permissions to create tags. If you do not provide this permission, requests to create new Firehose streams with IAM resource tags will fail with an <code>AccessDeniedException</code> such as following.</p>
344    /// <p><b>AccessDeniedException</b></p>
345    /// <p>User: arn:aws:sts::x:assumed-role/x/x is not authorized to perform: firehose:TagDeliveryStream on resource: arn:aws:firehose:us-east-1:x:deliverystream/x with an explicit deny in an identity-based policy.</p>
346    /// <p>For an example IAM policy, see <a href="https://docs.aws.amazon.com/firehose/latest/APIReference/API_CreateDeliveryStream.html#API_CreateDeliveryStream_Examples">Tag example.</a></p>
347    pub fn tags(mut self, input: crate::types::Tag) -> Self {
348        self.inner = self.inner.tags(input);
349        self
350    }
351    /// <p>A set of tags to assign to the Firehose stream. A tag is a key-value pair that you can define and assign to Amazon Web Services resources. Tags are metadata. For example, you can add friendly names and descriptions or other types of information that can help you distinguish the Firehose stream. For more information about tags, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html">Using Cost Allocation Tags</a> in the Amazon Web Services Billing and Cost Management User Guide.</p>
352    /// <p>You can specify up to 50 tags when creating a Firehose stream.</p>
353    /// <p>If you specify tags in the <code>CreateDeliveryStream</code> action, Amazon Data Firehose performs an additional authorization on the <code>firehose:TagDeliveryStream</code> action to verify if users have permissions to create tags. If you do not provide this permission, requests to create new Firehose streams with IAM resource tags will fail with an <code>AccessDeniedException</code> such as following.</p>
354    /// <p><b>AccessDeniedException</b></p>
355    /// <p>User: arn:aws:sts::x:assumed-role/x/x is not authorized to perform: firehose:TagDeliveryStream on resource: arn:aws:firehose:us-east-1:x:deliverystream/x with an explicit deny in an identity-based policy.</p>
356    /// <p>For an example IAM policy, see <a href="https://docs.aws.amazon.com/firehose/latest/APIReference/API_CreateDeliveryStream.html#API_CreateDeliveryStream_Examples">Tag example.</a></p>
357    pub fn set_tags(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::Tag>>) -> Self {
358        self.inner = self.inner.set_tags(input);
359        self
360    }
361    /// <p>A set of tags to assign to the Firehose stream. A tag is a key-value pair that you can define and assign to Amazon Web Services resources. Tags are metadata. For example, you can add friendly names and descriptions or other types of information that can help you distinguish the Firehose stream. For more information about tags, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html">Using Cost Allocation Tags</a> in the Amazon Web Services Billing and Cost Management User Guide.</p>
362    /// <p>You can specify up to 50 tags when creating a Firehose stream.</p>
363    /// <p>If you specify tags in the <code>CreateDeliveryStream</code> action, Amazon Data Firehose performs an additional authorization on the <code>firehose:TagDeliveryStream</code> action to verify if users have permissions to create tags. If you do not provide this permission, requests to create new Firehose streams with IAM resource tags will fail with an <code>AccessDeniedException</code> such as following.</p>
364    /// <p><b>AccessDeniedException</b></p>
365    /// <p>User: arn:aws:sts::x:assumed-role/x/x is not authorized to perform: firehose:TagDeliveryStream on resource: arn:aws:firehose:us-east-1:x:deliverystream/x with an explicit deny in an identity-based policy.</p>
366    /// <p>For an example IAM policy, see <a href="https://docs.aws.amazon.com/firehose/latest/APIReference/API_CreateDeliveryStream.html#API_CreateDeliveryStream_Examples">Tag example.</a></p>
367    pub fn get_tags(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::Tag>> {
368        self.inner.get_tags()
369    }
370    /// <p>The destination in the Serverless offering for Amazon OpenSearch Service. You can specify only one destination.</p>
371    pub fn amazon_open_search_serverless_destination_configuration(
372        mut self,
373        input: crate::types::AmazonOpenSearchServerlessDestinationConfiguration,
374    ) -> Self {
375        self.inner = self.inner.amazon_open_search_serverless_destination_configuration(input);
376        self
377    }
378    /// <p>The destination in the Serverless offering for Amazon OpenSearch Service. You can specify only one destination.</p>
379    pub fn set_amazon_open_search_serverless_destination_configuration(
380        mut self,
381        input: ::std::option::Option<crate::types::AmazonOpenSearchServerlessDestinationConfiguration>,
382    ) -> Self {
383        self.inner = self.inner.set_amazon_open_search_serverless_destination_configuration(input);
384        self
385    }
386    /// <p>The destination in the Serverless offering for Amazon OpenSearch Service. You can specify only one destination.</p>
387    pub fn get_amazon_open_search_serverless_destination_configuration(
388        &self,
389    ) -> &::std::option::Option<crate::types::AmazonOpenSearchServerlessDestinationConfiguration> {
390        self.inner.get_amazon_open_search_serverless_destination_configuration()
391    }
392    /// <p>The configuration for the Amazon MSK cluster to be used as the source for a delivery stream.</p>
393    pub fn msk_source_configuration(mut self, input: crate::types::MskSourceConfiguration) -> Self {
394        self.inner = self.inner.msk_source_configuration(input);
395        self
396    }
397    /// <p>The configuration for the Amazon MSK cluster to be used as the source for a delivery stream.</p>
398    pub fn set_msk_source_configuration(mut self, input: ::std::option::Option<crate::types::MskSourceConfiguration>) -> Self {
399        self.inner = self.inner.set_msk_source_configuration(input);
400        self
401    }
402    /// <p>The configuration for the Amazon MSK cluster to be used as the source for a delivery stream.</p>
403    pub fn get_msk_source_configuration(&self) -> &::std::option::Option<crate::types::MskSourceConfiguration> {
404        self.inner.get_msk_source_configuration()
405    }
406    /// <p>Configure Snowflake destination</p>
407    pub fn snowflake_destination_configuration(mut self, input: crate::types::SnowflakeDestinationConfiguration) -> Self {
408        self.inner = self.inner.snowflake_destination_configuration(input);
409        self
410    }
411    /// <p>Configure Snowflake destination</p>
412    pub fn set_snowflake_destination_configuration(mut self, input: ::std::option::Option<crate::types::SnowflakeDestinationConfiguration>) -> Self {
413        self.inner = self.inner.set_snowflake_destination_configuration(input);
414        self
415    }
416    /// <p>Configure Snowflake destination</p>
417    pub fn get_snowflake_destination_configuration(&self) -> &::std::option::Option<crate::types::SnowflakeDestinationConfiguration> {
418        self.inner.get_snowflake_destination_configuration()
419    }
420    /// <p>Configure Apache Iceberg Tables destination.</p>
421    pub fn iceberg_destination_configuration(mut self, input: crate::types::IcebergDestinationConfiguration) -> Self {
422        self.inner = self.inner.iceberg_destination_configuration(input);
423        self
424    }
425    /// <p>Configure Apache Iceberg Tables destination.</p>
426    pub fn set_iceberg_destination_configuration(mut self, input: ::std::option::Option<crate::types::IcebergDestinationConfiguration>) -> Self {
427        self.inner = self.inner.set_iceberg_destination_configuration(input);
428        self
429    }
430    /// <p>Configure Apache Iceberg Tables destination.</p>
431    pub fn get_iceberg_destination_configuration(&self) -> &::std::option::Option<crate::types::IcebergDestinationConfiguration> {
432        self.inner.get_iceberg_destination_configuration()
433    }
434    /// <p>The top level object for configuring streams with database as a source.</p>
435    /// <p>Amazon Data Firehose is in preview release and is subject to change.</p>
436    pub fn database_source_configuration(mut self, input: crate::types::DatabaseSourceConfiguration) -> Self {
437        self.inner = self.inner.database_source_configuration(input);
438        self
439    }
440    /// <p>The top level object for configuring streams with database as a source.</p>
441    /// <p>Amazon Data Firehose is in preview release and is subject to change.</p>
442    pub fn set_database_source_configuration(mut self, input: ::std::option::Option<crate::types::DatabaseSourceConfiguration>) -> Self {
443        self.inner = self.inner.set_database_source_configuration(input);
444        self
445    }
446    /// <p>The top level object for configuring streams with database as a source.</p>
447    /// <p>Amazon Data Firehose is in preview release and is subject to change.</p>
448    pub fn get_database_source_configuration(&self) -> &::std::option::Option<crate::types::DatabaseSourceConfiguration> {
449        self.inner.get_database_source_configuration()
450    }
451}