AWS-SNS 平方米 - AWS 解决方案构造

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

AWS-SNS 平方米

Two labels: "STABILITY" in gray and "EXPERIMENTAL" in orange.

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

注意: 为确保正确的功能,您项目中的 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);

参数

模式构建道具

名称 类型 描述
现有的托比克吗? sns.Topic SNS 主题对象的现有实例,同时提供此和topicProps会导致错误。
主题道具? sns.TopicProps 用户提供的可选属性,用于覆盖 SNS 主题的默认属性。忽略,如果existingTopicObj提供。
现有队列 OBJ? sqs.Queue 要使用的可选现有 SQS 队列,而不是默认队列。同时提供此和queueProps会导致错误。
队列道具? sqs.QueueProps 用户提供的可选属性,用于覆盖 SQS 队列的默认属性。忽略,如果existingQueueObj提供。
部署死信件队列? boolean 是否创建要用作死信队列的辅助队列。默认值为 true
死书队列道具? sqs.QueueProps 用户提供的可选道具,用于覆盖死信队列的默认道具。仅当deployDeadLetterQueue属性设置为 true。
maxReceiveCount? number 消息在发送到死信队列之前移动到达队列的次数。默认值为 15
是否启用用客户管理的密钥加密? boolean 是否使用由此 CDK 应用程序管理或导入的客户管理的加密密钥。如果导入加密密钥,则必须在encryptionKey属性。
encryptionKey kms.Key 要使用的可选现有加密密钥,而不是默认加密密钥。
加密钥匙道具? kms.KeyProps 用户提供的可选属性,用于覆盖加密密钥的默认属性。

模式属性

名称 类型 描述
snsTopic sns.Topic 返回由模式创建的 SNS 主题的实例。
encryptionKey kms.Key 返回由模式创建的加密密钥的实例。
SQUUE sqs.Queue 返回由模式创建的 SQS 队列的实例。
死信队列? sqs.Queue 返回由模式创建的死信队列的实例(如果已部署)。

默认设置

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

Amazon SNS 主题

  • 为 SNS 主题配置最小权限访问权限。

  • 使用 AWS 托管 KMS 密钥启用服务器端加密。

  • 实施传输中数据加密。

Amazon SQS 队列

  • 为 SQS 队列配置最低权限访问权限。

  • 部署源 SQS 队列的死信队列。

  • 使用客户管理的 KMS 密钥为 SQS 队列启用服务器端加密。

  • 实施传输中数据加密。

Architecture

AWS 服务 diagram showing SNS, SQS, and Lambda interactions with queues and notifications.

GitHub

要查看此模式的代码、创建/查看问题和拉取请求等,请执行以下操作:
Circular icon with a graduation cap symbol representing education or learning.
@aws-解决方案结构/aws-sns-平方米