aws-sdk-firehose 1.56.0 → 1.57.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0da346ba8bdcd741060e0f32b547e35151b4c21f1d1f9dae3b1870192a1cde2b
-  data.tar.gz: a9a31b4ec14e51b1b7570ee0efc87736ecc044d2bbca963b29c020132a2d90be
+  metadata.gz: 0f587fc8b4db92c3c0e9080caa7e096a22b4b6a0c26fb4135251de2374ae4bc9
+  data.tar.gz: 282c2cc072ec933e547d70c055f1fbf1eaba05b55d99c9b4d07c8cfd905fdc43
 SHA512:
-  metadata.gz: a76090e790e75fcb9bab58a987b459563745893b4816ba89bc9faad1fb0c3f61ad7a1d15409cfdd276379c8e3bb870ab9dfe00e2f75f3b2726e01649d5cdfa14
-  data.tar.gz: d02e2228f80ad285eefebb3e946b8293643ffb9e1115bac473f54c93d85d3e7537e263240f91822ebf8f1650d933359b875c746d21f56ecca7606b9e9e3d1b48
+  metadata.gz: 9e8286254261766be338735891dca9d7c936a989992db8f71d88eee105c3aafdf2ad05e27624a63ae296b052591cff0c21b224f783c6aab2e216c0251d1730ec
+  data.tar.gz: 8b276ded78fc18917feb5b475b6a0582478c878b0373b834b696126e676c77832550545488f20339156f73fd3582c1bfb6b3b8e98dcdecfb008c5a3fad3a3dab

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.57.0 (2023-09-13)
+------------------
+
+* Feature - DocumentIdOptions has been added for the Amazon OpenSearch destination.
+
 1.56.0 (2023-07-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.56.0
+1.57.0

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

@@ -430,9 +430,13 @@ module Aws::Firehose
     # turn on SSE for an existing delivery stream that doesn't have SSE
     # enabled.
     #
-    # A delivery stream is configured with a single destination: Amazon S3,
-    # Amazon ES, Amazon Redshift, or Splunk. You must specify only one of
-    # the following destination configuration parameters:
+    # A delivery 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:
     # `ExtendedS3DestinationConfiguration`, `S3DestinationConfiguration`,
     # `ElasticsearchDestinationConfiguration`,
     # `RedshiftDestinationConfiguration`, or
@@ -841,6 +845,9 @@ module Aws::Firehose
     #         role_arn: "RoleARN", # required
     #         security_group_ids: ["NonEmptyStringWithoutWhitespace"], # required
     #       },
+    #       document_id_options: {
+    #         default_document_id_format: "FIREHOSE_DEFAULT", # required, accepts FIREHOSE_DEFAULT, NO_DOCUMENT_ID
+    #       },
     #     },
     #     amazonopensearchservice_destination_configuration: {
     #       role_arn: "RoleARN", # required
@@ -903,6 +910,9 @@ module Aws::Firehose
     #         role_arn: "RoleARN", # required
     #         security_group_ids: ["NonEmptyStringWithoutWhitespace"], # required
     #       },
+    #       document_id_options: {
+    #         default_document_id_format: "FIREHOSE_DEFAULT", # required, accepts FIREHOSE_DEFAULT, NO_DOCUMENT_ID
+    #       },
     #     },
     #     splunk_destination_configuration: {
     #       hec_endpoint: "HECEndpoint", # required
@@ -1363,6 +1373,7 @@ module Aws::Firehose
     #   resp.delivery_stream_description.destinations[0].elasticsearch_destination_description.vpc_configuration_description.security_group_ids #=> Array
     #   resp.delivery_stream_description.destinations[0].elasticsearch_destination_description.vpc_configuration_description.security_group_ids[0] #=> String
     #   resp.delivery_stream_description.destinations[0].elasticsearch_destination_description.vpc_configuration_description.vpc_id #=> String
+    #   resp.delivery_stream_description.destinations[0].elasticsearch_destination_description.document_id_options.default_document_id_format #=> String, one of "FIREHOSE_DEFAULT", "NO_DOCUMENT_ID"
     #   resp.delivery_stream_description.destinations[0].amazonopensearchservice_destination_description.role_arn #=> String
     #   resp.delivery_stream_description.destinations[0].amazonopensearchservice_destination_description.domain_arn #=> String
     #   resp.delivery_stream_description.destinations[0].amazonopensearchservice_destination_description.cluster_endpoint #=> String
@@ -1400,6 +1411,7 @@ module Aws::Firehose
     #   resp.delivery_stream_description.destinations[0].amazonopensearchservice_destination_description.vpc_configuration_description.security_group_ids #=> Array
     #   resp.delivery_stream_description.destinations[0].amazonopensearchservice_destination_description.vpc_configuration_description.security_group_ids[0] #=> String
     #   resp.delivery_stream_description.destinations[0].amazonopensearchservice_destination_description.vpc_configuration_description.vpc_id #=> String
+    #   resp.delivery_stream_description.destinations[0].amazonopensearchservice_destination_description.document_id_options.default_document_id_format #=> String, one of "FIREHOSE_DEFAULT", "NO_DOCUMENT_ID"
     #   resp.delivery_stream_description.destinations[0].splunk_destination_description.hec_endpoint #=> String
     #   resp.delivery_stream_description.destinations[0].splunk_destination_description.hec_endpoint_type #=> String, one of "Raw", "Event"
     #   resp.delivery_stream_description.destinations[0].splunk_destination_description.hec_token #=> String
@@ -2024,9 +2036,9 @@ module Aws::Firehose
     # 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.
+    # Switching between Amazon OpenSearch Service and other services is not
+    # supported. For an Amazon OpenSearch Service destination, you can only
+    # update to another Amazon OpenSearch Service destination.
     #
     # If the destination type is the same, Kinesis Data Firehose merges the
     # configuration parameters specified with the destination configuration
@@ -2366,6 +2378,9 @@ module Aws::Firehose
     #         log_group_name: "LogGroupName",
     #         log_stream_name: "LogStreamName",
     #       },
+    #       document_id_options: {
+    #         default_document_id_format: "FIREHOSE_DEFAULT", # required, accepts FIREHOSE_DEFAULT, NO_DOCUMENT_ID
+    #       },
     #     },
     #     amazonopensearchservice_destination_update: {
     #       role_arn: "RoleARN",
@@ -2422,6 +2437,9 @@ module Aws::Firehose
     #         log_group_name: "LogGroupName",
     #         log_stream_name: "LogStreamName",
     #       },
+    #       document_id_options: {
+    #         default_document_id_format: "FIREHOSE_DEFAULT", # required, accepts FIREHOSE_DEFAULT, NO_DOCUMENT_ID
+    #       },
     #     },
     #     splunk_destination_update: {
     #       hec_endpoint: "HECEndpoint",
@@ -2617,7 +2635,7 @@ module Aws::Firehose
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-firehose'
-      context[:gem_version] = '1.56.0'
+      context[:gem_version] = '1.57.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -57,6 +57,7 @@ module Aws::Firehose
     DataFormatConversionConfiguration = Shapes::StructureShape.new(name: 'DataFormatConversionConfiguration')
     DataTableColumns = Shapes::StringShape.new(name: 'DataTableColumns')
     DataTableName = Shapes::StringShape.new(name: 'DataTableName')
+    DefaultDocumentIdFormat = Shapes::StringShape.new(name: 'DefaultDocumentIdFormat')
     DeleteDeliveryStreamInput = Shapes::StructureShape.new(name: 'DeleteDeliveryStreamInput')
     DeleteDeliveryStreamOutput = Shapes::StructureShape.new(name: 'DeleteDeliveryStreamOutput')
     DeliveryStartTimestamp = Shapes::TimestampShape.new(name: 'DeliveryStartTimestamp')
@@ -78,6 +79,7 @@ module Aws::Firehose
     DestinationDescription = Shapes::StructureShape.new(name: 'DestinationDescription')
     DestinationDescriptionList = Shapes::ListShape.new(name: 'DestinationDescriptionList')
     DestinationId = Shapes::StringShape.new(name: 'DestinationId')
+    DocumentIdOptions = Shapes::StructureShape.new(name: 'DocumentIdOptions')
     DynamicPartitioningConfiguration = Shapes::StructureShape.new(name: 'DynamicPartitioningConfiguration')
     ElasticsearchBufferingHints = Shapes::StructureShape.new(name: 'ElasticsearchBufferingHints')
     ElasticsearchBufferingIntervalInSeconds = Shapes::IntegerShape.new(name: 'ElasticsearchBufferingIntervalInSeconds')
@@ -287,6 +289,7 @@ module Aws::Firehose
     AmazonopensearchserviceDestinationConfiguration.add_member(:processing_configuration, Shapes::ShapeRef.new(shape: ProcessingConfiguration, location_name: "ProcessingConfiguration"))
     AmazonopensearchserviceDestinationConfiguration.add_member(:cloud_watch_logging_options, Shapes::ShapeRef.new(shape: CloudWatchLoggingOptions, location_name: "CloudWatchLoggingOptions"))
     AmazonopensearchserviceDestinationConfiguration.add_member(:vpc_configuration, Shapes::ShapeRef.new(shape: VpcConfiguration, location_name: "VpcConfiguration"))
+    AmazonopensearchserviceDestinationConfiguration.add_member(:document_id_options, Shapes::ShapeRef.new(shape: DocumentIdOptions, location_name: "DocumentIdOptions"))
     AmazonopensearchserviceDestinationConfiguration.struct_class = Types::AmazonopensearchserviceDestinationConfiguration
 
     AmazonopensearchserviceDestinationDescription.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "RoleARN"))
