aws-sdk-lambda 1.142.0 → 1.143.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e5715c1a23a2275e2284d80df69dbd5134c1c43787243d1be6a00861f3dfc59
-  data.tar.gz: 4a26a48397d4fae836d5c2c60cc29cdfba80797dd008f757d63dd54086a9150b
+  metadata.gz: 560998fe09783ada881622dda45306f716d982a61e7dbfbe9eeb9120badc0c0b
+  data.tar.gz: 0c29b26e537b8e1287a429c772d31fea0d3ef3b366f15b93d45732288660b50c
 SHA512:
-  metadata.gz: b7f16c1a28de87d73db3a99834c0448830b4cdf5c4896d6683657ea15c7840ce7f4c052c89709c479adad6c1f4f3be40afe9b7a6eca5f24bc53c278b391e6dbe
-  data.tar.gz: c8def99084787ab73125f343d086749343cca68f4d7b9bdca11eb7ced4879c5ec2f1157be77d4be4aa3f2cf834954b7a6c0a045903ff8a84e6aeabf34a8ba9ed
+  metadata.gz: 1f407b1c438fbee329e6acf9e992c99341e4bb0ccf332aaf5f9131c5e3e13a00b2676096018eb839a4d576aec720b01cf6a1767178159204aaa352282be738aa
+  data.tar.gz: ec05e7dea8aab3b2aa5c52525c49ec3d32c2f3b53904a59c233929e662ed4c66f4681ab96ec31b85875a25acab095088b46abafa3efbb5e402311cd781d6098a

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.143.0 (2024-11-21)
+------------------
+
+* Feature - Adds support for metrics for event source mappings for AWS Lambda
+
 1.142.0 (2024-11-20)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.142.0
+1.143.0

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

@@ -906,15 +906,12 @@ module Aws::Lambda
     #
     # * [ Amazon DocumentDB][7]
     #
-    # The following error handling options are available only for stream
-    # sources (DynamoDB and Kinesis):
+    # The following error handling options are available only for DynamoDB
+    # and Kinesis event sources:
     #
     # * `BisectBatchOnFunctionError` – If the function returns an error,
     #   split the batch in two and retry.
     #
-    # * `DestinationConfig` – Send discarded records to an Amazon SQS queue
-    #   or Amazon SNS topic.
-    #
     # * `MaximumRecordAgeInSeconds` – Discard records older than the
     #   specified age. The default value is infinite (-1). When set to
     #   infinite (-1), failed records are retried until the record expires
@@ -926,6 +923,14 @@ module Aws::Lambda
     # * `ParallelizationFactor` – Process multiple batches from each shard
     #   concurrently.
     #
+    # For stream sources (DynamoDB, Kinesis, Amazon MSK, and self-managed
+    # Apache Kafka), the following option is also available:
+    #
+    # * `DestinationConfig` – Send discarded records to an Amazon SQS queue,
+    #   Amazon SNS topic, or Amazon S3 bucket.
+    #
+    # ^
+    #
     # For information about which configuration parameters apply to each
     # event source, see the following topics.
     #
@@ -1144,6 +1149,14 @@ module Aws::Lambda
     #
     #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics
     #
+    # @option params [Types::EventSourceMappingMetricsConfig] :metrics_config
+    #   The metrics configuration for your event source. For more information,
+    #   see [Event source mapping metrics][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics
+    #
     # @return [Types::EventSourceMappingConfiguration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::EventSourceMappingConfiguration#uuid #uuid} => String
@@ -1176,6 +1189,7 @@ module Aws::Lambda
     #   * {Types::EventSourceMappingConfiguration#kms_key_arn #kms_key_arn} => String
     #   * {Types::EventSourceMappingConfiguration#filter_criteria_error #filter_criteria_error} => Types::FilterCriteriaError
     #   * {Types::EventSourceMappingConfiguration#event_source_mapping_arn #event_source_mapping_arn} => String
+    #   * {Types::EventSourceMappingConfiguration#metrics_config #metrics_config} => Types::EventSourceMappingMetricsConfig
     #
     #
     # @example Example: To create a mapping between an event source and an AWS Lambda function
