aws-events-regel-sqs - Konstrukte für AWS S-Lösungen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

aws-events-regel-sqs

Alle Klassen befinden sich in aktiver Entwicklung und unterliegen nicht abwärtskompatiblen Änderungen oder Entfernen in jeder zukünftigen Version. Diese unterliegen nicht denSemantische VersionierungModell. Dies bedeutet, dass Sie möglicherweise Ihren Quellcode aktualisieren müssen, wenn Sie ein Upgrade auf eine neuere Version dieses Pakets durchführen.

Hinweis: Um eine ordnungsgemäße Funktionalität sicherzustellen, müssen die AWS Solutions Constructs Pakete und AWS CDK-Pakete in Ihrem Projekt dieselbe Version aufweisen.

Sprache Paket
Python
aws_solutions_constructs.aws_events_rule_sqs
Typoskript
@aws-solutions-constructs/aws-events-rule-sqs
Java
software.amazon.awsconstructs.services.eventsrulesqs

Overview

Dieses Muster implementiert eine Amazon CloudWatch Events, die mit einer Amazon SQS Warteschlange verbunden ist.

Hier ist eine minimale bereitstellbare Musterdefinition:

import { Duration } from '@aws-cdk/core'; import * as events from '@aws-cdk/aws-events'; import * as iam from '@aws-cdk/aws-iam'; import { EventsRuleToSqsProps, EventsRuleToSqs } from "@aws-solutions-constructs/aws-events-rule-sqs"; const props: EventsRuleToSqsProps = { eventRuleProps: { schedule: events.Schedule.rate(Duration.minutes(5)) } }; const constructStack = new EventsRuleToSqs(this, 'test-construct', props); // 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: [ "*" ] }); constructStack.encryptionKey?.addToResourcePolicy(policyStatement);

Initializer

new EventsRuleToSqs(scope: Construct, id: string, props: EventsRuleToSqsProps);

Parameter

Muster-Konstrukt

Name Typ Beschreibung
EventRuleProps events.RuleProps Vom Benutzer bereitgestellte Eigenschaften, um die Standardeigenschaften für die CloudWatch Ereignisregel zu überschreiben.
BestehenQueueObj? sqs.Queue Eine optionale, vorhandene SQS-Warteschlange, die anstelle der Standardwarteschlange verwendet werden soll. Bereitstellung sowohl dieser als auchqueuePropsführt zu einem -Fehler.
QueueProps? sqs.QueueProps Optionale vom Benutzer bereitgestellte Eigenschaften, um die Standardeigenschaften für die SQS-Warteschlange zu überschreiben. Wird ignoriert, wenn einexistingQueueObjwird bereitgestellt.
EnableQueueSurging? boolean Gibt an, ob der Lambda Funktion zusätzliche Berechtigungen erteilt werden sollen, um die SQS-Warteschlange zu bereinigen. Standardeinstellung: false.
DeployDeadletterQueue? boolean Erstellen Sie eine sekundäre Warteschlange, die als Warteschlange für unzustellbare Nachrichten verwendet werden soll. Standardeinstellung: true.
DeadLetterQueueProps? sqs.QueueProps Optionale, vom Benutzer bereitgestellte Requisiten zum Überschreiben der Standardrequisiten für die Warteschlange für tote Buchstaben. Wird nur verwendet, wenn diedeployDeadLetterQueueauf true festgelegt.
MaxReceiveCount? number Die Anzahl, wie oft eine Nachricht nicht erfolgreich entfernt werden kann, bevor sie in die Warteschlange für unzustellbare Nachrichten verschoben wird. Standardeinstellung: 15.
EnableEncryptionWithCustomerManagedKey? boolean Gibt an, ob ein vom Kunden verwalteter Verschlüsselungsschlüssel verwendet werden soll, der entweder von dieser CDK-App verwaltet oder importiert wird. Beim Importieren eines Verschlüsselungsschlüssels muss dieser in derencryptionKey-Eigenschaft für dieses Konstrukt.
encryptionKey? kms.Key Ein optionaler, vorhandener Verschlüsselungsschlüssel, der anstelle des Standard-Verschlüsselungsschlüssels verwendet werden soll.
EncryptionKeyProps? kms.KeyProps Optionale vom Benutzer bereitgestellte Eigenschaften, um die Standardeigenschaften für den Verschlüsselungsschlüssel zu überschreiben.

Muster-Eigenschaften

Name Typ Beschreibung
EreignissRegel events.Rule Gibt eine Instanz der Ereignisregel zurück, die durch das Muster erstellt wurde.
SQSQueue sqs.Queue Gibt eine Instanz der SQS-Warteschlange zurück, die durch das Muster erstellt wurde.
encryptionKey kms.Key Gibt eine Instanz des Verschlüsselungsschlüssels zurück, der durch das Muster erstellt wurde.
DeadLetterQueue? sqs.Queue Gibt eine Instanz der Warteschlange für toten Buchstaben zurück, die durch das Muster erstellt wurde, wenn eine bereitgestellt wird.

Standardeinstellung

Die vorgefertigte Implementierung dieses Musters ohne Überschreibungen setzt die folgenden Standardwerte:

Amazon CloudWatch Events

  • Erteilen Sie CloudWatch Ereignissen die geringsten Berechtigungen, um sie in der SQS-Warteschlange zu veröffentlichen.

Amazon SQS-Warteschlange

  • Bereitstellen einer Warteschlange für unzustellbare Nachrichten für die Quellwarteschlange

  • Aktivieren Sie die serverseitige Verschlüsselung für die Quellwarteschlange mithilfe eines vom Kunden verwalteten AWS KMS-Schlüssels.

  • Erzwingen der Verschlüsselung von Daten während der Übertragung

Architecture

GitHub

Um den Code für dieses Muster anzuzeigen, erstellen/anzeigen Probleme und Pull-Anforderungen usw.:
@aws -solutions-constructs/aws-events-rule-sqs