@@ -302,6 +305,7 @@ module Aws::Firehose
     AmazonopensearchserviceDestinationDescription.add_member(:processing_configuration, Shapes::ShapeRef.new(shape: ProcessingConfiguration, location_name: "ProcessingConfiguration"))
     AmazonopensearchserviceDestinationDescription.add_member(:cloud_watch_logging_options, Shapes::ShapeRef.new(shape: CloudWatchLoggingOptions, location_name: "CloudWatchLoggingOptions"))
     AmazonopensearchserviceDestinationDescription.add_member(:vpc_configuration_description, Shapes::ShapeRef.new(shape: VpcConfigurationDescription, location_name: "VpcConfigurationDescription"))
+    AmazonopensearchserviceDestinationDescription.add_member(:document_id_options, Shapes::ShapeRef.new(shape: DocumentIdOptions, location_name: "DocumentIdOptions"))
     AmazonopensearchserviceDestinationDescription.struct_class = Types::AmazonopensearchserviceDestinationDescription
 
     AmazonopensearchserviceDestinationUpdate.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "RoleARN"))
@@ -315,6 +319,7 @@ module Aws::Firehose
     AmazonopensearchserviceDestinationUpdate.add_member(:s3_update, Shapes::ShapeRef.new(shape: S3DestinationUpdate, location_name: "S3Update"))
     AmazonopensearchserviceDestinationUpdate.add_member(:processing_configuration, Shapes::ShapeRef.new(shape: ProcessingConfiguration, location_name: "ProcessingConfiguration"))
     AmazonopensearchserviceDestinationUpdate.add_member(:cloud_watch_logging_options, Shapes::ShapeRef.new(shape: CloudWatchLoggingOptions, location_name: "CloudWatchLoggingOptions"))
