aws-eventi-rule-sqs - Costrutti delle soluzioni AWS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

aws-eventi-rule-sqs

Tutte le classi sono in fase di sviluppo attivo e soggette a modifiche o rimozione non compatibili con le versioni precedenti in qualsiasi versione futura. Questi non sono soggetti allaSemantic versioningModello. Ciò significa che, mentre è possibile utilizzarli, potrebbe essere necessario aggiornare il codice sorgente quando si esegue l'aggiornamento a una versione più recente di questo pacchetto.

Nota: Per garantire la corretta funzionalità, i pacchetti AWS Solutions Constructs e i pacchetti AWS CDK nel progetto devono essere della stessa versione.

Linguaggio Pacchetto
Python
aws_solutions_constructs.aws_events_rule_sqs
TypeScript
@aws-solutions-constructs/aws-events-rule-sqs
Java
software.amazon.awsconstructs.services.eventsrulesqs

Overview

Questo modello implementa una regola Amazon CloudWatch Events collegata a una coda Amazon SQS.

Ecco una definizione minima del modello distribuibile:

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);

Parametri

Puntelli di costruzione modelli

Nome Tipo Descrizione
EventRuleProps events.RuleProps Proprietà fornite dall'utente per sovrascrivere le proprietà predefinite per la regola Eventi CloudWatch.
ExistingQueueObj? sqs.Queue Una coda SQS esistente facoltativa da utilizzare al posto della coda predefinita. Fornire sia questo chequeuePropscauserà un errore.
QueueProps? sqs.QueueProps Proprietà facoltative fornite dall'utente per sovrascrivere le proprietà predefinite per la coda SQS. Ignorato se unexistingQueueObjviene fornito.
EnableQueueUrging? boolean Indica se concedere autorizzazioni aggiuntive alla funzione Lambda che consente di eliminare la coda SQS. L'impostazione predefinita è false.
DeployDeadLetterQueue? boolean Se creare una coda secondaria da usare come coda DLQ. L'impostazione predefinita è true.
DeadLetterQueueProps? sqs.QueueProps Elementi di scena facoltativi forniti dall'utente per sovrascrivere gli oggetti di scena predefiniti per la coda delle lettere morte. Utilizzato solo se il valoredeployDeadLetterQueueviene impostata su true.
MaxReceiveCount? number Il numero di volte in cui un messaggio può essere rimosso senza successo prima di essere spostato nella coda DLQ. L'impostazione predefinita è 15.
EnableEncryptionWithCustomerManagedKey? boolean Se utilizzare una chiave di crittografia gestita dal cliente, gestita da questa app CDK o importata. Se si importa una chiave di crittografia, questa deve essere specificata nella casellaencryptionKeyper questo costrutto.
encryptionKey? kms.Key Chiave di crittografia opzionale esistente da utilizzare al posto della chiave di crittografia predefinita.
EncryptionKeyProps? kms.KeyProps Proprietà facoltative fornite dall'utente per sovrascrivere le proprietà predefinite per la chiave di crittografia.

Proprietà modelli

Nome Tipo Descrizione
EventsRule events.Rule Restituisce un'istanza della regola Events creata dal pattern.
SQSqueue sqs.Queue Restituisce un'istanza della coda SQS creata dal pattern.
encryptionKey kms.Key Restituisce un'istanza della chiave di crittografia creata dal modello.
DeadLetterQueue? sqs.Queue Restituisce un'istanza della coda di lettere morte creata dal modello, se ne viene distribuita una.

Impostazioni predefinite

L'implementazione predefinita di questo modello senza sostituzioni imposterà i seguenti valori predefiniti:

Amazon CloudWatch Events

  • Concedere le autorizzazioni di privilegi minimi agli eventi CloudWatch per la pubblicazione nella coda SQS.

Coda Amazon SQS

  • Distribuire una coda DLQ per la coda di origine.

  • Abilitare la crittografia lato server per la coda di origine utilizzando una chiave AWS KMS gestita dal cliente.

  • Applicazione della crittografia dei dati in transito.

Architecture

GitHub

Per visualizzare il codice per questo modello, creare/visualizzare problemi e richieste pull e altro ancora:
@aws -solutions-buils/aws-eventi-rule-sqs