@@ -1261,6 +1275,9 @@ module Aws::Lambda
     #       full_document: "UpdateLookup", # accepts UpdateLookup, Default
     #     },
     #     kms_key_arn: "KMSKeyArn",
+    #     metrics_config: {
+    #       metrics: ["EventCount"], # accepts EventCount
+    #     },
     #   })
     #
     # @example Response structure
@@ -1307,6 +1324,8 @@ module Aws::Lambda
     #   resp.filter_criteria_error.error_code #=> String
     #   resp.filter_criteria_error.message #=> String
     #   resp.event_source_mapping_arn #=> String
+    #   resp.metrics_config.metrics #=> Array
+    #   resp.metrics_config.metrics[0] #=> String, one of "EventCount"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/CreateEventSourceMapping AWS API Documentation
     #
@@ -2066,6 +2085,7 @@ module Aws::Lambda
     #   * {Types::EventSourceMappingConfiguration#kms_key_arn #kms_key_arn} => String
     #   * {Types::EventSourceMappingConfiguration#filter_criteria_error #filter_criteria_error} => Types::FilterCriteriaError
     #   * {Types::EventSourceMappingConfiguration#event_source_mapping_arn #event_source_mapping_arn} => String
+    #   * {Types::EventSourceMappingConfiguration#metrics_config #metrics_config} => Types::EventSourceMappingMetricsConfig
     #
     #
     # @example Example: To delete a Lambda function event source mapping
@@ -2137,6 +2157,8 @@ module Aws::Lambda
     #   resp.filter_criteria_error.error_code #=> String
     #   resp.filter_criteria_error.message #=> String
     #   resp.event_source_mapping_arn #=> String
+    #   resp.metrics_config.metrics #=> Array
+    #   resp.metrics_config.metrics[0] #=> String, one of "EventCount"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/DeleteEventSourceMapping AWS API Documentation
     #
@@ -2673,6 +2695,7 @@ module Aws::Lambda
     #   * {Types::EventSourceMappingConfiguration#kms_key_arn #kms_key_arn} => String
     #   * {Types::EventSourceMappingConfiguration#filter_criteria_error #filter_criteria_error} => Types::FilterCriteriaError
     #   * {Types::EventSourceMappingConfiguration#event_source_mapping_arn #event_source_mapping_arn} => String
+    #   * {Types::EventSourceMappingConfiguration#metrics_config #metrics_config} => Types::EventSourceMappingMetricsConfig
     #
     #
     # @example Example: To get a Lambda function's event source mapping
@@ -2751,6 +2774,8 @@ module Aws::Lambda
     #   resp.filter_criteria_error.error_code #=> String
     #   resp.filter_criteria_error.message #=> String
     #   resp.event_source_mapping_arn #=> String
+    #   resp.metrics_config.metrics #=> Array
+    #   resp.metrics_config.metrics[0] #=> String, one of "EventCount"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/GetEventSourceMapping AWS API Documentation
     #
@@ -4595,6 +4620,8 @@ module Aws::Lambda
     #   resp.event_source_mappings[0].filter_criteria_error.error_code #=> String
     #   resp.event_source_mappings[0].filter_criteria_error.message #=> String
     #   resp.event_source_mappings[0].event_source_mapping_arn #=> String
+    #   resp.event_source_mappings[0].metrics_config.metrics #=> Array
+    #   resp.event_source_mappings[0].metrics_config.metrics[0] #=> String, one of "EventCount"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/ListEventSourceMappings AWS API Documentation
     #
@@ -6046,12 +6073,17 @@ module Aws::Lambda
     # retain discarded events, configure a dead-letter queue with
     # UpdateFunctionConfiguration.
     #
-    # To send an invocation record to a queue, topic, function, or event
-    # bus, specify a [destination][2]. You can configure separate
+    # To send an invocation record to a queue, topic, S3 bucket, function,
+    # or event bus, specify a [destination][2]. You can configure separate
     # destinations for successful invocations (on-success) and events that
     # fail all processing attempts (on-failure). You can configure
     # destinations in addition to or instead of a dead-letter queue.
     #