+    AmazonopensearchserviceDestinationUpdate.add_member(:document_id_options, Shapes::ShapeRef.new(shape: DocumentIdOptions, location_name: "DocumentIdOptions"))
     AmazonopensearchserviceDestinationUpdate.struct_class = Types::AmazonopensearchserviceDestinationUpdate
 
     AmazonopensearchserviceRetryOptions.add_member(:duration_in_seconds, Shapes::ShapeRef.new(shape: AmazonopensearchserviceRetryDurationInSeconds, location_name: "DurationInSeconds"))
@@ -421,6 +426,9 @@ module Aws::Firehose
 
     DestinationDescriptionList.member = Shapes::ShapeRef.new(shape: DestinationDescription)
 
+    DocumentIdOptions.add_member(:default_document_id_format, Shapes::ShapeRef.new(shape: DefaultDocumentIdFormat, required: true, location_name: "DefaultDocumentIdFormat"))
+    DocumentIdOptions.struct_class = Types::DocumentIdOptions
+
     DynamicPartitioningConfiguration.add_member(:retry_options, Shapes::ShapeRef.new(shape: RetryOptions, location_name: "RetryOptions"))
     DynamicPartitioningConfiguration.add_member(:enabled, Shapes::ShapeRef.new(shape: BooleanObject, location_name: "Enabled"))
     DynamicPartitioningConfiguration.struct_class = Types::DynamicPartitioningConfiguration
