aws-sdk-firehose 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9ab712fb3edb51fbbdd42a659ebbea505d210b80
-  data.tar.gz: 4fcea870930960f690384d7f6e94d1f9fd51101d
+  metadata.gz: f4af5896c9f34d011f0c5a4ab5737d5ba18205f8
+  data.tar.gz: a5e8625fcbf53b9d69d2832b70537cd4c221eeeb
 SHA512:
-  metadata.gz: 08d069b36ba59bc957f59c5057d8b0b89ce70bbd5d75aa9c6eec3dd9b8e3e95853375a027e0d50e3006e77b05e927737b01fc97f28de1362808fadf087a2339b
-  data.tar.gz: 3fc01c7f714fe33a11d1650e929953b9a09c7f72a7c864d084136b094b5499a11da55409d028edb33a4e3fa6674423595a2ee5a710af995b91725aa8d647f39e
+  metadata.gz: 83f24cc8b997436c6e9ea9821c6d3b2c202cd2b2330f6fab8b59b31960ec5b618d113eb417ddfd781a98d8fa53b1cf421384a60f891a43992255e2fc68f389cf
+  data.tar.gz: 4aa07cee5e527b231bd5dcbf230bc6eda2e10bdffbac71cdfb2ae284c173bd91ecaf35944c504c1070829dd27217d73bdebd96ed5b22e88377e9dfe6518c46aa

data/lib/aws-sdk-firehose.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-firehose/customizations'
 # @service
 module Aws::Firehose
 
-  GEM_VERSION = '1.1.0'
+  GEM_VERSION = '1.2.0'
 
 end

data/lib/aws-sdk-firehose/client.rb

@@ -157,7 +157,7 @@ module Aws::Firehose
 
     # Creates a delivery stream.
     #
-    # By default, you can create up to 20 delivery streams per region.
+    # By default, you can create up to 50 delivery streams per AWS Region.
     #
     # This is an asynchronous operation that immediately returns. The
     # initial status of the delivery stream is `CREATING`. After the
@@ -166,29 +166,30 @@ module Aws::Firehose
     # `ACTIVE` state cause an exception. To check the state of a delivery
     # stream, use DescribeDeliveryStream.
     #
-    # A Kinesis Firehose delivery stream can be configured to receive
+    # A Kinesis Data Firehose delivery stream can be configured to receive
     # records directly from providers using PutRecord or PutRecordBatch, or
-    # it can be configured to use an existing Kinesis stream as its source.
-    # To specify a Kinesis stream as input, set the `DeliveryStreamType`
-    # parameter to `KinesisStreamAsSource`, and provide the Kinesis stream
-    # ARN and role ARN in the `KinesisStreamSourceConfiguration` parameter.
+    # it can be configured to use an existing Kinesis data stream as its
+    # source. To specify a Kinesis data stream as input, set the
+    # `DeliveryStreamType` parameter to `KinesisStreamAsSource`, and provide
+    # the Kinesis data stream Amazon Resource Name (ARN) and role ARN in the
+    # `KinesisStreamSourceConfiguration` parameter.
     #
     # A delivery stream is configured with a single destination: Amazon S3,
-    # Amazon ES, or Amazon Redshift. You must specify only one of the
+    # Amazon ES, Amazon Redshift, or Splunk. Specify only one of the
     # following destination configuration parameters:
-    # **ExtendedS3DestinationConfiguration**,
-    # **S3DestinationConfiguration**,
-    # **ElasticsearchDestinationConfiguration**, or
-    # **RedshiftDestinationConfiguration**.
-    #
-    # When you specify **S3DestinationConfiguration**, you can also provide
-    # the following optional values: **BufferingHints**,
-    # **EncryptionConfiguration**, and **CompressionFormat**. By default, if
-    # no **BufferingHints** value is provided, Kinesis Firehose buffers data
+    # `ExtendedS3DestinationConfiguration`, `S3DestinationConfiguration`,
+    # `ElasticsearchDestinationConfiguration`,
+    # `RedshiftDestinationConfiguration`, or
+    # `SplunkDestinationConfiguration`.
+    #
+    # When you specify `S3DestinationConfiguration`, you can also provide
+    # the following optional values: `BufferingHints`,
+    # `EncryptionConfiguration`, and `CompressionFormat`. By default, if no
+    # `BufferingHints` value is provided, Kinesis Data Firehose buffers data
     # up to 5 MB or for 5 minutes, whichever condition is satisfied first.