+    # <note markdown="1"> S3 buckets are supported only for on-failure destinations. To retain
+    # records of successful invocations, use another destination type.
+    #
+    #  </note>
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html
@@ -6095,10 +6127,17 @@ module Aws::Lambda
     #
     #   * **Queue** - The ARN of a standard SQS queue.
     #
+    #   * **Bucket** - The ARN of an Amazon S3 bucket.
+    #
     #   * **Topic** - The ARN of a standard SNS topic.
     #
     #   * **Event Bus** - The ARN of an Amazon EventBridge event bus.
     #
+    #   <note markdown="1"> S3 buckets are supported only for on-failure destinations. To retain
+    #   records of successful invocations, use another destination type.
+    #
+    #    </note>
+    #
     # @return [Types::FunctionEventInvokeConfig] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::FunctionEventInvokeConfig#last_modified #last_modified} => Time
@@ -6819,15 +6858,12 @@ module Aws::Lambda
     #
     # * [ Amazon DocumentDB][7]
     #
-    # The following error handling options are available only for stream
-    # sources (DynamoDB and Kinesis):
+    # The following error handling options are available only for DynamoDB
+    # and Kinesis event sources:
     #
     # * `BisectBatchOnFunctionError` – If the function returns an error,
     #   split the batch in two and retry.
     #
-    # * `DestinationConfig` – Send discarded records to an Amazon SQS queue
-    #   or Amazon SNS topic.
-    #
     # * `MaximumRecordAgeInSeconds` – Discard records older than the
     #   specified age. The default value is infinite (-1). When set to
     #   infinite (-1), failed records are retried until the record expires
@@ -6839,6 +6875,14 @@ module Aws::Lambda
     # * `ParallelizationFactor` – Process multiple batches from each shard
     #   concurrently.
     #
+    # For stream sources (DynamoDB, Kinesis, Amazon MSK, and self-managed
+    # Apache Kafka), the following option is also available:
+    #
+    # * `DestinationConfig` – Send discarded records to an Amazon SQS queue,
+    #   Amazon SNS topic, or Amazon S3 bucket.
+    #
+    # ^
+    #
     # For information about which configuration parameters apply to each
     # event source, see the following topics.
     #
@@ -7008,6 +7052,14 @@ module Aws::Lambda
     #
     #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics
     #
+    # @option params [Types::EventSourceMappingMetricsConfig] :metrics_config
+    #   The metrics configuration for your event source. For more information,
+    #   see [Event source mapping metrics][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics
+    #
     # @return [Types::EventSourceMappingConfiguration] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::EventSourceMappingConfiguration#uuid #uuid} => String
@@ -7040,6 +7092,7 @@ module Aws::Lambda
     #   * {Types::EventSourceMappingConfiguration#kms_key_arn #kms_key_arn} => String
     #   * {Types::EventSourceMappingConfiguration#filter_criteria_error #filter_criteria_error} => Types::FilterCriteriaError
     #   * {Types::EventSourceMappingConfiguration#event_source_mapping_arn #event_source_mapping_arn} => String
+    #   * {Types::EventSourceMappingConfiguration#metrics_config #metrics_config} => Types::EventSourceMappingMetricsConfig
     #
     #
     # @example Example: To update a Lambda function event source mapping
@@ -7109,6 +7162,9 @@ module Aws::Lambda
     #       full_document: "UpdateLookup", # accepts UpdateLookup, Default
     #     },
     #     kms_key_arn: "KMSKeyArn",
+    #     metrics_config: {
+    #       metrics: ["EventCount"], # accepts EventCount
+    #     },
     #   })
     #
     # @example Response structure
@@ -7155,6 +7211,8 @@ module Aws::Lambda
     #   resp.filter_criteria_error.error_code #=> String
     #   resp.filter_criteria_error.message #=> String
     #   resp.event_source_mapping_arn #=> String
+    #   resp.metrics_config.metrics #=> Array
+    #   resp.metrics_config.metrics[0] #=> String, one of "EventCount"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/UpdateEventSourceMapping AWS API Documentation
     #
@@ -7864,10 +7922,17 @@ module Aws::Lambda
     #
     #   * **Queue** - The ARN of a standard SQS queue.
     #