@@ -442,6 +450,7 @@ module Aws::Firehose
     ElasticsearchDestinationConfiguration.add_member(:processing_configuration, Shapes::ShapeRef.new(shape: ProcessingConfiguration, location_name: "ProcessingConfiguration"))
     ElasticsearchDestinationConfiguration.add_member(:cloud_watch_logging_options, Shapes::ShapeRef.new(shape: CloudWatchLoggingOptions, location_name: "CloudWatchLoggingOptions"))
     ElasticsearchDestinationConfiguration.add_member(:vpc_configuration, Shapes::ShapeRef.new(shape: VpcConfiguration, location_name: "VpcConfiguration"))
+    ElasticsearchDestinationConfiguration.add_member(:document_id_options, Shapes::ShapeRef.new(shape: DocumentIdOptions, location_name: "DocumentIdOptions"))
     ElasticsearchDestinationConfiguration.struct_class = Types::ElasticsearchDestinationConfiguration
 
     ElasticsearchDestinationDescription.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "RoleARN"))
@@ -457,6 +466,7 @@ module Aws::Firehose
     ElasticsearchDestinationDescription.add_member(:processing_configuration, Shapes::ShapeRef.new(shape: ProcessingConfiguration, location_name: "ProcessingConfiguration"))
     ElasticsearchDestinationDescription.add_member(:cloud_watch_logging_options, Shapes::ShapeRef.new(shape: CloudWatchLoggingOptions, location_name: "CloudWatchLoggingOptions"))
     ElasticsearchDestinationDescription.add_member(:vpc_configuration_description, Shapes::ShapeRef.new(shape: VpcConfigurationDescription, location_name: "VpcConfigurationDescription"))
+    ElasticsearchDestinationDescription.add_member(:document_id_options, Shapes::ShapeRef.new(shape: DocumentIdOptions, location_name: "DocumentIdOptions"))
     ElasticsearchDestinationDescription.struct_class = Types::ElasticsearchDestinationDescription
 
     ElasticsearchDestinationUpdate.add_member(:role_arn, Shapes::ShapeRef.new(shape: RoleARN, location_name: "RoleARN"))
@@ -470,6 +480,7 @@ module Aws::Firehose
     ElasticsearchDestinationUpdate.add_member(:s3_update, Shapes::ShapeRef.new(shape: S3DestinationUpdate, location_name: "S3Update"))
     ElasticsearchDestinationUpdate.add_member(:processing_configuration, Shapes::ShapeRef.new(shape: ProcessingConfiguration, location_name: "ProcessingConfiguration"))
     ElasticsearchDestinationUpdate.add_member(:cloud_watch_logging_options, Shapes::ShapeRef.new(shape: CloudWatchLoggingOptions, location_name: "CloudWatchLoggingOptions"))
+    ElasticsearchDestinationUpdate.add_member(:document_id_options, Shapes::ShapeRef.new(shape: DocumentIdOptions, location_name: "DocumentIdOptions"))
     ElasticsearchDestinationUpdate.struct_class = Types::ElasticsearchDestinationUpdate
 
     ElasticsearchRetryOptions.add_member(:duration_in_seconds, Shapes::ShapeRef.new(shape: ElasticsearchRetryDurationInSeconds, location_name: "DurationInSeconds"))

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

