Creazione di una EventBridge regola per acquisire gli eventi del ciclo di vita del gruppo e pubblicare notifiche

Puoi attivare gli eventi del ciclo di vita dei gruppi per i tuoi gruppi di risorse per AWS Resource Groups pubblicare eventi su Amazon. EventBridge Quindi, puoi creare EventBridge regole che rispondano a tali eventi inviandole ad altri Servizi AWS per un'ulteriore elaborazione.

AWS CLI

Il processo di creazione di una regola EventBridge che acquisisce gli eventi e li invia al servizio di destinazione desiderato richiede due comandi CLI separati:

1. Crea la EventBridge regola per acquisire gli eventi che desideri

2. Associa alla EventBridge regola un obiettivo in grado di elaborare gli eventi

Passaggio 1: creare la EventBridge regola per acquisire gli eventi

Il comando di AWS CLI put-rule esempio seguente crea una EventBridge regola che acquisisce tutte le modifiche degli eventi del ciclo di vita di Resource Groups.

$ aws events put-rule \
    --name "CatchAllResourceGroupEvents" \
    --event-pattern '{"source":["aws.resource-groups"]}'
{
    "RuleArn": "arn:aws:events:us-east-1:123456789012:rule/CatchAllResourceGroupEvents"
}

L'output include l'Amazon Resource Name (ARN) della nuova regola.

Nota

I valori dei parametri che includono stringhe tra virgolette hanno regole di formattazione diverse in base al sistema operativo e alla shell utilizzati. Per gli esempi di questa guida, mostriamo i comandi che funzionano su una shell BASH Linux. Per istruzioni sulla formattazione delle stringhe con virgolette incorporate per altri sistemi operativi, come il prompt dei comandi di Windows, consultate Uso delle virgolette all'interno delle stringhe nella Guida per l'utente. AWS Command Line Interface

Man mano che le stringhe di parametri diventano più complesse, può essere più semplice e meno soggetto a errori accettare il valore di un parametro da un file di testo anziché digitarlo direttamente nella riga di comando.

Il seguente schema di eventi limita gli eventi solo a quelli correlati al gruppo specificato, identificato dal relativo ARN. Questo modello di eventi è una stringa JSON complessa che è molto meno leggibile se compressa in una stringa JSON a riga singola con escape appropriato. Puoi invece archiviarlo in un file.

Memorizza la stringa JSON del pattern di eventi in un file. Nel seguente esempio di codice, il file èeventpattern.txt.

{
    "source": [ "aws.resource-groups" ],
    "detail": {
        "group": {
            "arn": [ "my-resource-group-arn" ]
        }
    }
}

Quindi, esegui il seguente comando per creare la regola, recuperando il modello di evento personalizzato dal file.

$ aws events put-rule \
    --name "CatchResourceGroupEventsForMyGroup" \
    --event-pattern file://eventpattern.txt
{
    "RuleArn": "arn:aws:events:us-east-1:123456789012:rule/CatchResourceGroupEventsForMyGroup"
}

Per acquisire altri tipi di eventi Resource Groups, sostituisci la --event-pattern stringa con filtri come quelli presentati nella sezioneEsempi di modelli di eventi EventBridge personalizzati per diversi casi d'uso.

Passaggio 2: Associare alla EventBridge regola un obiettivo in grado di elaborare gli eventi

Ora che hai una regola che cattura gli eventi che ti interessano, puoi allegare uno o più obiettivi per eseguire qualche tipo di elaborazione sugli eventi.

Il AWS CLI put-targets comando seguente collega un argomento Amazon Simple Notification Service (Amazon SNS) denominato my-sns-topic alla regola creata nell'esempio precedente. Tutti gli abbonati all'argomento ricevono una notifica quando viene apportata una modifica al gruppo specificato nella regola.

$ aws events put-targets \
    --rule CatchResourceGroupEventsForMyGroup \
    --targets Id=1,Arn=arn:aws:sns:us-east-1:123456789012:my-sns-topic
{
    "FailedEntryCount": 0,
    "FailedEntries": []
}

A questo punto, tutte le modifiche al gruppo che corrispondono allo schema degli eventi nella regola vengono inviate automaticamente alla destinazione o alle destinazioni configurate. Se, come nell'esempio precedente, la destinazione è un argomento di Amazon SNS, tutti gli abbonati all'argomento ricevono un messaggio contenente l'evento come descritto in. Struttura e sintassi degli eventi del ciclo di vita di Resource Groups

Per ulteriori informazioni, consulta le seguenti risorse:

• AWS CLI— aws events put-rule e aws events put-targets

• PutRuleAPI — e PutTargets

Creazione di una regola per acquisire solo tipi specifici di eventi del ciclo di vita del gruppo

Puoi creare una regola con un modello di evento personalizzato che catturi solo gli eventi che ti interessano. Per informazioni complete su come filtrare gli eventi in arrivo utilizzando un pattern di eventi personalizzato, consulta Amazon EventBridge events nella Amazon EventBridge User Guide.

Ad esempio, supponiamo di volere che una regola elabori solo le notifiche di Resource Groups che indicano la creazione di un nuovo gruppo di risorse. È possibile utilizzare un modello di eventi personalizzato simile all'esempio seguente.

{
    "source": [ "aws.resource-groups" ],
    "detail-type": [ "ResourceGroups Group State Change" ],
    "detail": {
        "state-change": "create"
    }
}

Questo filtro cattura solo gli eventi che hanno quei valori esatti nei campi specificati. Per un elenco completo dei campi disponibili da abbinare, consultaStruttura e sintassi degli eventi del ciclo di vita di Resource Groups.