本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# aws-lambda 平方米-lambda
<a name="aws-lambda-sqs-lambda"></a>

![](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/experimental.png)


 所有类都处于积极开发之中，并且在任何未来版本中都会受到非向后兼容的更改或删除。这些不受[语义版本](https://semver.org/)模型。这意味着，虽然您可以使用它们，但在升级到此软件包的较新版本时，您可能需要更新源代码。

**注意：** 为确保正确的功能，您项目中的 AWS 解决方案构造软件包和 AWS CDK 包必须是相同的版本。


|  **语言**  |  **程序包**  | 
| --- | --- | 
|  ![](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/python.png) Python  |  aws\_solutions\_constructs.aws\_lambda\_sqs\_lambda  | 
|  ![](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/typescript.png) TypeScript  |  @aws-solutions-constructs/aws-lambda-sqs-lambda  | 
|  ![](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.lambdasqslambda  | 

## Overview
<a name="overview-27"></a>

 此 AWS 解决方案构造模式实现 (1) 配置为向队列发送消息的 AWS Lambda 函数；(2) Amazon SQS 队列；(3) 配置为使用队列中的消息的 AWS Lambda 函数。

 以下是 TypeScript 中的最小可部署模式定义：

```
import { LambdaToSqsToLambda, LambdaToSqsToLambdaProps } from "@aws-solutions-constructs/aws-lambda-sqs-lambda";

new LambdaToSqsToLambda(this, 'LambdaToSqsToLambdaPattern', {
    producerLambdaFunctionProps: {
        runtime: lambda.Runtime.NODEJS_14_X,
        // This assumes a handler function in lib/lambda/producer-function/index.js
        code: lambda.Code.fromAsset(`${__dirname}/lambda/producer-function`),
        handler: 'index.handler'
    },
    consumerLambdaFunctionProps: {
        runtime: lambda.Runtime.NODEJS_14_X,
        // This assumes a handler function in lib/lambda/consumer-function/index.js
        code: lambda.Code.fromAsset(`${__dirname}/lambda/consumer-function`),
        handler: 'index.handler'
    }
});
```

## Initializer
<a name="initializer-27"></a>

```
new LambdaToSqsToLambda(scope: Construct, id: string, props: LambdaToSqsToLambdaProps);
```

 *参数* 
+  scope[https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html) 
+  id`string` 
+  props[`LambdaToSqsToLambdaProps`](#pattern-construct-props-27) 

## 模式构建道具
<a name="pattern-construct-props-27"></a>


|  **名称**  |  **类型**  |  **描述**  | 
| --- | --- | --- | 
|  现有的制作人兰姆道夫？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  一个可选的现有 Lambda 函数，而不是用于向队列发送消息的默认函数。同时提供此和producerLambdaFunctionProps会导致错误。 | 
|  生产者兰姆达功能道具？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html)  |  用户提供的可选属性，用于覆盖生成器 Lambda 函数的默认属性。 | 
|  现有队列 OBJ？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html)  |  要使用的可选现有 SQS 队列，而不是默认队列。同时提供此和queueProps会导致错误。 | 
|  队列道具？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html)  |  用户提供的可选属性，用于覆盖 SQS 队列的默认属性。同时提供此和existingQueueObj会导致错误。 | 
|  部署死信件队列？  |  boolean  |  是否创建要用作死信队列的辅助队列。默认值为 true。 | 
|  死书队列道具？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html)  |  用户提供的可选道具，用于覆盖死信队列的默认道具。仅当deployDeadLetterQueue属性将设定为true。 | 
|  maxReceiveCount？  |  number  |  消息在发送到死信队列之前移动到源队列的次数。默认值为 15。 | 
|  现有的消费者兰姆道夫 J？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  用于接收/使用队列消息的可选现有 Lambda 函数，而不是默认函数。同时提供此和consumerLambdaFunctionProps会导致错误。 | 
|  消费者拉姆达功能道具？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html)  |  用户提供的可选属性，用于覆盖使用者 Lambda 函数的默认属性。 | 
|  队列环境变量名称？  |  string  |  为生成器 Lambda 函数设置的 SQS 队列 URL 环境变量的可选名称。 | 

## 模式属性
<a name="pattern-properties-27"></a>


|  **名称**  |  **类型**  |  **描述**  | 
| --- | --- | --- | 
|  消费者 Lambda 函数  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  返回由模式创建的消费者 Lambda 函数的实例。 | 
|  死信队列？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html)  |  返回由模式创建的死信队列的实例（如果已部署）。 | 
|  生产者 Lambda 函数  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  返回由模式创建的生成器 Lambda 函数的实例。 | 
|  SQUUE  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html)  |  返回由模式创建的 SQS 队列的实例。 | 

## 默认设置
<a name="default-settings-27"></a>

 此构造的开箱即用实现（没有任何覆盖的属性）将遵循以下默认值：

### AWS Lambda 函数
<a name="aws-lambda-function-27"></a>
+  为 Lambda 函数配置有限权限访问 IAM 角色。
+  为节点 JS Lambda 函数启用使用保持活动状态的连接重复使用。
+  启用 X-Ray 跟踪
+  设置环境变量：
  +  `AWS_NODEJS_CONNECTION_REUSE_ENABLED`（用于节点 10.x 和更高版本的功能）

### Amazon SQS 队列
<a name="amazon-sqs-queue-27"></a>
+  部署用于主队列的死信队列。
+  使用 AWS 托管 KMS 密钥为主队列启用服务器端加密。
+  实施传输中数据加密 

## Architecture
<a name="architecture-27"></a>

![](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/aws-lambda-sqs-lambda.png)


## GitHub
<a name="github-27"></a>


<table>
<thead>
  <tr><th colspan="2"> 要查看此模式的代码、创建/查看问题和拉取请求等，请执行以下操作： </th></tr>
</thead>
<tbody>
  <tr><td> ![](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/GitHub-Mark-32px.png) </td><td> [@aws-解决方案-结构/aw-拉姆达-平方-lambda](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-lambda-sqs-lambda) </td></tr>
</tbody>
</table>