# S3OnFailureDestination

An S3 dead letter bucket destination configuration for a Lambda event source.

Extends: S3OnFailureDestination
Implements: IEventSourceDlq

- Source: [`aws-lambda-event-sources/lib/s3-onfailuire-destination.ts`](https://github.com/aws/aws-cdk/blob/v2.274.0/packages/aws-cdk-lib/aws-lambda-event-sources/lib/s3-onfailuire-destination.ts#L7)
- Type last changed: v2.109.0 · 16 Nov 2023

## Example

```ts
import { ManagedKafkaEventSource, S3OnFailureDestination } from 'aws-cdk-lib/aws-lambda-event-sources';
import { IBucket } from 'aws-cdk-lib/aws-s3';

// Your MSK cluster arn
const clusterArn = 'arn:aws:kafka:us-east-1:0123456789019:cluster/SalesCluster/abcd1234-abcd-cafe-abab-9876543210ab-4';

// The Kafka topic you want to subscribe to
const topic = 'some-cool-topic';

declare const bucket: IBucket;
declare const myFunction: lambda.Function;

const s3OnFailureDestination = new S3OnFailureDestination(bucket);

myFunction.addEventSource(new ManagedKafkaEventSource({
  clusterArn,
  topic,
  startingPosition: lambda.StartingPosition.TRIM_HORIZON,
  onFailure: s3OnFailureDestination,
}));
```

## Initializer

```ts
new S3OnFailureDestination(bucket: IBucket)
```

## Methods

- `bind(_target: IEventSourceMapping, targetHandler: IFunction): DlqDestinationConfig` — Returns a destination configuration for the DLQ.