+    #   * **Bucket** - The ARN of an Amazon S3 bucket.
+    #
     #   * **Topic** - The ARN of a standard SNS topic.
     #
     #   * **Event Bus** - The ARN of an Amazon EventBridge event bus.
     #
+    #   <note markdown="1"> S3 buckets are supported only for on-failure destinations. To retain
+    #   records of successful invocations, use another destination type.
+    #
+    #    </note>
+    #
     # @return [Types::FunctionEventInvokeConfig] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::FunctionEventInvokeConfig#last_modified #last_modified} => Time
@@ -8071,7 +8136,7 @@ module Aws::Lambda
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-lambda'
-      context[:gem_version] = '1.142.0'
+      context[:gem_version] = '1.143.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -103,6 +103,9 @@ module Aws::Lambda
     EphemeralStorageSize = Shapes::IntegerShape.new(name: 'EphemeralStorageSize')
     EventSourceMappingArn = Shapes::StringShape.new(name: 'EventSourceMappingArn')
     EventSourceMappingConfiguration = Shapes::StructureShape.new(name: 'EventSourceMappingConfiguration')
+    EventSourceMappingMetric = Shapes::StringShape.new(name: 'EventSourceMappingMetric')
+    EventSourceMappingMetricList = Shapes::ListShape.new(name: 'EventSourceMappingMetricList')
+    EventSourceMappingMetricsConfig = Shapes::StructureShape.new(name: 'EventSourceMappingMetricsConfig')
     EventSourceMappingsList = Shapes::ListShape.new(name: 'EventSourceMappingsList')
     EventSourcePosition = Shapes::StringShape.new(name: 'EventSourcePosition')
     EventSourceToken = Shapes::StringShape.new(name: 'EventSourceToken')
@@ -533,6 +536,7 @@ module Aws::Lambda
     CreateEventSourceMappingRequest.add_member(:scaling_config, Shapes::ShapeRef.new(shape: ScalingConfig, location_name: "ScalingConfig"))
     CreateEventSourceMappingRequest.add_member(:document_db_event_source_config, Shapes::ShapeRef.new(shape: DocumentDBEventSourceConfig, location_name: "DocumentDBEventSourceConfig"))
     CreateEventSourceMappingRequest.add_member(:kms_key_arn, Shapes::ShapeRef.new(shape: KMSKeyArn, location_name: "KMSKeyArn"))
+    CreateEventSourceMappingRequest.add_member(:metrics_config, Shapes::ShapeRef.new(shape: EventSourceMappingMetricsConfig, location_name: "MetricsConfig"))
     CreateEventSourceMappingRequest.struct_class = Types::CreateEventSourceMappingRequest
 
     CreateFunctionRequest.add_member(:function_name, Shapes::ShapeRef.new(shape: FunctionName, required: true, location_name: "FunctionName"))
@@ -711,8 +715,14 @@ module Aws::Lambda
     EventSourceMappingConfiguration.add_member(:kms_key_arn, Shapes::ShapeRef.new(shape: KMSKeyArn, location_name: "KMSKeyArn"))
     EventSourceMappingConfiguration.add_member(:filter_criteria_error, Shapes::ShapeRef.new(shape: FilterCriteriaError, location_name: "FilterCriteriaError"))
     EventSourceMappingConfiguration.add_member(:event_source_mapping_arn, Shapes::ShapeRef.new(shape: EventSourceMappingArn, location_name: "EventSourceMappingArn"))
+    EventSourceMappingConfiguration.add_member(:metrics_config, Shapes::ShapeRef.new(shape: EventSourceMappingMetricsConfig, location_name: "MetricsConfig"))
     EventSourceMappingConfiguration.struct_class = Types::EventSourceMappingConfiguration
 
+    EventSourceMappingMetricList.member = Shapes::ShapeRef.new(shape: EventSourceMappingMetric)
+
+    EventSourceMappingMetricsConfig.add_member(:metrics, Shapes::ShapeRef.new(shape: EventSourceMappingMetricList, location_name: "Metrics"))
+    EventSourceMappingMetricsConfig.struct_class = Types::EventSourceMappingMetricsConfig
+
     EventSourceMappingsList.member = Shapes::ShapeRef.new(shape: EventSourceMappingConfiguration)
 
     FileSystemConfig.add_member(:arn, Shapes::ShapeRef.new(shape: FileSystemArn, required: true, location_name: "Arn"))
