# SqsDestination

Use a SQS queue as a Lambda destination.

Implements: [IDestination](/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.IDestination.html)

- Source: [`aws-lambda-destinations/lib/sqs.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/aws-lambda-destinations/lib/sqs.ts#L8)

## Example

TypeScript:

```ts
// An sqs queue for unsuccessful invocations of a lambda function
import * as sqs from 'aws-cdk-lib/aws-sqs';

const deadLetterQueue = new sqs.Queue(this, 'DeadLetterQueue');

const myFn = new lambda.Function(this, 'Fn', {
  runtime: lambda.Runtime.NODEJS_LATEST,
  handler: 'index.handler',
  code: lambda.Code.fromInline('// your code'),
  // sqs queue for unsuccessful invocations
  onFailure: new destinations.SqsDestination(deadLetterQueue),
});
```

Python:

```python
# An sqs queue for unsuccessful invocations of a lambda function
import aws_cdk.aws_sqs as sqs

dead_letter_queue = sqs.Queue(self, "DeadLetterQueue")

my_fn = lambda_.Function(self, "Fn",
    runtime=lambda_.Runtime.NODEJS_LATEST,
    handler="index.handler",
    code=lambda_.Code.from_inline("// your code"),
    # sqs queue for unsuccessful invocations
    on_failure=destinations.SqsDestination(dead_letter_queue)
)
```

Java:

```java
// An sqs queue for unsuccessful invocations of a lambda function
import software.amazon.awscdk.services.sqs.*;

Queue deadLetterQueue = new Queue(this, "DeadLetterQueue");

Function myFn = Function.Builder.create(this, "Fn")
        .runtime(Runtime.NODEJS_LATEST)
        .handler("index.handler")
        .code(Code.fromInline("// your code"))
        // sqs queue for unsuccessful invocations
        .onFailure(new SqsDestination(deadLetterQueue))
        .build();
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.Lib
// An sqs queue for unsuccessful invocations of a lambda function
using Amazon.CDK.AWS.SQS;

var deadLetterQueue = new Queue(this, "DeadLetterQueue");

var myFn = new Function(this, "Fn", new FunctionProps {
    Runtime = Runtime.NODEJS_LATEST,
    Handler = "index.handler",
    Code = Code.FromInline("// your code"),
    // sqs queue for unsuccessful invocations
    OnFailure = new SqsDestination(deadLetterQueue)
});
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// An sqs queue for unsuccessful invocations of a lambda function
import sqs "github.com/aws/aws-cdk-go/awscdk"

deadLetterQueue := sqs.NewQueue(this, jsii.String("DeadLetterQueue"))

myFn := lambda.NewFunction(this, jsii.String("Fn"), &FunctionProps{
	Runtime: lambda.Runtime_NODEJS_LATEST(),
	Handler: jsii.String("index.handler"),
	Code: lambda.Code_FromInline(jsii.String("// your code")),
	// sqs queue for unsuccessful invocations
	OnFailure: destinations.NewSqsDestination(deadLetterQueue),
})
```

## Initializer

TypeScript:

```ts
new SqsDestination(queue: IQueue)
```

Python:

```python
SqsDestination(queue: IQueue)
```

Java:

```java
new SqsDestination(IQueue queue)
```

C# / .NET:

```csharp
new SqsDestination(IQueue queue)
```

Golang:

```go
NewSqsDestination(Queue IQueue)
```

## Methods

- `bind(_scope: Construct, fn: IFunction, _options?: DestinationOptions): DestinationConfig` — Returns a destination configuration.