-    # Note that **BufferingHints** is a hint, so there are some cases where
-    # the service cannot adhere to these conditions strictly; for example,
-    # record boundaries are such that the size is a little over or under the
+    # `BufferingHints` is a hint, so there are some cases where the service
+    # cannot adhere to these conditions strictly. For example, record
+    # boundaries are 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.
@@ -196,26 +197,27 @@ module Aws::Firehose
     # A few notes about Amazon Redshift as a destination:
     #
     # * An Amazon Redshift destination requires an S3 bucket as intermediate
-    #   location, as Kinesis Firehose first delivers data to S3 and then
-    #   uses `COPY` syntax to load data into an Amazon Redshift table. This
-    #   is specified in the
-    #   **RedshiftDestinationConfiguration.S3Configuration** parameter.
+    #   location. This is because Kinesis Data Firehose first delivers data
+    #   to Amazon S3 and then uses `COPY` syntax to load data into an Amazon
+    #   Redshift table. This is specified in the
+    #   `RedshiftDestinationConfiguration.S3Configuration` parameter.
     #
     # * The compression formats `SNAPPY` or `ZIP` cannot be specified in
-    #   **RedshiftDestinationConfiguration.S3Configuration** because the
+    #   `RedshiftDestinationConfiguration.S3Configuration` because the
     #   Amazon Redshift `COPY` operation that reads from the S3 bucket
     #   doesn't support these compression formats.
     #
-    # * We strongly recommend that you use the user name and password you
-    #   provide exclusively with Kinesis Firehose, and that the permissions
-    #   for the account are restricted for Amazon Redshift `INSERT`
-    #   permissions.
+    # * We strongly recommend that you use the user name and password that
+    #   you provide exclusively with Kinesis Data Firehose. In addition, the
+    #   permissions for the account should be restricted for Amazon Redshift
+    #   `INSERT` permissions.
     #
-    # Kinesis Firehose assumes the IAM role that is configured as part of
-    # the destination. The role should allow the Kinesis Firehose principal
-    # to assume the role, and the role should have permissions that allow
-    # the service to deliver the data. For more information, see [Amazon S3
-    # Bucket Access][1] in the *Amazon Kinesis Firehose Developer Guide*.
+    # Kinesis Data Firehose assumes the IAM role that is configured as part
+    # of the destination. The role should allow the Kinesis Data Firehose
+    # principal to assume the role, and the role should have permissions
+    # that allow the service to deliver the data. For more information, see
+    # [Grant Kinesis Firehose Access to an Amazon S3 Destination][1] in the
+    # *Amazon Kinesis Data Firehose Developer Guide*.
     #
     #
     #
@@ -223,8 +225,8 @@ module Aws::Firehose
     #
     # @option params [required, String] :delivery_stream_name
     #   The name of the delivery stream. This name must be unique per AWS
-    #   account in the same region. If the delivery streams are in different
-    #   accounts or different regions, you can have multiple delivery streams
+    #   account in the same Region. If the delivery streams are in different
+    #   accounts or different Regions, you can have multiple delivery streams
     #   with the same name.
     #
     # @option params [String] :delivery_stream_type
@@ -234,13 +236,14 @@ module Aws::Firehose
     #   * `DirectPut`\: Provider applications access the delivery stream
     #     directly.
     #