@@ -1480,6 +1490,7 @@ module Aws::Lambda
     UpdateEventSourceMappingRequest.add_member(:scaling_config, Shapes::ShapeRef.new(shape: ScalingConfig, location_name: "ScalingConfig"))
     UpdateEventSourceMappingRequest.add_member(:document_db_event_source_config, Shapes::ShapeRef.new(shape: DocumentDBEventSourceConfig, location_name: "DocumentDBEventSourceConfig"))
     UpdateEventSourceMappingRequest.add_member(:kms_key_arn, Shapes::ShapeRef.new(shape: KMSKeyArn, location_name: "KMSKeyArn"))
+    UpdateEventSourceMappingRequest.add_member(:metrics_config, Shapes::ShapeRef.new(shape: EventSourceMappingMetricsConfig, location_name: "MetricsConfig"))
     UpdateEventSourceMappingRequest.struct_class = Types::UpdateEventSourceMappingRequest
 
     UpdateFunctionCodeRequest.add_member(:function_name, Shapes::ShapeRef.new(shape: FunctionName, required: true, location: "uri", location_name: "FunctionName"))

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

@@ -863,6 +863,15 @@ module Aws::Lambda
     #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics
     #   @return [String]
     #
+    # @!attribute [rw] metrics_config
+    #   The metrics configuration for your event source. For more
+    #   information, see [Event source mapping metrics][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics
+    #   @return [Types::EventSourceMappingMetricsConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/CreateEventSourceMappingRequest AWS API Documentation
     #
     class CreateEventSourceMappingRequest < Struct.new(
@@ -890,7 +899,8 @@ module Aws::Lambda
       :self_managed_kafka_event_source_config,
       :scaling_config,
       :document_db_event_source_config,
-      :kms_key_arn)
+      :kms_key_arn,
+      :metrics_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2047,6 +2057,15 @@ module Aws::Lambda
     #   The Amazon Resource Name (ARN) of the event source mapping.
     #   @return [String]
     #
+    # @!attribute [rw] metrics_config
+    #   The metrics configuration for your event source. For more
+    #   information, see [Event source mapping metrics][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics
+    #   @return [Types::EventSourceMappingMetricsConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/EventSourceMappingConfiguration AWS API Documentation
     #
     class EventSourceMappingConfiguration < Struct.new(
@@ -2079,7 +2098,32 @@ module Aws::Lambda
       :document_db_event_source_config,
       :kms_key_arn,
       :filter_criteria_error,
-      :event_source_mapping_arn)
+      :event_source_mapping_arn,
+      :metrics_config)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The metrics configuration for your event source. Use this
+    # configuration object to define which metrics you want your event
+    # source mapping to produce.
+    #
+    # @!attribute [rw] metrics
+    #   The metrics you want your event source mapping to produce. Include
+    #   `EventCount` to receive event source mapping metrics related to the
+    #   number of events processed by your event source mapping. For more
+    #   information about these metrics, see [ Event source mapping
+    #   metrics][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/EventSourceMappingMetricsConfig AWS API Documentation
+    #
+    class EventSourceMappingMetricsConfig < Struct.new(
+      :metrics)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2566,9 +2610,16 @@ module Aws::Lambda
     #
     #   * **Queue** - The ARN of a standard SQS queue.
     #
+    #   * **Bucket** - The ARN of an Amazon S3 bucket.
+    #
     #   * **Topic** - The ARN of a standard SNS topic.
     #
     #   * **Event Bus** - The ARN of an Amazon EventBridge event bus.
+    #
+    #   <note markdown="1"> S3 buckets are supported only for on-failure destinations. To retain
+    #   records of successful invocations, use another destination type.
+    #
+    #    </note>
     #   @return [Types::DestinationConfig]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/FunctionEventInvokeConfig AWS API Documentation
@@ -4874,24 +4925,23 @@ module Aws::Lambda
     # @!attribute [rw] destination
     #   The Amazon Resource Name (ARN) of the destination resource.
     #
