aws-sdk-firehose 1.100.0

AWS SDK for Amazon Kinesis Firehose
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
// Code generated by software.amazon.smithy.rust.codegen.smithy-rs. DO NOT EDIT.
pub use crate::operation::create_delivery_stream::_create_delivery_stream_output::CreateDeliveryStreamOutputBuilder;

pub use crate::operation::create_delivery_stream::_create_delivery_stream_input::CreateDeliveryStreamInputBuilder;

impl crate::operation::create_delivery_stream::builders::CreateDeliveryStreamInputBuilder {
    /// Sends a request with this input using the given client.
    pub async fn send_with(
        self,
        client: &crate::Client,
    ) -> ::std::result::Result<
        crate::operation::create_delivery_stream::CreateDeliveryStreamOutput,
        ::aws_smithy_runtime_api::client::result::SdkError<
            crate::operation::create_delivery_stream::CreateDeliveryStreamError,
            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
        >,
    > {
        let mut fluent_builder = client.create_delivery_stream();
        fluent_builder.inner = self;
        fluent_builder.send().await
    }
}
/// Fluent builder constructing a request to `CreateDeliveryStream`.
///
/// <p>Creates a Firehose stream.</p>
/// <p>By default, you can create up to 5,000 Firehose streams per Amazon Web Services Region.</p>
/// <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>
/// <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>
/// <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>
/// <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>
/// <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>
/// <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>
/// <p>A few notes about Amazon Redshift as a destination:</p>
/// <ul>
/// <li>
/// <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>
/// <li>
/// <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>
/// <li>
/// <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>
/// </ul>
/// <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>
#[derive(::std::clone::Clone, ::std::fmt::Debug)]
pub struct CreateDeliveryStreamFluentBuilder {
    handle: ::std::sync::Arc<crate::client::Handle>,
    inner: crate::operation::create_delivery_stream::builders::CreateDeliveryStreamInputBuilder,
    config_override: ::std::option::Option<crate::config::Builder>,
}
impl
    crate::client::customize::internal::CustomizableSend<
        crate::operation::create_delivery_stream::CreateDeliveryStreamOutput,
        crate::operation::create_delivery_stream::CreateDeliveryStreamError,
    > for CreateDeliveryStreamFluentBuilder
{
    fn send(
        self,
        config_override: crate::config::Builder,
    ) -> crate::client::customize::internal::BoxFuture<
        crate::client::customize::internal::SendResult<
            crate::operation::create_delivery_stream::CreateDeliveryStreamOutput,
            crate::operation::create_delivery_stream::CreateDeliveryStreamError,
        >,
    > {
        ::std::boxed::Box::pin(async move { self.config_override(config_override).send().await })
    }
}
impl CreateDeliveryStreamFluentBuilder {
    /// Creates a new `CreateDeliveryStreamFluentBuilder`.
    pub(crate) fn new(handle: ::std::sync::Arc<crate::client::Handle>) -> Self {
        Self {
            handle,
            inner: ::std::default::Default::default(),
            config_override: ::std::option::Option::None,
        }
    }
    /// Access the CreateDeliveryStream as a reference.
    pub fn as_input(&self) -> &crate::operation::create_delivery_stream::builders::CreateDeliveryStreamInputBuilder {
        &self.inner
    }
    /// Sends the request and returns the response.
    ///
    /// If an error occurs, an `SdkError` will be returned with additional details that
    /// can be matched against.
    ///
    /// By default, any retryable failures will be retried twice. Retry behavior
    /// is configurable with the [RetryConfig](aws_smithy_types::retry::RetryConfig), which can be
    /// set when configuring the client.
    pub async fn send(
        self,
    ) -> ::std::result::Result<
        crate::operation::create_delivery_stream::CreateDeliveryStreamOutput,
        ::aws_smithy_runtime_api::client::result::SdkError<
            crate::operation::create_delivery_stream::CreateDeliveryStreamError,
            ::aws_smithy_runtime_api::client::orchestrator::HttpResponse,
        >,
    > {
        let input = self
            .inner
            .build()
            .map_err(::aws_smithy_runtime_api::client::result::SdkError::construction_failure)?;
        let runtime_plugins = crate::operation::create_delivery_stream::CreateDeliveryStream::operation_runtime_plugins(
            self.handle.runtime_plugins.clone(),
            &self.handle.conf,
            self.config_override,
        );
        crate::operation::create_delivery_stream::CreateDeliveryStream::orchestrate(&runtime_plugins, input).await
    }