-    #   * `KinesisStreamAsSource`\: The delivery stream uses a Kinesis stream
-    #     as a source.
+    #   * `KinesisStreamAsSource`\: The delivery stream uses a Kinesis data
+    #     stream as a source.
     #
     # @option params [Types::KinesisStreamSourceConfiguration] :kinesis_stream_source_configuration
-    #   When a Kinesis stream is used as the source for the delivery stream, a
-    #   KinesisStreamSourceConfiguration containing the Kinesis stream ARN and
-    #   the role ARN for the source stream.
+    #   When a Kinesis data stream is used as the source for the delivery
+    #   stream, a KinesisStreamSourceConfiguration containing the Kinesis data
+    #   stream Amazon Resource Name (ARN) and the role ARN for the source
+    #   stream.
     #
     # @option params [Types::S3DestinationConfiguration] :s3_destination_configuration
     #   \[Deprecated\] The destination in Amazon S3. You can specify only one
@@ -582,8 +585,8 @@ module Aws::Firehose
 
     # Describes the specified delivery stream and gets the status. For
     # example, after your delivery stream is created, call
-    # DescribeDeliveryStream to see if the delivery stream is `ACTIVE` and
-    # therefore ready for data to be sent to it.
+    # `DescribeDeliveryStream` to see whether the delivery stream is
+    # `ACTIVE` and therefore ready for data to be sent to it.
     #
     # @option params [required, String] :delivery_stream_name
     #   The name of the delivery stream.
@@ -594,8 +597,8 @@ module Aws::Firehose
     #
     # @option params [String] :exclusive_start_destination_id
     #   The ID of the destination to start returning the destination
-    #   information. Currently, Kinesis Firehose supports one destination per
-    #   delivery stream.
+    #   information. Currently, Kinesis Data Firehose supports one destination
+    #   per delivery stream.
     #
     # @return [Types::DescribeDeliveryStreamOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -771,13 +774,13 @@ module Aws::Firehose
     # Lists your delivery streams.
     #
     # The number of delivery streams might be too large to return using a
-    # single call to ListDeliveryStreams. You can limit the number of
+    # single call to `ListDeliveryStreams`. You can limit the number of
     # delivery streams returned, using the **Limit** parameter. To determine
     # whether there are more delivery streams to list, check the value of
-    # **HasMoreDeliveryStreams** in the output. If there are more delivery
+    # `HasMoreDeliveryStreams` in the output. If there are more delivery
     # streams to list, you can request them by specifying the name of the
     # last delivery stream returned in the call in the
-    # **ExclusiveStartDeliveryStreamName** parameter of a subsequent call.
+    # `ExclusiveStartDeliveryStreamName` parameter of a subsequent call.
     #
     # @option params [Integer] :limit
     #   The maximum number of delivery streams to list. The default value is
@@ -789,8 +792,8 @@ module Aws::Firehose
     #   * `DirectPut`\: Provider applications access the delivery stream
     #     directly.
     #
-    #   * `KinesisStreamAsSource`\: The delivery stream uses a Kinesis stream
-    #     as a source.
+    #   * `KinesisStreamAsSource`\: The delivery stream uses a Kinesis data
+    #     stream as a source.
     #
     #   This parameter is optional. If this parameter is omitted, delivery
     #   streams of all types are returned.
@@ -826,43 +829,89 @@ module Aws::Firehose
       req.send_request(options)
     end
 