-    #   To retain records of [asynchronous invocations][1], you can
-    #   configure an Amazon SNS topic, Amazon SQS queue, Lambda function, or
-    #   Amazon EventBridge event bus as the destination.
+    #   To retain records of unsuccessful [asynchronous invocations][1], you
+    #   can configure an Amazon SNS topic, Amazon SQS queue, Amazon S3
+    #   bucket, Lambda function, or Amazon EventBridge event bus as the
+    #   destination.
     #
-    #   To retain records of failed invocations from [Kinesis and DynamoDB
-    #   event sources][2], you can configure an Amazon SNS topic or Amazon
-    #   SQS queue as the destination.
-    #
-    #   To retain records of failed invocations from [self-managed Kafka][3]
-    #   or [Amazon MSK][4], you can configure an Amazon SNS topic, Amazon
-    #   SQS queue, or Amazon S3 bucket as the destination.
+    #   To retain records of failed invocations from [Kinesis][2],
+    #   [DynamoDB][3], [self-managed Kafka][4] or [Amazon MSK][5], you can
+    #   configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket
+    #   as the destination.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations
-    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#event-source-mapping-destinations
-    #   [3]: https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination
-    #   [4]: https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination
+    #   [2]: https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html
+    #   [3]: https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html
+    #   [4]: https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination
+    #   [5]: https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/OnFailure AWS API Documentation
@@ -4904,6 +4954,14 @@ module Aws::Lambda
 
     # A destination for events that were processed successfully.
     #
+    # To retain records of successful [asynchronous invocations][1], you can
+    # configure an Amazon SNS topic, Amazon SQS queue, Lambda function, or
+    # Amazon EventBridge event bus as the destination.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations
+    #
     # @!attribute [rw] destination
     #   The Amazon Resource Name (ARN) of the destination resource.
     #   @return [String]
@@ -5346,9 +5404,16 @@ module Aws::Lambda
     #
     #   * **Queue** - The ARN of a standard SQS queue.
     #
+    #   * **Bucket** - The ARN of an Amazon S3 bucket.
+    #
     #   * **Topic** - The ARN of a standard SNS topic.
     #
     #   * **Event Bus** - The ARN of an Amazon EventBridge event bus.
+    #
+    #   <note markdown="1"> S3 buckets are supported only for on-failure destinations. To retain
+    #   records of successful invocations, use another destination type.
+    #
+    #    </note>
     #   @return [Types::DestinationConfig]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/PutFunctionEventInvokeConfigRequest AWS API Documentation
@@ -6494,6 +6559,15 @@ module Aws::Lambda
     #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventfiltering.html#filtering-basics
     #   @return [String]
     #
+    # @!attribute [rw] metrics_config
+    #   The metrics configuration for your event source. For more
+    #   information, see [Event source mapping metrics][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics
+    #   @return [Types::EventSourceMappingMetricsConfig]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/UpdateEventSourceMappingRequest AWS API Documentation
     #
     class UpdateEventSourceMappingRequest < Struct.new(
@@ -6513,7 +6587,8 @@ module Aws::Lambda
       :function_response_types,
       :scaling_config,
       :document_db_event_source_config,
-      :kms_key_arn)
+      :kms_key_arn,
+      :metrics_config)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -6877,9 +6952,16 @@ module Aws::Lambda
     #
     #   * **Queue** - The ARN of a standard SQS queue.
     #
+    #   * **Bucket** - The ARN of an Amazon S3 bucket.
+    #
     #   * **Topic** - The ARN of a standard SNS topic.
     #
     #   * **Event Bus** - The ARN of an Amazon EventBridge event bus.
+    #
+    #   <note markdown="1"> S3 buckets are supported only for on-failure destinations. To retain
+    #   records of successful invocations, use another destination type.
+    #
+    #    </note>
     #   @return [Types::DestinationConfig]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/lambda-2015-03-31/UpdateFunctionEventInvokeConfigRequest AWS API Documentation

data/lib/aws-sdk-lambda.rb

@@ -56,7 +56,7 @@ module Aws::Lambda
   autoload :Endpoints, 'aws-sdk-lambda/endpoints'
   autoload :EventStreams, 'aws-sdk-lambda/event_streams'
 
