@aws-sdk/client-lambda 3.697.0 → 3.698.0

package/README.md

@@ -24,7 +24,7 @@ response. </p>
 line tools to access the API. For installation instructions, see <a href="http://aws.amazon.com/tools/">Tools for
 Amazon Web Services</a>. </p>
 <p>For a list of Region-specific endpoints that Lambda supports,
-see <a href="https://docs.aws.amazon.com/general/latest/gr/lambda-service.html/">Lambda
+see <a href="https://docs.aws.amazon.com/general/latest/gr/lambda-service.html">Lambda
 endpoints and quotas </a> in the <i>Amazon Web Services General Reference.</i>. </p>
 <p>When making the API calls, you will need to
 authenticate your request by providing a signature. Lambda supports signature version 4. For more information,

package/dist-cjs/index.js

@@ -57,6 +57,7 @@ __export(src_exports, {
   EnvironmentErrorFilterSensitiveLog: () => EnvironmentErrorFilterSensitiveLog,
   EnvironmentFilterSensitiveLog: () => EnvironmentFilterSensitiveLog,
   EnvironmentResponseFilterSensitiveLog: () => EnvironmentResponseFilterSensitiveLog,
+  EventSourceMappingMetric: () => EventSourceMappingMetric,
   EventSourcePosition: () => EventSourcePosition,
   FullDocument: () => FullDocument,
   FunctionCodeFilterSensitiveLog: () => FunctionCodeFilterSensitiveLog,
@@ -544,6 +545,9 @@ var FullDocument = {
 var FunctionResponseType = {
   ReportBatchItemFailures: "ReportBatchItemFailures"
 };
+var EventSourceMappingMetric = {
+  EventCount: "EventCount"
+};
 var EndPointType = {
   KAFKA_BOOTSTRAP_SERVERS: "KAFKA_BOOTSTRAP_SERVERS"
 };
@@ -1536,6 +1540,7 @@ var se_CreateEventSourceMappingCommand = /* @__PURE__ */ __name(async (input, co
       MaximumBatchingWindowInSeconds: [],
       MaximumRecordAgeInSeconds: [],
       MaximumRetryAttempts: [],
+      MetricsConfig: (_) => (0, import_smithy_client._json)(_),
       ParallelizationFactor: [],
       Queues: (_) => (0, import_smithy_client._json)(_),
       ScalingConfig: (_) => (0, import_smithy_client._json)(_),
@@ -2368,6 +2373,7 @@ var se_UpdateEventSourceMappingCommand = /* @__PURE__ */ __name(async (input, co
       MaximumBatchingWindowInSeconds: [],
       MaximumRecordAgeInSeconds: [],
       MaximumRetryAttempts: [],
+      MetricsConfig: (_) => (0, import_smithy_client._json)(_),
       ParallelizationFactor: [],
       ScalingConfig: (_) => (0, import_smithy_client._json)(_),
       SourceAccessConfigurations: (_) => (0, import_smithy_client._json)(_),
@@ -2565,6 +2571,7 @@ var de_CreateEventSourceMappingCommand = /* @__PURE__ */ __name(async (output, c
     MaximumBatchingWindowInSeconds: import_smithy_client.expectInt32,
     MaximumRecordAgeInSeconds: import_smithy_client.expectInt32,
     MaximumRetryAttempts: import_smithy_client.expectInt32,
+    MetricsConfig: import_smithy_client._json,
     ParallelizationFactor: import_smithy_client.expectInt32,
     Queues: import_smithy_client._json,
     ScalingConfig: import_smithy_client._json,
@@ -2696,6 +2703,7 @@ var de_DeleteEventSourceMappingCommand = /* @__PURE__ */ __name(async (output, c
     MaximumBatchingWindowInSeconds: import_smithy_client.expectInt32,
     MaximumRecordAgeInSeconds: import_smithy_client.expectInt32,
     MaximumRetryAttempts: import_smithy_client.expectInt32,
+    MetricsConfig: import_smithy_client._json,
     ParallelizationFactor: import_smithy_client.expectInt32,
     Queues: import_smithy_client._json,
     ScalingConfig: import_smithy_client._json,
@@ -2857,6 +2865,7 @@ var de_GetEventSourceMappingCommand = /* @__PURE__ */ __name(async (output, cont
     MaximumBatchingWindowInSeconds: import_smithy_client.expectInt32,
     MaximumRecordAgeInSeconds: import_smithy_client.expectInt32,
     MaximumRetryAttempts: import_smithy_client.expectInt32,
+    MetricsConfig: import_smithy_client._json,
     ParallelizationFactor: import_smithy_client.expectInt32,
     Queues: import_smithy_client._json,
     ScalingConfig: import_smithy_client._json,
@@ -3622,6 +3631,7 @@ var de_UpdateEventSourceMappingCommand = /* @__PURE__ */ __name(async (output, c
     MaximumBatchingWindowInSeconds: import_smithy_client.expectInt32,
     MaximumRecordAgeInSeconds: import_smithy_client.expectInt32,
     MaximumRetryAttempts: import_smithy_client.expectInt32,
+    MetricsConfig: import_smithy_client._json,
     ParallelizationFactor: import_smithy_client.expectInt32,
     Queues: import_smithy_client._json,
     ScalingConfig: import_smithy_client._json,
@@ -4549,6 +4559,7 @@ var de_EventSourceMappingConfiguration = /* @__PURE__ */ __name((output, context
     MaximumBatchingWindowInSeconds: import_smithy_client.expectInt32,
     MaximumRecordAgeInSeconds: import_smithy_client.expectInt32,
     MaximumRetryAttempts: import_smithy_client.expectInt32,
+    MetricsConfig: import_smithy_client._json,
     ParallelizationFactor: import_smithy_client.expectInt32,
     Queues: import_smithy_client._json,
     ScalingConfig: import_smithy_client._json,
@@ -6083,6 +6094,7 @@ var waitUntilPublishedVersionActive = /* @__PURE__ */ __name(async (params, inpu
   CodeSigningPolicy,
   FullDocument,
   FunctionResponseType,
+  EventSourceMappingMetric,
   EndPointType,
   SourceAccessType,
   EventSourcePosition,

package/dist-es/models/models_0.js

@@ -130,6 +130,9 @@ export const FullDocument = {
 export const FunctionResponseType = {
     ReportBatchItemFailures: "ReportBatchItemFailures",
 };
+export const EventSourceMappingMetric = {
+    EventCount: "EventCount",
+};
 export const EndPointType = {
     KAFKA_BOOTSTRAP_SERVERS: "KAFKA_BOOTSTRAP_SERVERS",
 };

package/dist-es/protocols/Aws_restJson1.js

@@ -104,6 +104,7 @@ export const se_CreateEventSourceMappingCommand = async (input, context) => {
         MaximumBatchingWindowInSeconds: [],
         MaximumRecordAgeInSeconds: [],
         MaximumRetryAttempts: [],
+        MetricsConfig: (_) => _json(_),
         ParallelizationFactor: [],
         Queues: (_) => _json(_),
         ScalingConfig: (_) => _json(_),
@@ -908,6 +909,7 @@ export const se_UpdateEventSourceMappingCommand = async (input, context) => {
         MaximumBatchingWindowInSeconds: [],
         MaximumRecordAgeInSeconds: [],
         MaximumRetryAttempts: [],
+        MetricsConfig: (_) => _json(_),
         ParallelizationFactor: [],
         ScalingConfig: (_) => _json(_),
         SourceAccessConfigurations: (_) => _json(_),
@@ -1096,6 +1098,7 @@ export const de_CreateEventSourceMappingCommand = async (output, context) => {
         MaximumBatchingWindowInSeconds: __expectInt32,
         MaximumRecordAgeInSeconds: __expectInt32,
         MaximumRetryAttempts: __expectInt32,
+        MetricsConfig: _json,
         ParallelizationFactor: __expectInt32,
         Queues: _json,
         ScalingConfig: _json,
@@ -1227,6 +1230,7 @@ export const de_DeleteEventSourceMappingCommand = async (output, context) => {
         MaximumBatchingWindowInSeconds: __expectInt32,
         MaximumRecordAgeInSeconds: __expectInt32,
         MaximumRetryAttempts: __expectInt32,
+        MetricsConfig: _json,
         ParallelizationFactor: __expectInt32,
         Queues: _json,
         ScalingConfig: _json,
@@ -1388,6 +1392,7 @@ export const de_GetEventSourceMappingCommand = async (output, context) => {
         MaximumBatchingWindowInSeconds: __expectInt32,
         MaximumRecordAgeInSeconds: __expectInt32,
         MaximumRetryAttempts: __expectInt32,
+        MetricsConfig: _json,
         ParallelizationFactor: __expectInt32,
         Queues: _json,
         ScalingConfig: _json,
@@ -2153,6 +2158,7 @@ export const de_UpdateEventSourceMappingCommand = async (output, context) => {
         MaximumBatchingWindowInSeconds: __expectInt32,
         MaximumRecordAgeInSeconds: __expectInt32,
         MaximumRetryAttempts: __expectInt32,
+        MetricsConfig: _json,
         ParallelizationFactor: __expectInt32,
         Queues: _json,
         ScalingConfig: _json,
@@ -3082,6 +3088,7 @@ const de_EventSourceMappingConfiguration = (output, context) => {
         MaximumBatchingWindowInSeconds: __expectInt32,
         MaximumRecordAgeInSeconds: __expectInt32,
         MaximumRetryAttempts: __expectInt32,
+        MetricsConfig: _json,
         ParallelizationFactor: __expectInt32,
         Queues: _json,
         ScalingConfig: _json,

package/dist-types/Lambda.d.ts

@@ -501,7 +501,7 @@ export interface Lambda {
  *       line tools to access the API. For installation instructions, see <a href="http://aws.amazon.com/tools/">Tools for
  *         Amazon Web Services</a>. </p>
  *          <p>For a list of Region-specific endpoints that Lambda supports,
- *       see <a href="https://docs.aws.amazon.com/general/latest/gr/lambda-service.html/">Lambda
+ *       see <a href="https://docs.aws.amazon.com/general/latest/gr/lambda-service.html">Lambda
  *         endpoints and quotas </a> in the <i>Amazon Web Services General Reference.</i>. </p>
  *          <p>When making the API calls, you will need to
  *       authenticate your request by providing a signature. Lambda supports signature version 4. For more information,

package/dist-types/LambdaClient.d.ts

@@ -241,7 +241,7 @@ export interface LambdaClientResolvedConfig extends LambdaClientResolvedConfigTy
  *       line tools to access the API. For installation instructions, see <a href="http://aws.amazon.com/tools/">Tools for
  *         Amazon Web Services</a>. </p>
  *          <p>For a list of Region-specific endpoints that Lambda supports,
- *       see <a href="https://docs.aws.amazon.com/general/latest/gr/lambda-service.html/">Lambda
+ *       see <a href="https://docs.aws.amazon.com/general/latest/gr/lambda-service.html">Lambda
  *         endpoints and quotas </a> in the <i>Amazon Web Services General Reference.</i>. </p>
  *          <p>When making the API calls, you will need to
  *       authenticate your request by providing a signature. Lambda supports signature version 4. For more information,

package/dist-types/commands/CreateEventSourceMappingCommand.d.ts

@@ -73,7 +73,7 @@ declare const CreateEventSourceMappingCommand_base: {
  *                </p>
  *             </li>
  *          </ul>
- *          <p>The following error handling options are available only for stream sources (DynamoDB and Kinesis):</p>
+ *          <p>The following error handling options are available only for DynamoDB and Kinesis event sources:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -81,10 +81,6 @@ declare const CreateEventSourceMappingCommand_base: {
  *             </li>
  *             <li>
  *                <p>
- *                   <code>DestinationConfig</code> – Send discarded records to an Amazon SQS queue or Amazon SNS topic.</p>
- *             </li>
- *             <li>
- *                <p>
  *                   <code>MaximumRecordAgeInSeconds</code> – 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</p>
  *             </li>
  *             <li>
@@ -96,6 +92,14 @@ declare const CreateEventSourceMappingCommand_base: {
  *                   <code>ParallelizationFactor</code> – Process multiple batches from each shard concurrently.</p>
  *             </li>
  *          </ul>
+ *          <p>For stream sources (DynamoDB, Kinesis, Amazon MSK, and self-managed Apache Kafka), the following option is also available:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <code>DestinationConfig</code> – Send discarded records to an Amazon SQS queue, Amazon SNS topic, or
+ *             Amazon S3 bucket.</p>
+ *             </li>
+ *          </ul>
  *          <p>For information about which configuration parameters apply to each event source, see the following topics.</p>
  *          <ul>
  *             <li>
@@ -215,6 +219,11 @@ declare const CreateEventSourceMappingCommand_base: {
  *     FullDocument: "UpdateLookup" || "Default",
  *   },
  *   KMSKeyArn: "STRING_VALUE",
+ *   MetricsConfig: { // EventSourceMappingMetricsConfig
+ *     Metrics: [ // EventSourceMappingMetricList
+ *       "EventCount",
+ *     ],
+ *   },
  * };
  * const command = new CreateEventSourceMappingCommand(input);
  * const response = await client.send(command);
@@ -292,6 +301,11 @@ declare const CreateEventSourceMappingCommand_base: {
  * //     Message: "STRING_VALUE",
  * //   },
  * //   EventSourceMappingArn: "STRING_VALUE",
+ * //   MetricsConfig: { // EventSourceMappingMetricsConfig
+ * //     Metrics: [ // EventSourceMappingMetricList
+ * //       "EventCount",
+ * //     ],
+ * //   },
  * // };
  *
  * ```

package/dist-types/commands/DeleteEventSourceMappingCommand.d.ts

@@ -116,6 +116,11 @@ declare const DeleteEventSourceMappingCommand_base: {
  * //     Message: "STRING_VALUE",
  * //   },
  * //   EventSourceMappingArn: "STRING_VALUE",
+ * //   MetricsConfig: { // EventSourceMappingMetricsConfig
+ * //     Metrics: [ // EventSourceMappingMetricList
+ * //       "EventCount",
+ * //     ],
+ * //   },
  * // };
  *
  * ```

package/dist-types/commands/GetEventSourceMappingCommand.d.ts

@@ -114,6 +114,11 @@ declare const GetEventSourceMappingCommand_base: {
  * //     Message: "STRING_VALUE",
  * //   },
  * //   EventSourceMappingArn: "STRING_VALUE",
+ * //   MetricsConfig: { // EventSourceMappingMetricsConfig
+ * //     Metrics: [ // EventSourceMappingMetricList
+ * //       "EventCount",
+ * //     ],
+ * //   },
  * // };
  *
  * ```

package/dist-types/commands/ListEventSourceMappingsCommand.d.ts

@@ -120,6 +120,11 @@ declare const ListEventSourceMappingsCommand_base: {
  * //         Message: "STRING_VALUE",
  * //       },
  * //       EventSourceMappingArn: "STRING_VALUE",
+ * //       MetricsConfig: { // EventSourceMappingMetricsConfig
+ * //         Metrics: [ // EventSourceMappingMetricList
+ * //           "EventCount",
+ * //         ],
+ * //       },
  * //     },
  * //   ],
  * // };

package/dist-types/commands/PutFunctionEventInvokeConfigCommand.d.ts

@@ -35,9 +35,12 @@ declare const PutFunctionEventInvokeConfigCommand_base: {
  *       events in a queue for up to six hours. When an event fails all processing attempts or stays in the asynchronous
  *       invocation queue for too long, Lambda discards it. To retain discarded events, configure a dead-letter queue with
  *         <a>UpdateFunctionConfiguration</a>.</p>
- *          <p>To send an invocation record to a queue, topic, function, or event bus, specify a <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations">destination</a>. You can configure separate destinations for successful invocations (on-success) and events
+ *          <p>To send an invocation record to a queue, topic, S3 bucket, function, or event bus, specify a <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations">destination</a>. 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.</p>
+ *          <note>
+ *             <p>S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.</p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/UpdateEventSourceMappingCommand.d.ts

@@ -74,7 +74,7 @@ declare const UpdateEventSourceMappingCommand_base: {
  *                </p>
  *             </li>
  *          </ul>
- *          <p>The following error handling options are available only for stream sources (DynamoDB and Kinesis):</p>
+ *          <p>The following error handling options are available only for DynamoDB and Kinesis event sources:</p>
  *          <ul>
  *             <li>
  *                <p>
@@ -82,10 +82,6 @@ declare const UpdateEventSourceMappingCommand_base: {
  *             </li>
  *             <li>
  *                <p>
- *                   <code>DestinationConfig</code> – Send discarded records to an Amazon SQS queue or Amazon SNS topic.</p>
- *             </li>
- *             <li>
- *                <p>
  *                   <code>MaximumRecordAgeInSeconds</code> – 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</p>
  *             </li>
  *             <li>
@@ -97,6 +93,14 @@ declare const UpdateEventSourceMappingCommand_base: {
  *                   <code>ParallelizationFactor</code> – Process multiple batches from each shard concurrently.</p>
  *             </li>
  *          </ul>
+ *          <p>For stream sources (DynamoDB, Kinesis, Amazon MSK, and self-managed Apache Kafka), the following option is also available:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <code>DestinationConfig</code> – Send discarded records to an Amazon SQS queue, Amazon SNS topic, or
+ *             Amazon S3 bucket.</p>
+ *             </li>
+ *          </ul>
  *          <p>For information about which configuration parameters apply to each event source, see the following topics.</p>
  *          <ul>
  *             <li>
@@ -192,6 +196,11 @@ declare const UpdateEventSourceMappingCommand_base: {
  *     FullDocument: "UpdateLookup" || "Default",
  *   },
  *   KMSKeyArn: "STRING_VALUE",
+ *   MetricsConfig: { // EventSourceMappingMetricsConfig
+ *     Metrics: [ // EventSourceMappingMetricList
+ *       "EventCount",
+ *     ],
+ *   },
  * };
  * const command = new UpdateEventSourceMappingCommand(input);
  * const response = await client.send(command);
@@ -269,6 +278,11 @@ declare const UpdateEventSourceMappingCommand_base: {
  * //     Message: "STRING_VALUE",
  * //   },
  * //   EventSourceMappingArn: "STRING_VALUE",
+ * //   MetricsConfig: { // EventSourceMappingMetricsConfig
+ * //     Metrics: [ // EventSourceMappingMetricList
+ * //       "EventCount",
+ * //     ],
+ * //   },
  * // };
  *
  * ```

package/dist-types/index.d.ts

@@ -16,7 +16,7 @@
  *       line tools to access the API. For installation instructions, see <a href="http://aws.amazon.com/tools/">Tools for
  *         Amazon Web Services</a>. </p>
  *          <p>For a list of Region-specific endpoints that Lambda supports,
- *       see <a href="https://docs.aws.amazon.com/general/latest/gr/lambda-service.html/">Lambda
+ *       see <a href="https://docs.aws.amazon.com/general/latest/gr/lambda-service.html">Lambda
  *         endpoints and quotas </a> in the <i>Amazon Web Services General Reference.</i>. </p>
  *          <p>When making the API calls, you will need to
  *       authenticate your request by providing a signature. Lambda supports signature version 4. For more information,

package/dist-types/models/models_0.d.ts

@@ -616,13 +616,11 @@ export interface CreateCodeSigningConfigResponse {
 export interface OnFailure {
     /**
      * <p>The Amazon Resource Name (ARN) of the destination resource.</p>
-     *          <p>To retain records of <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations">asynchronous invocations</a>,
-     *       you can configure an Amazon SNS topic, Amazon SQS queue, Lambda function,
+     *          <p>To retain records of unsuccessful <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations">asynchronous invocations</a>,
+     *       you can configure an Amazon SNS topic, Amazon SQS queue, Amazon S3 bucket, Lambda function,
      *       or Amazon EventBridge event bus as the destination.</p>
-     *          <p>To retain records of failed invocations from <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-eventsourcemapping.html#event-source-mapping-destinations">Kinesis and
-     *       DynamoDB event sources</a>, you can configure an Amazon SNS topic or
-     *       Amazon SQS queue as the destination.</p>
-     *          <p>To retain records of failed invocations from <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination">self-managed Kafka</a> or
+     *          <p>To retain records of failed invocations from <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-kinesis.html">Kinesis</a>,
+     *       <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-ddb.html">DynamoDB</a>, <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-kafka.html#services-smaa-onfailure-destination">self-managed Kafka</a> or
      *       <a href="https://docs.aws.amazon.com/lambda/latest/dg/with-msk.html#services-msk-onfailure-destination">Amazon MSK</a>,
      *       you can configure an Amazon SNS topic, Amazon SQS queue, or Amazon S3 bucket as the destination.</p>
      * @public
@@ -631,6 +629,9 @@ export interface OnFailure {
 }
 /**
  * <p>A destination for events that were processed successfully.</p>
+ *          <p>To retain records of successful <a href="https://docs.aws.amazon.com/lambda/latest/dg/invocation-async.html#invocation-async-destinations">asynchronous invocations</a>,
+ *       you can configure an Amazon SNS topic, Amazon SQS queue, Lambda function,
+ *       or Amazon EventBridge event bus as the destination.</p>
  * @public
  */
 export interface OnSuccess {
@@ -740,6 +741,34 @@ export declare const FunctionResponseType: {
  * @public
  */
 export type FunctionResponseType = (typeof FunctionResponseType)[keyof typeof FunctionResponseType];
+/**
+ * @public
+ * @enum
+ */
+export declare const EventSourceMappingMetric: {
+    readonly EventCount: "EventCount";
+};
+/**
+ * @public
+ */
+export type EventSourceMappingMetric = (typeof EventSourceMappingMetric)[keyof typeof EventSourceMappingMetric];
+/**
+ * <p>The metrics configuration for your event source. Use this configuration object to define which metrics you want your
+ *       event source mapping to produce.</p>
+ * @public
+ */
+export interface EventSourceMappingMetricsConfig {
+    /**
+     * <p>
+     *       The metrics you want your event source mapping to produce. Include <code>EventCount</code> 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 <a href="https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics">
+     *       Event source mapping metrics</a>.
+     *     </p>
+     * @public
+     */
+    Metrics?: EventSourceMappingMetric[] | undefined;
+}
 /**
  * <p>(Amazon SQS only) The scaling configuration for the event source. To remove the configuration, pass an empty value.</p>
  * @public
@@ -1099,6 +1128,11 @@ export interface CreateEventSourceMappingRequest {
      * @public
      */
     KMSKeyArn?: string | undefined;
+    /**
+     * <p>The metrics configuration for your event source. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics">Event source mapping metrics</a>.</p>
+     * @public
+     */
+    MetricsConfig?: EventSourceMappingMetricsConfig | undefined;
 }
 /**
  * <p>An object that contains details about an error related to filter criteria encryption.</p>
@@ -1295,6 +1329,11 @@ export interface EventSourceMappingConfiguration {
      * @public
      */
     EventSourceMappingArn?: string | undefined;
+    /**
+     * <p>The metrics configuration for your event source. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics">Event source mapping metrics</a>.</p>
+     * @public
+     */
+    MetricsConfig?: EventSourceMappingMetricsConfig | undefined;
 }
 /**
  * <p>The specified code signing configuration does not exist.</p>
@@ -3180,6 +3219,10 @@ export interface FunctionEventInvokeConfig {
      *             </li>
      *             <li>
      *                <p>
+     *                   <b>Bucket</b> - The ARN of an Amazon S3 bucket.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <b>Topic</b> - The ARN of a standard SNS topic.</p>
      *             </li>
      *             <li>
@@ -3187,6 +3230,9 @@ export interface FunctionEventInvokeConfig {
      *                   <b>Event Bus</b> - The ARN of an Amazon EventBridge event bus.</p>
      *             </li>
      *          </ul>
+     *          <note>
+     *             <p>S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.</p>
+     *          </note>
      * @public
      */
     DestinationConfig?: DestinationConfig | undefined;
@@ -5564,6 +5610,10 @@ export interface PutFunctionEventInvokeConfigRequest {
      *             </li>
      *             <li>
      *                <p>
+     *                   <b>Bucket</b> - The ARN of an Amazon S3 bucket.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <b>Topic</b> - The ARN of a standard SNS topic.</p>
      *             </li>
      *             <li>
@@ -5571,6 +5621,9 @@ export interface PutFunctionEventInvokeConfigRequest {
      *                   <b>Event Bus</b> - The ARN of an Amazon EventBridge event bus.</p>
      *             </li>
      *          </ul>
+     *          <note>
+     *             <p>S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.</p>
+     *          </note>
      * @public
      */
     DestinationConfig?: DestinationConfig | undefined;
@@ -6144,6 +6197,11 @@ export interface UpdateEventSourceMappingRequest {
      * @public
      */
     KMSKeyArn?: string | undefined;
+    /**
+     * <p>The metrics configuration for your event source. For more information, see <a href="https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html#event-source-mapping-metrics">Event source mapping metrics</a>.</p>
+     * @public
+     */
+    MetricsConfig?: EventSourceMappingMetricsConfig | undefined;
 }
 /**
  * @public
@@ -6447,6 +6505,10 @@ export interface UpdateFunctionEventInvokeConfigRequest {
      *             </li>
      *             <li>
      *                <p>
+     *                   <b>Bucket</b> - The ARN of an Amazon S3 bucket.</p>
+     *             </li>
+     *             <li>
+     *                <p>
      *                   <b>Topic</b> - The ARN of a standard SNS topic.</p>
      *             </li>
      *             <li>
@@ -6454,6 +6516,9 @@ export interface UpdateFunctionEventInvokeConfigRequest {
      *                   <b>Event Bus</b> - The ARN of an Amazon EventBridge event bus.</p>
      *             </li>
      *          </ul>
+     *          <note>
+     *             <p>S3 buckets are supported only for on-failure destinations. To retain records of successful invocations, use another destination type.</p>
+     *          </note>
      * @public
      */
     DestinationConfig?: DestinationConfig | undefined;

package/dist-types/ts3.4/models/models_0.d.ts

@@ -211,6 +211,14 @@ export declare const FunctionResponseType: {
 };
 export type FunctionResponseType =
   (typeof FunctionResponseType)[keyof typeof FunctionResponseType];
+export declare const EventSourceMappingMetric: {
+  readonly EventCount: "EventCount";
+};
+export type EventSourceMappingMetric =
+  (typeof EventSourceMappingMetric)[keyof typeof EventSourceMappingMetric];
+export interface EventSourceMappingMetricsConfig {
+  Metrics?: EventSourceMappingMetric[] | undefined;
+}
 export interface ScalingConfig {
   MaximumConcurrency?: number | undefined;
 }
@@ -277,6 +285,7 @@ export interface CreateEventSourceMappingRequest {
   ScalingConfig?: ScalingConfig | undefined;
   DocumentDBEventSourceConfig?: DocumentDBEventSourceConfig | undefined;
   KMSKeyArn?: string | undefined;
+  MetricsConfig?: EventSourceMappingMetricsConfig | undefined;
 }
 export interface FilterCriteriaError {
   ErrorCode?: string | undefined;
@@ -317,6 +326,7 @@ export interface EventSourceMappingConfiguration {
   KMSKeyArn?: string | undefined;
   FilterCriteriaError?: FilterCriteriaError | undefined;
   EventSourceMappingArn?: string | undefined;
+  MetricsConfig?: EventSourceMappingMetricsConfig | undefined;
 }
 export declare class CodeSigningConfigNotFoundException extends __BaseException {
   readonly name: "CodeSigningConfigNotFoundException";
@@ -1512,6 +1522,7 @@ export interface UpdateEventSourceMappingRequest {
   ScalingConfig?: ScalingConfig | undefined;
   DocumentDBEventSourceConfig?: DocumentDBEventSourceConfig | undefined;
   KMSKeyArn?: string | undefined;
+  MetricsConfig?: EventSourceMappingMetricsConfig | undefined;
 }
 export interface UpdateFunctionCodeRequest {
   FunctionName: string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-lambda",
   "description": "AWS SDK for JavaScript Lambda Client for Node.js, Browser and React Native",
-  "version": "3.697.0",
+  "version": "3.698.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-lambda",