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}