# AWS Lambda Layer with AWS CLI

This module exports a single class called [`AwsCliLayer`](/v2/docs/aws-cdk-lib.lambda_layer_awscli.AwsCliLayer) which is a `lambda.Layer` that bundles the AWS CLI.

Any Lambda Function that uses this layer must use a Python 3.x runtime.

Usage:

TypeScript:

```ts
// AwsCliLayer bundles the AWS CLI in a lambda layer
import { AwsCliLayer } from 'aws-cdk-lib/lambda-layer-awscli';

declare const fn: lambda.Function;
fn.addLayers(new AwsCliLayer(this, 'AwsCliLayer'));
```

Python:

```python
# AwsCliLayer bundles the AWS CLI in a lambda layer
from aws_cdk.lambda_layer_awscli import AwsCliLayer

# fn: lambda.Function

fn.add_layers(AwsCliLayer(self, "AwsCliLayer"))
```

Java:

```java
// AwsCliLayer bundles the AWS CLI in a lambda layer
import software.amazon.awscdk.lambdalayer.awscli.AwsCliLayer;

Function fn;

fn.addLayers(new AwsCliLayer(this, "AwsCliLayer"));
```

C# / .NET:

```csharp
// AwsCliLayer bundles the AWS CLI in a lambda layer
using Amazon.CDK.LambdaLayer.AwsCli;

Function fn;

fn.AddLayers(new AwsCliLayer(this, "AwsCliLayer"));
```

Golang:

```go
// AwsCliLayer bundles the AWS CLI in a lambda layer
import "github.com/aws/aws-cdk-go/awscdk"

var fn Function

fn.AddLayers(awscdk.NewAwsCliLayer(this, jsii.String("AwsCliLayer")))
```

The CLI will be installed under `/opt/awscli/aws`.

## Alternatives

This module bundles AWS cli v1. To use AWS cli v2, you can use the
external module [awscdk-asset-awscli](https://github.com/cdklabs/awscdk-asset-awscli/tree/awscli-v2/main).

## Types

| Name | Kind | Summary |
| --- | --- | --- |
| [`AwsCliLayer`](/v2/docs/aws-cdk-lib.lambda_layer_awscli.AwsCliLayer) | Construct (L2) | An AWS Lambda layer that includes the AWS CLI. |
