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

# AWS-SNS 平方米
<a name="aws-sns-sqs"></a>

![\[Two labels: "STABILITY" in gray and "EXPERIMENTAL" in orange.\]](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/experimental.png)


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

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


|  **语言**  |  **程序包**  | 
| --- | --- | 
|  ![\[alt text not found\]](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/python.png) Python  |  aws\$1solutions\$1constructs.aws\$1sns\$1sqs  | 
|  ![\[alt text not found\]](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/typescript.png) TypeScript  |  @aws-solutions-constructs/aws-sns-sqs  | 
|  ![\[alt text not found\]](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.snssqs  | 

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

 此 AWS 解决方案构造实施 Amazon SNS 主题，与 Amazon SQS 队列相连。

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

```
import { SnsToSqs, SnsToSqsProps } from "@aws-solutions-constructs/aws-sns-sqs";
import * as iam from '@aws-cdk/aws-iam';

const snsToSqsStack = new SnsToSqs(this, 'SnsToSqsPattern', {});

// Grant yourself permissions to use the Customer Managed KMS Key
const policyStatement = new iam.PolicyStatement({
    actions: ["kms:Encrypt", "kms:Decrypt"],
    effect: iam.Effect.ALLOW,
    principals: [ new iam.AccountRootPrincipal() ],
    resources: [ "*" ]
});

snsToSqsStack.encryptionKey?.addToResourcePolicy(policyStatement);
```

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

```
new SnsToSqs(scope: Construct, id: string, props: SnsToSqsProps);
```

 *参数* 
+  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[`SnsToSqsProps`](#pattern-construct-props-28) 

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


|  **名称**  |  **类型**  |  **描述**  | 
| --- | --- | --- | 
|  现有的托比克吗？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html)  |  SNS 主题对象的现有实例，同时提供此和topicProps会导致错误。 | 
|  主题道具？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.TopicProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.TopicProps.html)  |  用户提供的可选属性，用于覆盖 SNS 主题的默认属性。忽略，如果existingTopicObj提供。 | 
|  现有队列 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。 | 
|  是否启用用客户管理的密钥加密？  |  boolean  |  是否使用由此 CDK 应用程序管理或导入的客户管理的加密密钥。如果导入加密密钥，则必须在encryptionKey属性。 | 
|  encryptionKey  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html)  |  要使用的可选现有加密密钥，而不是默认加密密钥。 | 
|  加密钥匙道具？  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.KeyProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.KeyProps.html)  |  用户提供的可选属性，用于覆盖加密密钥的默认属性。 | 

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


|  **名称**  |  **类型**  |  **描述**  | 
| --- | --- | --- | 
|  snsTopic  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html)  |  返回由模式创建的 SNS 主题的实例。 | 
|  encryptionKey  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html)  |  返回由模式创建的加密密钥的实例。 | 
|  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 队列的实例。 | 
|  死信队列？  |  [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)  |  返回由模式创建的死信队列的实例（如果已部署）。 | 

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

 没有任何覆盖的此模式的开箱即用实现将设置以下默认值：

### Amazon SNS 主题
<a name="amazon-sns-topic-28"></a>
+  为 SNS 主题配置最小权限访问权限。
+  使用 AWS 托管 KMS 密钥启用服务器端加密。
+  实施传输中数据加密。

### Amazon SQS 队列
<a name="aws-lambda-function-28"></a>
+  为 SQS 队列配置最低权限访问权限。
+  部署源 SQS 队列的死信队列。
+  使用客户管理的 KMS 密钥为 SQS 队列启用服务器端加密。
+  实施传输中数据加密。

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

![\[AWS 服务 diagram showing SNS, SQS, and Lambda interactions with queues and notifications.\]](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/aws-sns-sqs.png)


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


|  **要查看此模式的代码、创建/查看问题和拉取请求等，请执行以下操作：**  | 
| --- | 
|  ![\[Circular icon with a graduation cap symbol representing education or learning.\]](http://docs.aws.amazon.com/zh_cn/solutions/latest/constructs/images/GitHub-Mark-32px.png)  |  [@aws-解决方案结构/aws-sns-平方米](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-sns-sqs)  |