-  GEM_VERSION = '1.142.0'
+  GEM_VERSION = '1.143.0'
 
 end
 

data/sig/client.rbs

@@ -185,6 +185,7 @@ module Aws
         def kms_key_arn: () -> ::String
         def filter_criteria_error: () -> Types::FilterCriteriaError
         def event_source_mapping_arn: () -> ::String
+        def metrics_config: () -> Types::EventSourceMappingMetricsConfig
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Lambda/Client.html#create_event_source_mapping-instance_method
       def create_event_source_mapping: (
@@ -242,7 +243,10 @@ module Aws
                                            collection_name: ::String?,
                                            full_document: ("UpdateLookup" | "Default")?
                                          },
-                                         ?kms_key_arn: ::String
+                                         ?kms_key_arn: ::String,
+                                         ?metrics_config: {
+                                           metrics: Array[("EventCount")]?
+                                         }
                                        ) -> _CreateEventSourceMappingResponseSuccess
                                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateEventSourceMappingResponseSuccess
 
@@ -423,6 +427,7 @@ module Aws
         def kms_key_arn: () -> ::String
         def filter_criteria_error: () -> Types::FilterCriteriaError
         def event_source_mapping_arn: () -> ::String
+        def metrics_config: () -> Types::EventSourceMappingMetricsConfig
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Lambda/Client.html#delete_event_source_mapping-instance_method
       def delete_event_source_mapping: (
@@ -545,6 +550,7 @@ module Aws
         def kms_key_arn: () -> ::String
         def filter_criteria_error: () -> Types::FilterCriteriaError
         def event_source_mapping_arn: () -> ::String
+        def metrics_config: () -> Types::EventSourceMappingMetricsConfig
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Lambda/Client.html#get_event_source_mapping-instance_method
       def get_event_source_mapping: (
@@ -1242,6 +1248,7 @@ module Aws
         def kms_key_arn: () -> ::String
         def filter_criteria_error: () -> Types::FilterCriteriaError
         def event_source_mapping_arn: () -> ::String
+        def metrics_config: () -> Types::EventSourceMappingMetricsConfig
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Lambda/Client.html#update_event_source_mapping-instance_method
       def update_event_source_mapping: (
@@ -1285,7 +1292,10 @@ module Aws
                                            collection_name: ::String?,
                                            full_document: ("UpdateLookup" | "Default")?
                                          },
-                                         ?kms_key_arn: ::String
+                                         ?kms_key_arn: ::String,
+                                         ?metrics_config: {
+                                           metrics: Array[("EventCount")]?
+                                         }
                                        ) -> _UpdateEventSourceMappingResponseSuccess
                                      | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateEventSourceMappingResponseSuccess
 

data/sig/types.rbs

@@ -181,6 +181,7 @@ module Aws::Lambda
       attr_accessor scaling_config: Types::ScalingConfig
       attr_accessor document_db_event_source_config: Types::DocumentDBEventSourceConfig
       attr_accessor kms_key_arn: ::String
+      attr_accessor metrics_config: Types::EventSourceMappingMetricsConfig
       SENSITIVE: []
     end
 
@@ -410,6 +411,12 @@ module Aws::Lambda
       attr_accessor kms_key_arn: ::String
       attr_accessor filter_criteria_error: Types::FilterCriteriaError
       attr_accessor event_source_mapping_arn: ::String
+      attr_accessor metrics_config: Types::EventSourceMappingMetricsConfig
+      SENSITIVE: []
+    end
+
+    class EventSourceMappingMetricsConfig
+      attr_accessor metrics: ::Array[("EventCount")]
       SENSITIVE: []
     end
 
@@ -1401,6 +1408,7 @@ module Aws::Lambda
       attr_accessor scaling_config: Types::ScalingConfig
       attr_accessor document_db_event_source_config: Types::DocumentDBEventSourceConfig
       attr_accessor kms_key_arn: ::String
+      attr_accessor metrics_config: Types::EventSourceMappingMetricsConfig
       SENSITIVE: []
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-lambda
 version: !ruby/object:Gem::Version
-  version: 1.142.0
+  version: 1.143.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-20 00:00:00.000000000 Z
+date: 2024-11-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core