本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# AWS-SNS 平方米
所有类都处于积极开发之中，并且在任何未来版本中都会受到非向后兼容的更改或删除。这些不受[语义版本控制](https://semver.org/)模型。这意味着，虽然您可以使用它们，但在升级到此软件包的较新版本时，您可能需要更新源代码。
**注意：** 为确保正确的功能，您项目中的 AWS 解决方案构造软件包和 AWS CDK 包必须是相同的版本。
| **语言** | **程序包** |
| --- | --- |
|  Python | aws\_solutions\_constructs.aws\_sns\_sqs |
|  TypeScript | @aws-solutions-constructs/aws-sns-sqs |
|  Java | software.amazon.awsconstructs.services.snssqs |
## Overview
此 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
```
new SnsToSqs(scope: Construct, id: string, props: SnsToSqsProps);
```
*参数*
+ scope[`Construct`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html)
+ id`string`
+ props[`SnsToSqsProps`](#pattern-construct-props-28)
## 模式构建道具
| **名称** | **类型** | **描述** |
| --- | --- | --- |
| 现有的托比克吗？ | [`sns.Topic`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html) | SNS 主题对象的现有实例，同时提供此和topicProps会导致错误。 |
| 主题道具？ | [`sns.TopicProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.TopicProps.html) | 用户提供的可选属性，用于覆盖 SNS 主题的默认属性。忽略，如果existingTopicObj提供。 |
| 现有队列 OBJ？ | [`sqs.Queue`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html) | 要使用的可选现有 SQS 队列，而不是默认队列。同时提供此和queueProps会导致错误。 |
| 队列道具？ | [`sqs.QueueProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html) | 用户提供的可选属性，用于覆盖 SQS 队列的默认属性。忽略，如果existingQueueObj提供。 |
| 部署死信件队列？ | boolean | 是否创建要用作死信队列的辅助队列。默认值为 true。 |
| 死书队列道具？ | [`sqs.QueueProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.QueueProps.html) | 用户提供的可选道具，用于覆盖死信队列的默认道具。仅当deployDeadLetterQueue属性设置为 true。 |
| maxReceiveCount？ | number | 消息在发送到死信队列之前移动到达队列的次数。默认值为 15。 |
| 是否启用用客户管理的密钥加密？ | boolean | 是否使用由此 CDK 应用程序管理或导入的客户管理的加密密钥。如果导入加密密钥，则必须在encryptionKey属性。 |
| encryptionKey | [`kms.Key`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html) | 要使用的可选现有加密密钥，而不是默认加密密钥。 |
| 加密钥匙道具？ | [`kms.KeyProps`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.KeyProps.html) | 用户提供的可选属性，用于覆盖加密密钥的默认属性。 |
## 模式属性
| **名称** | **类型** | **描述** |
| --- | --- | --- |
| snsTopic | [`sns.Topic`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html) | 返回由模式创建的 SNS 主题的实例。 |
| encryptionKey | [`kms.Key`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-kms.Key.html) | 返回由模式创建的加密密钥的实例。 |
| SQUUE | [`sqs.Queue`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html) | 返回由模式创建的 SQS 队列的实例。 |
| 死信队列？ | [`sqs.Queue`](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sqs.Queue.html) | 返回由模式创建的死信队列的实例（如果已部署）。 |
## 默认设置
没有任何覆盖的此模式的开箱即用实现将设置以下默认值：
### Amazon SNS 主题
+ 为 SNS 主题配置最小权限访问权限。
+ 使用 AWS 托管 KMS 密钥启用服务器端加密。
+ 实施传输中数据加密。
### Amazon SQS 队列
+ 为 SQS 队列配置最低权限访问权限。
+ 部署源 SQS 队列的死信队列。
+ 使用客户管理的 KMS 密钥为 SQS 队列启用服务器端加密。
+ 实施传输中数据加密。
## Architecture
## GitHub