@@ -14,36 +14,39 @@ module Aws::Firehose
       use_dual_stack = parameters.use_dual_stack
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
-      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint) && (url = Aws::Endpoints::Matchers.parse_url(endpoint))
-          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
-          end
-          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
-          end
-          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://firehose-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-        end
+      if Aws::Endpoints::Matchers.set?(endpoint)
         if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-            return Aws::Endpoints::Endpoint.new(url: "https://firehose-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
         end
         if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://firehose.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://firehose-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+              return Aws::Endpoints::Endpoint.new(url: "https://firehose-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
+          end
+          if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://firehose.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
+          return Aws::Endpoints::Endpoint.new(url: "https://firehose.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
-        return Aws::Endpoints::Endpoint.new(url: "https://firehose.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
       end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
       raise ArgumentError, 'No endpoint could be resolved'
 
     end

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

@@ -91,7 +91,8 @@ module Aws::Firehose
     #   @return [Types::CloudWatchLoggingOptions]
     #
     # @!attribute [rw] vpc_configuration
-    #   The details of the VPC of the Amazon ES destination.
+    #   The details of the VPC of the Amazon OpenSearch or Amazon OpenSearch
+    #   Serverless destination.
     #   @return [Types::VpcConfiguration]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/AmazonOpenSearchServerlessDestinationConfiguration AWS API Documentation
@@ -115,7 +116,8 @@ module Aws::Firehose
     # OpenSearch Service.
     #
     # @!attribute [rw] role_arn
-    #   The Amazon Resource Name (ARN) of the AWS credentials.
+    #   The Amazon Resource Name (ARN) of the Amazon Web Services
+    #   credentials.
     #   @return [String]
     #
     # @!attribute [rw] collection_endpoint
@@ -352,9 +354,16 @@ module Aws::Firehose
     #   @return [Types::CloudWatchLoggingOptions]
     #
     # @!attribute [rw] vpc_configuration
-    #   The details of the VPC of the Amazon ES destination.
+    #   The details of the VPC of the Amazon OpenSearch or Amazon OpenSearch
+    #   Serverless destination.
     #   @return [Types::VpcConfiguration]
     #
+    # @!attribute [rw] document_id_options
+    #   Indicates the method for setting up document ID. The supported
+    #   methods are Kinesis Data Firehose generated document ID and
+    #   OpenSearch Service generated document ID.
+    #   @return [Types::DocumentIdOptions]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/AmazonopensearchserviceDestinationConfiguration AWS API Documentation
     #
     class AmazonopensearchserviceDestinationConfiguration < Struct.new(
@@ -370,7 +379,8 @@ module Aws::Firehose
       :s3_configuration,
       :processing_configuration,
       :cloud_watch_logging_options,
-      :vpc_configuration)
+      :vpc_configuration,
+      :document_id_options)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -435,6 +445,12 @@ module Aws::Firehose
     #   The details of the VPC of the Amazon ES destination.
     #   @return [Types::VpcConfigurationDescription]
     #
+    # @!attribute [rw] document_id_options
+    #   Indicates the method for setting up document ID. The supported
+    #   methods are Kinesis Data Firehose generated document ID and
+    #   OpenSearch Service generated document ID.
+    #   @return [Types::DocumentIdOptions]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/AmazonopensearchserviceDestinationDescription AWS API Documentation
     #
     class AmazonopensearchserviceDestinationDescription < Struct.new(
@@ -450,7 +466,8 @@ module Aws::Firehose
       :s3_destination_description,
       :processing_configuration,
       :cloud_watch_logging_options,
-      :vpc_configuration_description)
+      :vpc_configuration_description,
+      :document_id_options)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -522,6 +539,12 @@ module Aws::Firehose
     #   stream.
     #   @return [Types::CloudWatchLoggingOptions]
     #
+    # @!attribute [rw] document_id_options
+    #   Indicates the method for setting up document ID. The supported
+    #   methods are Kinesis Data Firehose generated document ID and
+    #   OpenSearch Service generated document ID.
+    #   @return [Types::DocumentIdOptions]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/AmazonopensearchserviceDestinationUpdate AWS API Documentation
     #
     class AmazonopensearchserviceDestinationUpdate < Struct.new(
@@ -535,7 +558,8 @@ module Aws::Firehose
       :retry_options,
       :s3_update,
       :processing_configuration,
-      :cloud_watch_logging_options)
+      :cloud_watch_logging_options,
+      :document_id_options)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1209,6 +1233,36 @@ module Aws::Firehose
       include Aws::Structure
     end
 
+    # Indicates the method for setting up document ID. The supported methods
+    # are Kinesis Data Firehose generated document ID and OpenSearch Service
+    # generated document ID.
+    #
+    # @!attribute [rw] default_document_id_format
+    #   When the `FIREHOSE_DEFAULT` option is chosen, Kinesis Data Firehose
+    #   generates a unique document ID for each record based on a unique
+    #   internal identifier. The generated document ID is stable across
+    #   multiple delivery attempts, which helps prevent the same record from
+    #   being indexed multiple times with different document IDs.
+    #
+    #   When the `NO_DOCUMENT_ID` option is chosen, Kinesis Data Firehose
+    #   does not include any document IDs in the requests it sends to the
+    #   Amazon OpenSearch Service. This causes the Amazon OpenSearch Service
+    #   domain to generate document IDs. In case of multiple delivery
+    #   attempts, this may cause the same record to be indexed more than
+    #   once with different document IDs. This option enables write-heavy
+    #   operations, such as the ingestion of logs and observability data, to
+    #   consume less resources in the Amazon OpenSearch Service domain,
+    #   resulting in improved performance.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/DocumentIdOptions AWS API Documentation
+    #
+    class DocumentIdOptions < Struct.new(
+      :default_document_id_format)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The configuration of the dynamic partitioning mechanism that creates
     # smaller data sets from the streaming data by partitioning it based on
     # partition keys. Currently, dynamic partitioning is only supported for