-    # Writes a single data record into an Amazon Kinesis Firehose delivery
-    # stream. To write multiple data records into a delivery stream, use
-    # PutRecordBatch. Applications using these operations are referred to as
-    # producers.
+    # Lists the tags for the specified delivery stream. This operation has a
+    # limit of five transactions per second per account.
+    #
+    # @option params [required, String] :delivery_stream_name
+    #   The name of the delivery stream whose tags you want to list.
+    #
+    # @option params [String] :exclusive_start_tag_key
+    #   The key to use as the starting point for the list of tags. If you set
+    #   this parameter, `ListTagsForDeliveryStream` gets all tags that occur
+    #   after `ExclusiveStartTagKey`.
+    #
+    # @option params [Integer] :limit
+    #   The number of tags to return. If this number is less than the total
+    #   number of tags associated with the delivery stream, `HasMoreTags` is
+    #   set to `true` in the response. To list additional tags, set
+    #   `ExclusiveStartTagKey` to the last key in the response.
+    #
+    # @return [Types::ListTagsForDeliveryStreamOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTagsForDeliveryStreamOutput#tags #tags} => Array<Types::Tag>
+    #   * {Types::ListTagsForDeliveryStreamOutput#has_more_tags #has_more_tags} => Boolean
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_tags_for_delivery_stream({
+    #     delivery_stream_name: "DeliveryStreamName", # required
+    #     exclusive_start_tag_key: "TagKey",
+    #     limit: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.tags #=> Array
+    #   resp.tags[0].key #=> String
+    #   resp.tags[0].value #=> String
+    #   resp.has_more_tags #=> Boolean
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/ListTagsForDeliveryStream AWS API Documentation
+    #
+    # @overload list_tags_for_delivery_stream(params = {})
+    # @param [Hash] params ({})
+    def list_tags_for_delivery_stream(params = {}, options = {})
+      req = build_request(:list_tags_for_delivery_stream, params)
+      req.send_request(options)
+    end
+
+    # Writes a single data record into an Amazon Kinesis Data Firehose
+    # delivery stream. To write multiple data records into a delivery
+    # stream, use PutRecordBatch. Applications using these operations are
+    # referred to as producers.
     #
     # By default, each delivery stream can take in up to 2,000 transactions
     # per second, 5,000 records per second, or 5 MB per second. Note that if
-    # you use PutRecord and PutRecordBatch, the limits are an aggregate
+    # you use `PutRecord` and PutRecordBatch, the limits are an aggregate
     # across these two operations for each delivery stream. For more
     # information about limits and how to request an increase, see [Amazon
-    # Kinesis Firehose Limits][1].
+    # Kinesis Data Firehose Limits][1].
     #
     # You must specify the name of the delivery stream and the data record
-    # when using PutRecord. The data record consists of a data blob that can
-    # be up to 1,000 KB in size, and any kind of data, for example, a
-    # segment from a log file, geographic location data, website clickstream
-    # data, and so on.
+    # when using `PutRecord`. The data record consists of a data blob that
+    # can be up to 1,000 KB in size and any kind of data. For example, it
+    # can be a segment from a log file, geographic location data, website
+    # clickstream data, and so on.
     #
-    # Kinesis Firehose buffers records before delivering them to the
+    # Kinesis Data Firehose buffers records before delivering them to the
     # destination. To disambiguate the data blobs at the destination, a
     # common solution is to use delimiters in the data, such as a newline
     # (`\n`) or some other character unique within the data. This allows the
     # consumer application to parse individual data items when reading the
     # data from the destination.
     #
-    # The PutRecord operation returns a **RecordId**, which is a unique
+    # The `PutRecord` operation returns a `RecordId`, which is a unique
     # string assigned to each record. Producer applications can use this ID
     # for purposes such as auditability and investigation.
     #
-    # If the PutRecord operation throws a **ServiceUnavailableException**,
+    # If the `PutRecord` operation throws a `ServiceUnavailableException`,
     # back off and retry. If the exception persists, it is possible that the
     # throughput limits have been exceeded for the delivery stream.
     #
-    # Data records sent to Kinesis Firehose are stored for 24 hours from the
-    # time they are added to a delivery stream as it attempts to send the
-    # records to the destination. If the destination is unreachable for more
-    # than 24 hours, the data is no longer available.
+    # Data records sent to Kinesis Data Firehose are stored for 24 hours
+    # from the time they are added to a delivery stream as it attempts to
+    # send the records to the destination. If the destination is unreachable
+    # for more than 24 hours, the data is no longer available.
     #
     #
     #
@@ -908,63 +957,61 @@ module Aws::Firehose
     #
     # By default, each delivery stream can take in up to 2,000 transactions
     # per second, 5,000 records per second, or 5 MB per second. If you use
-    # PutRecord and PutRecordBatch, the limits are an aggregate across these
-    # two operations for each delivery stream. For more information about
-    # limits, see [Amazon Kinesis Firehose Limits][1].
+    # PutRecord and `PutRecordBatch`, the limits are an aggregate across
+    # these two operations for each delivery stream. For more information
+    # about limits, see [Amazon Kinesis Data Firehose Limits][1].
     #
-    # Each PutRecordBatch request supports up to 500 records. Each record in
-    # the request can be as large as 1,000 KB (before 64-bit encoding), up
-    # to a limit of 4 MB for the entire request. These limits cannot be
+    # Each `PutRecordBatch` request supports up to 500 records. Each record
+    # in the request can be as large as 1,000 KB (before 64-bit encoding),
+    # up to a limit of 4 MB for the entire request. These limits cannot be
     # changed.
     #
     # You must specify the name of the delivery stream and the data record
     # when using PutRecord. The data record consists of a data blob that can
-    # be up to 1,000 KB in size, and any kind of data. For example, it could
-    # be a segment from a log file, geographic location data, web site
+    # be up to 1,000 KB in size and any kind of data. For example, it could
+    # be a segment from a log file, geographic location data, website
     # clickstream data, and so on.
     #
-    # Kinesis Firehose buffers records before delivering them to the
+    # Kinesis Data Firehose buffers records before delivering them to the
     # destination. To disambiguate the data blobs at the destination, a
     # common solution is to use delimiters in the data, such as a newline
     # (`\n`) or some other character unique within the data. This allows the
     # consumer application to parse individual data items when reading the
     # data from the destination.
     #
-    # The PutRecordBatch response includes a count of failed records,
-    # **FailedPutCount**, and an array of responses, **RequestResponses**.
-    # Each entry in the **RequestResponses** array provides additional
-    # information about the processed record. It directly correlates with a
-    # record in the request array using the same ordering, from the top to
-    # the bottom. The response array always includes the same number of
-    # records as the request array. **RequestResponses** includes both
-    # successfully and unsuccessfully processed records. Kinesis Firehose
-    # attempts to process all records in each PutRecordBatch request. A
-    # single record failure does not stop the processing of subsequent
-    # records.
-    #
-    # A successfully processed record includes a **RecordId** value, which
-    # is unique for the record. An unsuccessfully processed record includes
-    # **ErrorCode** and **ErrorMessage** values. **ErrorCode** reflects the
-    # type of error, and is one of the following values:
-    # `ServiceUnavailable` or `InternalFailure`. **ErrorMessage** provides
-    # more detailed information about the error.
+    # The `PutRecordBatch` response includes a count of failed records,
+    # `FailedPutCount`, and an array of responses, `RequestResponses`. Each
+    # entry in the `RequestResponses` array provides additional information
+    # about the processed record. It directly correlates with a record in
+    # the request array using the same ordering, from the top to the bottom.
+    # The response array always includes the same number of records as the
+    # request array. `RequestResponses` includes both successfully and
+    # unsuccessfully processed records. Kinesis Data Firehose attempts to
+    # process all records in each `PutRecordBatch` request. A single record
+    # failure does not stop the processing of subsequent records.
+    #
+    # A successfully processed record includes a `RecordId` value, which is
+    # unique for the record. An unsuccessfully processed record includes
+    # `ErrorCode` and `ErrorMessage` values. `ErrorCode` reflects the type
+    # of error, and is one of the following values: `ServiceUnavailable` or
+    # `InternalFailure`. `ErrorMessage` provides more detailed information
+    # about the error.
     #
     # If there is an internal server error or a timeout, the write might
-    # have completed or it might have failed. If **FailedPutCount** is
-    # greater than 0, retry the request, resending only those records that
-    # might have failed processing. This minimizes the possible duplicate
-    # records and also reduces the total bytes sent (and corresponding
-    # charges). We recommend that you handle any duplicates at the
-    # destination.
+    # have completed or it might have failed. If `FailedPutCount` is greater
+    # than 0, retry the request, resending only those records that might
+    # have failed processing. This minimizes the possible duplicate records
+    # and also reduces the total bytes sent (and corresponding charges). We
+    # recommend that you handle any duplicates at the destination.
     #
-    # If PutRecordBatch throws **ServiceUnavailableException**, back off and
+    # If `PutRecordBatch` throws `ServiceUnavailableException`, back off and
     # retry. If the exception persists, it is possible that the throughput
     # limits have been exceeded for the delivery stream.
     #
-    # Data records sent to Kinesis Firehose are stored for 24 hours from the
-    # time they are added to a delivery stream as it attempts to send the
-    # records to the destination. If the destination is unreachable for more
-    # than 24 hours, the data is no longer available.
+    # Data records sent to Kinesis Data Firehose are stored for 24 hours
+    # from the time they are added to a delivery stream as it attempts to
+    # send the records to the destination. If the destination is unreachable
+    # for more than 24 hours, the data is no longer available.
     #
     #
     #
@@ -1009,51 +1056,133 @@ module Aws::Firehose
       req.send_request(options)
     end
 
-    # Updates the specified destination of the specified delivery stream.
+    # Adds or updates tags for the specified delivery stream. A tag is a
+    # key-value pair (the value is optional) that you can define and assign
+    # to AWS resources. If you specify a tag that already exists, the tag
+    # value is replaced with the value that you specify in the request. Tags
+    # are metadata. For example, you can add friendly names and descriptions
+    # or other types of information that can help you distinguish the
+    # delivery stream. For more information about tags, see [Using Cost
+    # Allocation Tags][1] in the *AWS Billing and Cost Management User
+    # Guide*.
     #
-    # You can use this operation to change the destination type (for
-    # example, to replace the Amazon S3 destination with Amazon Redshift) or
-    # change the parameters associated with a destination (for example, to
-    # change the bucket name of the Amazon S3 destination). The update might
-    # not occur immediately. The target delivery stream remains active while
-    # the configurations are updated, so data writes to the delivery stream
-    # can continue during this process. The updated configurations are
-    # usually effective within a few minutes.
+    # Each delivery stream can have up to 50 tags.
+    #
+    # This operation has a limit of five transactions per second per
+    # account.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
+    #
+    # @option params [required, String] :delivery_stream_name
+    #   The name of the delivery stream to which you want to add the tags.
+    #
+    # @option params [required, Array<Types::Tag>] :tags
+    #   A set of key-value pairs to use to create the tags.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
-    # Note that switching between Amazon ES and other services is not
-    # supported. For an Amazon ES destination, you can only update to
-    # another Amazon ES destination.
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.tag_delivery_stream({
+    #     delivery_stream_name: "DeliveryStreamName", # required
+    #     tags: [ # required
+    #       {
+    #         key: "TagKey", # required
+    #         value: "TagValue",
+    #       },
+    #     ],
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/TagDeliveryStream AWS API Documentation
+    #
+    # @overload tag_delivery_stream(params = {})
+    # @param [Hash] params ({})
+    def tag_delivery_stream(params = {}, options = {})
+      req = build_request(:tag_delivery_stream, params)
+      req.send_request(options)
+    end
+
+    # Removes tags from the specified delivery stream. Removed tags are
+    # deleted, and you can't recover them after this operation successfully
+    # completes.
+    #
+    # If you specify a tag that doesn't exist, the operation ignores it.
+    #
+    # This operation has a limit of five transactions per second per
+    # account.
+    #
+    # @option params [required, String] :delivery_stream_name
+    #   The name of the delivery stream.
+    #
+    # @option params [required, Array<String>] :tag_keys
+    #   A list of tag keys. Each corresponding tag is removed from the
+    #   delivery stream.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.untag_delivery_stream({
+    #     delivery_stream_name: "DeliveryStreamName", # required
+    #     tag_keys: ["TagKey"], # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/UntagDeliveryStream AWS API Documentation
+    #
+    # @overload untag_delivery_stream(params = {})
+    # @param [Hash] params ({})
+    def untag_delivery_stream(params = {}, options = {})
+      req = build_request(:untag_delivery_stream, params)
+      req.send_request(options)
+    end
+
+    # Updates the specified destination of the specified delivery stream.
+    #
+    # Use this operation to change the destination type (for example, to
+    # replace the Amazon S3 destination with Amazon Redshift) or change the
+    # parameters associated with a destination (for example, to change the
+    # bucket name of the Amazon S3 destination). The update might not occur
+    # immediately. The target delivery stream remains active while the
+    # configurations are updated, so data writes to the delivery stream can
+    # continue during this process. The updated configurations are usually
+    # effective within a few minutes.
+    #
+    # Switching between Amazon ES and other services is not supported. For
+    # an Amazon ES destination, you can only update to another Amazon ES
+    # destination.
     #
-    # If the destination type is the same, Kinesis Firehose merges the
+    # If the destination type is the same, Kinesis Data Firehose merges the
     # configuration parameters specified with the destination configuration
     # that already exists on the delivery stream. If any of the parameters
     # are not specified in the call, the existing values are retained. For
     # example, in the Amazon S3 destination, if EncryptionConfiguration is
-    # not specified, then the existing EncryptionConfiguration is maintained
-    # on the destination.
+    # not specified, then the existing `EncryptionConfiguration` is
+    # maintained on the destination.
     #
     # If the destination type is not the same, for example, changing the
-    # destination from Amazon S3 to Amazon Redshift, Kinesis Firehose does
-    # not merge any parameters. In this case, all parameters must be
+    # destination from Amazon S3 to Amazon Redshift, Kinesis Data Firehose
+    # does not merge any parameters. In this case, all parameters must be
     # specified.
     #
-    # Kinesis Firehose uses **CurrentDeliveryStreamVersionId** to avoid race
-    # conditions and conflicting merges. This is a required field, and the
-    # service updates the configuration only if the existing configuration
-    # has a version ID that matches. After the update is applied
-    # successfully, the version ID is updated, and can be retrieved using
-    # DescribeDeliveryStream. Use the new version ID to set
-    # **CurrentDeliveryStreamVersionId** in the next call.
+    # Kinesis Data Firehose uses `CurrentDeliveryStreamVersionId` to avoid
+    # race conditions and conflicting merges. This is a required field, and
+    # the service updates the configuration only if the existing
+    # configuration has a version ID that matches. After the update is
+    # applied successfully, the version ID is updated, and you can retrieve
+    # it using DescribeDeliveryStream. Use the new version ID to set
+    # `CurrentDeliveryStreamVersionId` in the next call.
     #
     # @option params [required, String] :delivery_stream_name
     #   The name of the delivery stream.
     #
     # @option params [required, String] :current_delivery_stream_version_id
-    #   Obtain this value from the **VersionId** result of
-    #   DeliveryStreamDescription. This value is required, and helps the
-    #   service to perform conditional operations. For example, if there is an
+    #   Obtain this value from the `VersionId` result of
+    #   DeliveryStreamDescription. This value is required, and it helps the
+    #   service perform conditional operations. For example, if there is an
     #   interleaving update and this value is null, then the update
-    #   destination fails. After the update is successful, the **VersionId**
+    #   destination fails. After the update is successful, the `VersionId`
     #   value is updated. The service then performs a merge of the old
     #   configuration with the new configuration.
     #
@@ -1365,7 +1494,7 @@ module Aws::Firehose
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-firehose'
-      context[:gem_version] = '1.1.0'
+      context[:gem_version] = '1.2.0'
       Seahorse::Client::Request.new(handlers, context)
     end