    /// Consumes this builder, creating a customizable operation that can be modified before being sent.
    pub fn customize(
        self,
    ) -> crate::client::customize::CustomizableOperation<
        crate::operation::create_delivery_stream::CreateDeliveryStreamOutput,
        crate::operation::create_delivery_stream::CreateDeliveryStreamError,
        Self,
    > {
        crate::client::customize::CustomizableOperation::new(self)
    }
    pub(crate) fn config_override(mut self, config_override: impl ::std::convert::Into<crate::config::Builder>) -> Self {
        self.set_config_override(::std::option::Option::Some(config_override.into()));
        self
    }

    pub(crate) fn set_config_override(&mut self, config_override: ::std::option::Option<crate::config::Builder>) -> &mut Self {
        self.config_override = config_override;
        self
    }
    /// <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>
    pub fn delivery_stream_name(mut self, input: impl ::std::convert::Into<::std::string::String>) -> Self {
        self.inner = self.inner.delivery_stream_name(input.into());
        self
    }
    /// <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>
    pub fn set_delivery_stream_name(mut self, input: ::std::option::Option<::std::string::String>) -> Self {
        self.inner = self.inner.set_delivery_stream_name(input);
        self
    }
    /// <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>
    pub fn get_delivery_stream_name(&self) -> &::std::option::Option<::std::string::String> {
        self.inner.get_delivery_stream_name()
    }
    /// <p>The Firehose stream type. This parameter can be one of the following values:</p>
    /// <ul>
    /// <li>
    /// <p><code>DirectPut</code>: Provider applications access the Firehose stream directly.</p></li>
    /// <li>
    /// <p><code>KinesisStreamAsSource</code>: The Firehose stream uses a Kinesis data stream as a source.</p></li>
    /// </ul>
    pub fn delivery_stream_type(mut self, input: crate::types::DeliveryStreamType) -> Self {
        self.inner = self.inner.delivery_stream_type(input);
        self
    }
    /// <p>The Firehose stream type. This parameter can be one of the following values:</p>
    /// <ul>
    /// <li>
    /// <p><code>DirectPut</code>: Provider applications access the Firehose stream directly.</p></li>
    /// <li>
    /// <p><code>KinesisStreamAsSource</code>: The Firehose stream uses a Kinesis data stream as a source.</p></li>
    /// </ul>
    pub fn set_delivery_stream_type(mut self, input: ::std::option::Option<crate::types::DeliveryStreamType>) -> Self {
        self.inner = self.inner.set_delivery_stream_type(input);
        self
    }
    /// <p>The Firehose stream type. This parameter can be one of the following values:</p>
    /// <ul>
    /// <li>
    /// <p><code>DirectPut</code>: Provider applications access the Firehose stream directly.</p></li>
    /// <li>
    /// <p><code>KinesisStreamAsSource</code>: The Firehose stream uses a Kinesis data stream as a source.</p></li>
    /// </ul>
    pub fn get_delivery_stream_type(&self) -> &::std::option::Option<crate::types::DeliveryStreamType> {
        self.inner.get_delivery_stream_type()
    }
    /// <p>The structure that configures parameters such as <code>ThroughputHintInMBs</code> for a stream configured with Direct PUT as a source.</p>
    pub fn direct_put_source_configuration(mut self, input: crate::types::DirectPutSourceConfiguration) -> Self {
        self.inner = self.inner.direct_put_source_configuration(input);
        self
    }
    /// <p>The structure that configures parameters such as <code>ThroughputHintInMBs</code> for a stream configured with Direct PUT as a source.</p>
    pub fn set_direct_put_source_configuration(mut self, input: ::std::option::Option<crate::types::DirectPutSourceConfiguration>) -> Self {
        self.inner = self.inner.set_direct_put_source_configuration(input);
        self
    }
    /// <p>The structure that configures parameters such as <code>ThroughputHintInMBs</code> for a stream configured with Direct PUT as a source.</p>
    pub fn get_direct_put_source_configuration(&self) -> &::std::option::Option<crate::types::DirectPutSourceConfiguration> {
        self.inner.get_direct_put_source_configuration()
    }
    /// <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>
    pub fn kinesis_stream_source_configuration(mut self, input: crate::types::KinesisStreamSourceConfiguration) -> Self {
        self.inner = self.inner.kinesis_stream_source_configuration(input);
        self
    }
    /// <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>
    pub fn set_kinesis_stream_source_configuration(mut self, input: ::std::option::Option<crate::types::KinesisStreamSourceConfiguration>) -> Self {
        self.inner = self.inner.set_kinesis_stream_source_configuration(input);
        self
    }
    /// <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>
    pub fn get_kinesis_stream_source_configuration(&self) -> &::std::option::Option<crate::types::KinesisStreamSourceConfiguration> {
        self.inner.get_kinesis_stream_source_configuration()
    }
    /// <p>Used to specify the type and Amazon Resource Name (ARN) of the KMS key needed for Server-Side Encryption (SSE).</p>
    pub fn delivery_stream_encryption_configuration_input(mut self, input: crate::types::DeliveryStreamEncryptionConfigurationInput) -> Self {
        self.inner = self.inner.delivery_stream_encryption_configuration_input(input);
        self
    }
    /// <p>Used to specify the type and Amazon Resource Name (ARN) of the KMS key needed for Server-Side Encryption (SSE).</p>
    pub fn set_delivery_stream_encryption_configuration_input(
        mut self,
        input: ::std::option::Option<crate::types::DeliveryStreamEncryptionConfigurationInput>,
    ) -> Self {
        self.inner = self.inner.set_delivery_stream_encryption_configuration_input(input);
        self
    }
    /// <p>Used to specify the type and Amazon Resource Name (ARN) of the KMS key needed for Server-Side Encryption (SSE).</p>
    pub fn get_delivery_stream_encryption_configuration_input(
        &self,
    ) -> &::std::option::Option<crate::types::DeliveryStreamEncryptionConfigurationInput> {
        self.inner.get_delivery_stream_encryption_configuration_input()
    }
    /// <p>\[Deprecated\] The destination in Amazon S3. You can specify only one destination.</p>
    #[deprecated]
    pub fn s3_destination_configuration(mut self, input: crate::types::S3DestinationConfiguration) -> Self {
        self.inner = self.inner.s3_destination_configuration(input);
        self
    }
    /// <p>\[Deprecated\] The destination in Amazon S3. You can specify only one destination.</p>
    #[deprecated]
    pub fn set_s3_destination_configuration(mut self, input: ::std::option::Option<crate::types::S3DestinationConfiguration>) -> Self {
        self.inner = self.inner.set_s3_destination_configuration(input);
        self
    }
    /// <p>\[Deprecated\] The destination in Amazon S3. You can specify only one destination.</p>
    #[deprecated]
    pub fn get_s3_destination_configuration(&self) -> &::std::option::Option<crate::types::S3DestinationConfiguration> {
        self.inner.get_s3_destination_configuration()
    }
    /// <p>The destination in Amazon S3. You can specify only one destination.</p>
    pub fn extended_s3_destination_configuration(mut self, input: crate::types::ExtendedS3DestinationConfiguration) -> Self {
        self.inner = self.inner.extended_s3_destination_configuration(input);
        self
    }
    /// <p>The destination in Amazon S3. You can specify only one destination.</p>
    pub fn set_extended_s3_destination_configuration(
        mut self,
        input: ::std::option::Option<crate::types::ExtendedS3DestinationConfiguration>,
    ) -> Self {
        self.inner = self.inner.set_extended_s3_destination_configuration(input);
        self
    }
    /// <p>The destination in Amazon S3. You can specify only one destination.</p>
    pub fn get_extended_s3_destination_configuration(&self) -> &::std::option::Option<crate::types::ExtendedS3DestinationConfiguration> {
        self.inner.get_extended_s3_destination_configuration()
    }
    /// <p>The destination in Amazon Redshift. You can specify only one destination.</p>
    pub fn redshift_destination_configuration(mut self, input: crate::types::RedshiftDestinationConfiguration) -> Self {
        self.inner = self.inner.redshift_destination_configuration(input);
        self
    }
    /// <p>The destination in Amazon Redshift. You can specify only one destination.</p>
    pub fn set_redshift_destination_configuration(mut self, input: ::std::option::Option<crate::types::RedshiftDestinationConfiguration>) -> Self {
        self.inner = self.inner.set_redshift_destination_configuration(input);
        self
    }
    /// <p>The destination in Amazon Redshift. You can specify only one destination.</p>
    pub fn get_redshift_destination_configuration(&self) -> &::std::option::Option<crate::types::RedshiftDestinationConfiguration> {
        self.inner.get_redshift_destination_configuration()
    }
    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
    pub fn elasticsearch_destination_configuration(mut self, input: crate::types::ElasticsearchDestinationConfiguration) -> Self {
        self.inner = self.inner.elasticsearch_destination_configuration(input);
        self
    }
    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
    pub fn set_elasticsearch_destination_configuration(
        mut self,
        input: ::std::option::Option<crate::types::ElasticsearchDestinationConfiguration>,
    ) -> Self {
        self.inner = self.inner.set_elasticsearch_destination_configuration(input);
        self
    }
    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
    pub fn get_elasticsearch_destination_configuration(&self) -> &::std::option::Option<crate::types::ElasticsearchDestinationConfiguration> {
        self.inner.get_elasticsearch_destination_configuration()
    }
    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
    pub fn amazonopensearchservice_destination_configuration(mut self, input: crate::types::AmazonopensearchserviceDestinationConfiguration) -> Self {
        self.inner = self.inner.amazonopensearchservice_destination_configuration(input);
        self
    }
    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
    pub fn set_amazonopensearchservice_destination_configuration(
        mut self,
        input: ::std::option::Option<crate::types::AmazonopensearchserviceDestinationConfiguration>,
    ) -> Self {
        self.inner = self.inner.set_amazonopensearchservice_destination_configuration(input);
        self
    }
    /// <p>The destination in Amazon OpenSearch Service. You can specify only one destination.</p>
    pub fn get_amazonopensearchservice_destination_configuration(
        &self,
    ) -> &::std::option::Option<crate::types::AmazonopensearchserviceDestinationConfiguration> {
        self.inner.get_amazonopensearchservice_destination_configuration()
    }
    /// <p>The destination in Splunk. You can specify only one destination.</p>
    pub fn splunk_destination_configuration(mut self, input: crate::types::SplunkDestinationConfiguration) -> Self {
        self.inner = self.inner.splunk_destination_configuration(input);
        self
    }
    /// <p>The destination in Splunk. You can specify only one destination.</p>
    pub fn set_splunk_destination_configuration(mut self, input: ::std::option::Option<crate::types::SplunkDestinationConfiguration>) -> Self {
        self.inner = self.inner.set_splunk_destination_configuration(input);
        self
    }
    /// <p>The destination in Splunk. You can specify only one destination.</p>
    pub fn get_splunk_destination_configuration(&self) -> &::std::option::Option<crate::types::SplunkDestinationConfiguration> {
        self.inner.get_splunk_destination_configuration()
    }
    /// <p>Enables configuring Kinesis Firehose to deliver data to any HTTP endpoint destination. You can specify only one destination.</p>
    pub fn http_endpoint_destination_configuration(mut self, input: crate::types::HttpEndpointDestinationConfiguration) -> Self {
        self.inner = self.inner.http_endpoint_destination_configuration(input);
        self
    }
    /// <p>Enables configuring Kinesis Firehose to deliver data to any HTTP endpoint destination. You can specify only one destination.</p>
    pub fn set_http_endpoint_destination_configuration(
        mut self,
        input: ::std::option::Option<crate::types::HttpEndpointDestinationConfiguration>,
    ) -> Self {
        self.inner = self.inner.set_http_endpoint_destination_configuration(input);
        self
    }
    /// <p>Enables configuring Kinesis Firehose to deliver data to any HTTP endpoint destination. You can specify only one destination.</p>
    pub fn get_http_endpoint_destination_configuration(&self) -> &::std::option::Option<crate::types::HttpEndpointDestinationConfiguration> {
        self.inner.get_http_endpoint_destination_configuration()
    }
    ///
    /// Appends an item to `Tags`.
    ///
    /// To override the contents of this collection use [`set_tags`](Self::set_tags).
    ///
    /// <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>
    /// <p>You can specify up to 50 tags when creating a Firehose stream.</p>
    /// <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>
    /// <p><b>AccessDeniedException</b></p>
    /// <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>
    /// <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>
    pub fn tags(mut self, input: crate::types::Tag) -> Self {
        self.inner = self.inner.tags(input);
        self
    }
    /// <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>
    /// <p>You can specify up to 50 tags when creating a Firehose stream.</p>
    /// <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>
    /// <p><b>AccessDeniedException</b></p>
    /// <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>
    /// <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>
    pub fn set_tags(mut self, input: ::std::option::Option<::std::vec::Vec<crate::types::Tag>>) -> Self {
        self.inner = self.inner.set_tags(input);
        self
    }
    /// <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>
    /// <p>You can specify up to 50 tags when creating a Firehose stream.</p>
    /// <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>
    /// <p><b>AccessDeniedException</b></p>
    /// <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>
    /// <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>
    pub fn get_tags(&self) -> &::std::option::Option<::std::vec::Vec<crate::types::Tag>> {
        self.inner.get_tags()
    }
    /// <p>The destination in the Serverless offering for Amazon OpenSearch Service. You can specify only one destination.</p>
    pub fn amazon_open_search_serverless_destination_configuration(
        mut self,
        input: crate::types::AmazonOpenSearchServerlessDestinationConfiguration,
    ) -> Self {
        self.inner = self.inner.amazon_open_search_serverless_destination_configuration(input);
        self
    }
    /// <p>The destination in the Serverless offering for Amazon OpenSearch Service. You can specify only one destination.</p>
    pub fn set_amazon_open_search_serverless_destination_configuration(
        mut self,
        input: ::std::option::Option<crate::types::AmazonOpenSearchServerlessDestinationConfiguration>,
    ) -> Self {
        self.inner = self.inner.set_amazon_open_search_serverless_destination_configuration(input);
        self
    }
    /// <p>The destination in the Serverless offering for Amazon OpenSearch Service. You can specify only one destination.</p>
    pub fn get_amazon_open_search_serverless_destination_configuration(
        &self,
    ) -> &::std::option::Option<crate::types::AmazonOpenSearchServerlessDestinationConfiguration> {
        self.inner.get_amazon_open_search_serverless_destination_configuration()
    }
    /// <p>The configuration for the Amazon MSK cluster to be used as the source for a delivery stream.</p>
    pub fn msk_source_configuration(mut self, input: crate::types::MskSourceConfiguration) -> Self {
        self.inner = self.inner.msk_source_configuration(input);
        self
    }
    /// <p>The configuration for the Amazon MSK cluster to be used as the source for a delivery stream.</p>
    pub fn set_msk_source_configuration(mut self, input: ::std::option::Option<crate::types::MskSourceConfiguration>) -> Self {
        self.inner = self.inner.set_msk_source_configuration(input);
        self
    }
    /// <p>The configuration for the Amazon MSK cluster to be used as the source for a delivery stream.</p>
    pub fn get_msk_source_configuration(&self) -> &::std::option::Option<crate::types::MskSourceConfiguration> {
        self.inner.get_msk_source_configuration()
    }
    /// <p>Configure Snowflake destination</p>
    pub fn snowflake_destination_configuration(mut self, input: crate::types::SnowflakeDestinationConfiguration) -> Self {
        self.inner = self.inner.snowflake_destination_configuration(input);
        self
    }
    /// <p>Configure Snowflake destination</p>
    pub fn set_snowflake_destination_configuration(mut self, input: ::std::option::Option<crate::types::SnowflakeDestinationConfiguration>) -> Self {
        self.inner = self.inner.set_snowflake_destination_configuration(input);
        self
    }
    /// <p>Configure Snowflake destination</p>
    pub fn get_snowflake_destination_configuration(&self) -> &::std::option::Option<crate::types::SnowflakeDestinationConfiguration> {
        self.inner.get_snowflake_destination_configuration()
    }
    /// <p>Configure Apache Iceberg Tables destination.</p>
    pub fn iceberg_destination_configuration(mut self, input: crate::types::IcebergDestinationConfiguration) -> Self {
        self.inner = self.inner.iceberg_destination_configuration(input);
        self
    }
    /// <p>Configure Apache Iceberg Tables destination.</p>
    pub fn set_iceberg_destination_configuration(mut self, input: ::std::option::Option<crate::types::IcebergDestinationConfiguration>) -> Self {
        self.inner = self.inner.set_iceberg_destination_configuration(input);
        self
    }
    /// <p>Configure Apache Iceberg Tables destination.</p>
    pub fn get_iceberg_destination_configuration(&self) -> &::std::option::Option<crate::types::IcebergDestinationConfiguration> {
        self.inner.get_iceberg_destination_configuration()
    }
    /// <p>The top level object for configuring streams with database as a source.</p>
    /// <p>Amazon Data Firehose is in preview release and is subject to change.</p>
    pub fn database_source_configuration(mut self, input: crate::types::DatabaseSourceConfiguration) -> Self {
        self.inner = self.inner.database_source_configuration(input);
        self
    }
    /// <p>The top level object for configuring streams with database as a source.</p>
    /// <p>Amazon Data Firehose is in preview release and is subject to change.</p>
    pub fn set_database_source_configuration(mut self, input: ::std::option::Option<crate::types::DatabaseSourceConfiguration>) -> Self {
        self.inner = self.inner.set_database_source_configuration(input);
        self
    }
    /// <p>The top level object for configuring streams with database as a source.</p>
    /// <p>Amazon Data Firehose is in preview release and is subject to change.</p>
    pub fn get_database_source_configuration(&self) -> &::std::option::Option<crate::types::DatabaseSourceConfiguration> {
        self.inner.get_database_source_configuration()
    }
}