本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# aws-lambda-3
所有类都处于积极开发之中，并且在任何未来版本中都会受到非向后兼容的更改或删除。这些不受[语义版本控制](https://semver.org/)模型。这意味着，虽然您可以使用它们，但在升级到此软件包的较新版本时，您可能需要更新源代码。
**注意：** 为确保正确的功能，您项目中的 AWS 解决方案构造软件包和 AWS CDK 包必须是相同的版本。
| **语言** | **程序包** |
| --- | --- |
|  Python | aws\_solutions\_constructs.aws\_lambda\_s3 |
|  TypeScript | @aws-solutions-constructs/aws-lambda-s3 |
|  Java | software.amazon.awsconstructs.services.lambdas3 |
## Overview
此 AWS 解决方案构造实现连接到 Amazon S3 存储桶的 AWS Lambda 函数。
以下是 TypeScript 中的最小可部署模式定义：
```
import { LambdaToS3 } from '@aws-solutions-constructs/aws-lambda-s3';
new LambdaToS3(this, 'LambdaToS3Pattern', {
lambdaFunctionProps: {
runtime: lambda.Runtime.NODEJS_14_X,
// This assumes a handler function in lib/lambda/index.js
code: lambda.Code.fromAsset(`${__dirname}/lambda`),
handler: 'index.handler'
}
});
```
## Initializer
```
new LambdaToS3(scope: Construct, id: string, props: LambdaToS3Props);
```
*参数*
+ scope[`Construct`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html)
+ id`string`
+ props[`LambdaToS3Props`](#pattern-construct-props-19)
## 模式构建道具
| **名称** | **类型** | **描述** |
| --- | --- | --- |
| 现在的兰姆道夫？ | [`lambda.Function`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html) | Lambda 函数对象的现有实例，提供了这个和lambdaFunctionProps会导致错误。 |
| Lambda 功能道具？ | [`lambda.FunctionProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html) | 用户提供的可选属性，用于覆盖 Lambda 函数的默认属性。忽略，如果existingLambdaObj提供。 |
| 现有的存储桶吗？ | [`s3.IBucket`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.IBucket.html) | S3 存储桶对象的现有实例。如果提供了这一点，那么还提供bucketProps是一个错误。 |
| 桶道具？ | [`s3.BucketProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.BucketProps.html) | 用户提供的可选属性，用于覆盖存储桶的默认属性。忽略，如果existingBucketObj提供。 |
| 存储桶权限？ | string[] | 授予 Lambda 函数的可选存储桶权限。可能会指定下列一个或多个：Delete、Put、Read、ReadWrite、Write。 |
| 是否存在 VPC？ | [`ec2.IVpc`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.IVpc.html) | 应在其中部署此模式的可选现有 VPC。在 VPC 中部署时，Lambda 函数将使用 VPC 中的 ENI 访问网络资源，并在 Amazon SQS 的 VPC 中创建接口终端节点。如果提供了现有 VPC，则deployVpc属性不能true。这使用ec2.IVpc允许客户端使用[`ec2.Vpc.fromLookup()`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.Vpc.html#static-fromwbrlookupscope-id-options)方法。 |
| 部署 VPC？ | boolean | 是否创 VPC 基于vpcProps将此模式部署到其中。将此设置为true将部署最小的、最私有的 VPC 来运行模式：+ CDK 计划使用的每个可用区中有一个隔离的子网。
+ `enableDnsHostnames`和`enableDnsSupport`都将被设置为`true`。 如果此属性为true，然后existingVpc则无法指定 。默认值为 false。 |
| VPCPROP？ | [`ec2.VpcProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.VpcProps.html) | 用户提供的可选属性，用于覆盖新 VPC 的默认属性。enableDnsHostnames、enableDnsSupport、natGateways和subnetConfiguration是由模式设置的，所以这里提供的这些属性的任何值都将被覆盖。如果deployVpc不是true那么这个属性将被忽略。 |
| 存储桶变量名称？ | string | 为 Lambda 函数设置的 S3 存储桶环境变量的可选名称。 |
## 模式属性
| **名称** | **类型** | **描述** |
| --- | --- | --- |
| LambdaFunction | [`lambda.Function`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html) | 返回由模式创建的 Lambda 函数的实例。 |
| S3Bucket？ | [`s3.Bucket`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html) | 返回模式创建的 S3 存储桶的实例。 |
| S3 记录桶？ | [`s3.Bucket`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html) | 返回由模式为 S3 存储桶创建的日志记录存储桶的实例。 |
| VPC？ | [`ec2.IVpc`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.IVpc.html) | 返回模式使用的 VPC 实例（如果有）。这可能是由模式创建的 VPC，也可以是提供给模式构造函数的 VPC。 |
## 默认设置
没有任何覆盖的此模式的开箱即用实现将设置以下默认值：
### AWS Lambda 函数
+ 为 Lambda 函数配置有限权限访问 IAM 角色。
+ 使用节点 JS Lambda 函数保持活动状态，启用重复使用连接。
+ 启用 X-Ray 跟踪
+ 设置环境变量：
+ `S3_BUCKET_NAME` (默认值)
+ `AWS_NODEJS_CONNECTION_REUSE_ENABLED`（用于节点 10.x 和更高版本的功能）
### Amazon S3 存储桶
+ 配置 S3 存储桶的访问日志记录。
+ 使用 AWS 托管 KMS 密钥为 S3 存储桶启用服务器端加密。
+ 启用 S3 存储桶的版本控制。
+ 不允许 S3 存储桶的公共访问。
+ 删除 CloudFormation 堆栈时保留 S3 存储桶。
+ 实施传输中数据加密。
+ 应用生命周期规则在 90 天后将非当前对象版本移动到 Glacier 存储。
## Architecture
## GitHub