@@ -1363,9 +1417,15 @@ module Aws::Firehose
     #   @return [Types::CloudWatchLoggingOptions]
     #
     # @!attribute [rw] vpc_configuration
-    #   The details of the VPC of the Amazon ES destination.
+    #   The details of the VPC of the Amazon destination.
     #   @return [Types::VpcConfiguration]
     #
+    # @!attribute [rw] document_id_options
+    #   Indicates the method for setting up document ID. The supported
+    #   methods are Kinesis Data Firehose generated document ID and
+    #   OpenSearch Service generated document ID.
+    #   @return [Types::DocumentIdOptions]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/ElasticsearchDestinationConfiguration AWS API Documentation
     #
     class ElasticsearchDestinationConfiguration < Struct.new(
@@ -1381,7 +1441,8 @@ module Aws::Firehose
       :s3_configuration,
       :processing_configuration,
       :cloud_watch_logging_options,
-      :vpc_configuration)
+      :vpc_configuration,
+      :document_id_options)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1456,9 +1517,16 @@ module Aws::Firehose
     #   @return [Types::CloudWatchLoggingOptions]
     #
     # @!attribute [rw] vpc_configuration_description
-    #   The details of the VPC of the Amazon ES destination.
+    #   The details of the VPC of the Amazon OpenSearch or the Amazon
+    #   OpenSearch Serverless destination.
     #   @return [Types::VpcConfigurationDescription]
     #
+    # @!attribute [rw] document_id_options
+    #   Indicates the method for setting up document ID. The supported
+    #   methods are Kinesis Data Firehose generated document ID and
+    #   OpenSearch Service generated document ID.
+    #   @return [Types::DocumentIdOptions]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/ElasticsearchDestinationDescription AWS API Documentation
     #
     class ElasticsearchDestinationDescription < Struct.new(
@@ -1474,7 +1542,8 @@ module Aws::Firehose
       :s3_destination_description,
       :processing_configuration,
       :cloud_watch_logging_options,
-      :vpc_configuration_description)
+      :vpc_configuration_description,
+      :document_id_options)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1565,6 +1634,12 @@ module Aws::Firehose
     #   The CloudWatch logging options for your delivery stream.
     #   @return [Types::CloudWatchLoggingOptions]
     #
+    # @!attribute [rw] document_id_options
+    #   Indicates the method for setting up document ID. The supported
+    #   methods are Kinesis Data Firehose generated document ID and
+    #   OpenSearch Service generated document ID.
+    #   @return [Types::DocumentIdOptions]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/firehose-2015-08-04/ElasticsearchDestinationUpdate AWS API Documentation
     #
     class ElasticsearchDestinationUpdate < Struct.new(
@@ -1578,7 +1653,8 @@ module Aws::Firehose
       :retry_options,
       :s3_update,
       :processing_configuration,
-      :cloud_watch_logging_options)
+      :cloud_watch_logging_options,
+      :document_id_options)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -4073,7 +4149,8 @@ module Aws::Firehose
     #
     class UpdateDestinationOutput < Aws::EmptyStructure; end
 
-    # The details of the VPC of the Amazon ES destination.
+    # The details of the VPC of the Amazon OpenSearch or Amazon OpenSearch
+    # Serverless destination.
     #
     # @!attribute [rw] subnet_ids
     #   The IDs of the subnets that you want Kinesis Data Firehose to use to

data/lib/aws-sdk-firehose.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-firehose/customizations'
 # @!group service
 module Aws::Firehose
 
-  GEM_VERSION = '1.56.0'
+  GEM_VERSION = '1.57.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-firehose
 version: !ruby/object:Gem::Version
-  version: 1.56.0
+  version: 1.57.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2023-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core