

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création d'une EventBridge règle pour capturer les événements du cycle de vie des groupes et publier des notifications

**Note**  
AWS La fonctionnalité Group Lifecycle Events (GLE) n' Groupes de ressources AWS est plus ouverte aux nouveaux clients. Pour des fonctionnalités similaires à celles des événements du cycle de vie de groupe (GLE), consultez l' EventBridge-based alternative recommandée. Pour de plus amples informations, veuillez consulter [Fonctionnalité d'événements du cycle de vie de groupe de Groupes de ressources AWS changement de disponibilité](resource-groups-gle-availability-change.md).

Vous pouvez [ activer les événements du cycle de vie des groupes pour vos groupes de ressources ](monitor-groups-turn-on.md) Groupes de ressources AWS afin de publier des événements sur Amazon EventBridge. Vous pouvez ensuite créer des EventBridge règles qui répondent à ces événements en les envoyant à d'autres Services AWS pour un traitement ultérieur.

------
#### [ AWS CLI ]

Le processus de création d'une règle EventBridge qui capture les événements et les envoie au service cible souhaité nécessite deux commandes CLI distinctes :

1. [Créez la EventBridge règle pour capturer les événements que vous souhaitez ](#monitor-cli-create-rule)

1. [Attachez à la EventBridge règle une cible capable de traiter les événements ](#monitor-cli-attach-target)

Étape 1 : Création de la EventBridge règle pour capturer les événements  
L' AWS CLI `[put-rule](https://docs.aws.amazon.com/cli/latest/reference/events/put-rule.html)`exemple de commande suivant crée une EventBridge règle qui capture ** * toutes les modifications des événements du cycle de vie des groupes de * ** ressources.  

```bash
$ aws events put-rule \
    --name "CatchAllResourceGroupEvents" \
    --event-pattern '{"source":["aws.resource-groups"]}'
{
    "RuleArn": "arn:aws:events:us-east-1:123456789012:rule/CatchAllResourceGroupEvents"
}
```
La sortie inclut le nom de ressource Amazon (ARN) de la nouvelle règle.  
Les valeurs de paramètres qui incluent des chaînes entre guillemets ont des règles de formatage différentes en fonction du système d'exploitation et du shell que vous utilisez. Pour les exemples de ce guide, nous montrons les commandes qui fonctionnent sur un shell Linux BASH. Pour obtenir des instructions sur la mise en forme de chaînes avec des guillemets intégrés pour d'autres systèmes d'exploitation, tels que l'invite de commande Windows, voir [ Utilisation de guillemets dans les chaînes ](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html#cli-usage-parameters-quoting-strings-containing) dans le Guide de *AWS Command Line Interface l'utilisateur*.  
À mesure que les chaînes de paramètres deviennent plus complexes, il peut être plus facile et moins sujet aux erreurs d'[accepter une valeur de paramètre depuis un fichier texte ](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-file.html) au lieu de la saisir directement sur la ligne de commande.
Le modèle d'événement suivant limite les événements à ceux qui sont liés au groupe spécifié, identifié par son ARN. Ce modèle d'événement est une chaîne JSON complexe qui est beaucoup moins lisible lorsqu'elle est compressée en une chaîne JSON d'une seule ligne correctement échappée. Vous pouvez le stocker dans un fichier à la place.  
Stockez la chaîne JSON du modèle d'événement dans un fichier. Dans l'exemple de code suivant, le fichier est`eventpattern.txt`.  

```json
{
    "source": [ "aws.resource-groups" ],
    "detail": {
        "group": {
            "arn": [ "my-resource-group-arn" ]
        }
    }
}
```
Exécutez ensuite la commande suivante pour créer la règle, en récupérant le modèle d'événement personnalisé à partir du fichier.  

```bash
$ aws events put-rule \
    --name "CatchResourceGroupEventsForMyGroup" \
    --event-pattern file://eventpattern.txt
{
    "RuleArn": "arn:aws:events:us-east-1:123456789012:rule/CatchResourceGroupEventsForMyGroup"
}
```
Pour capturer d'autres types d'événements de groupes de ressources, remplacez la `--event-pattern` chaîne par des filtres similaires à ceux présentés dans la section[Exemples de modèles d'événements EventBridge personnalisés pour différents cas d'utilisation](monitor-groups-example-eventbridge-filters.md).

Étape 2 : Associez à la EventBridge règle une cible capable de traiter les événements   
Maintenant que vous disposez d'une règle qui capture les événements qui vous intéressent, vous pouvez associer une ou plusieurs cibles pour effectuer un certain type de traitement sur les événements.  
La AWS CLI `[put-targets](https://docs.aws.amazon.com/cli/latest/reference/events/put-targets.html)` commande suivante associe une rubrique Amazon Simple Notification Service (Amazon SNS) nommée `my-sns-topic` à la règle que vous avez créée dans l'exemple précédent. Tous les abonnés à la rubrique reçoivent une notification lorsqu'une modification est apportée au groupe spécifié dans la règle.  

```bash
$ aws events put-targets \
    --rule CatchResourceGroupEventsForMyGroup \
    --targets Id=1,Arn=arn:aws:sns:us-east-1:123456789012:my-sns-topic
{
    "FailedEntryCount": 0,
    "FailedEntries": []
}
```
À ce stade, toutes les modifications de groupe qui correspondent au modèle d'événement de votre règle sont automatiquement envoyées à la ou aux cibles configurées. Si, comme dans l'exemple précédent, la cible est une rubrique Amazon SNS, tous les abonnés à cette rubrique reçoivent un message contenant l'événement, comme décrit dans[Structure et syntaxe des événements du cycle de vie des groupes de ressources](monitor-groups-syntax.md). 

Pour plus d’informations, consultez les ressources suivantes :
+ AWS CLI — [ aws events put-rule ](https://docs.aws.amazon.com/cli/latest/reference/events/put-rule.html) et [ aws events put-targets ](https://docs.aws.amazon.com/cli/latest/reference/events/put-targets.html)
+ API — [ PutRule ](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutRule.html) et [ PutTargets ](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html)

------

## Création d'une règle pour ne capturer que des types d'événements spécifiques du cycle de vie des groupes
<a name="monitor-groups-create-rule-custom"></a>

Vous pouvez créer une règle avec un modèle d'événement personnalisé qui capture uniquement les événements qui vous intéressent. Pour plus de détails sur la façon de filtrer les événements entrants à l'aide d'un modèle d'événement personnalisé, consultez [ Amazon EventBridge Events ](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html) dans le guide de EventBridge l'utilisateur * Amazon*.

Supposons, par exemple, que vous souhaitiez qu'une règle traite uniquement les notifications de groupes de ressources qui indiquent la création d'un nouveau groupe de ressources. Vous pouvez utiliser un modèle d'événement personnalisé similaire à l'exemple suivant.

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

Ce filtre capture uniquement les événements qui ont ces valeurs exactes dans les champs spécifiés. Pour une liste complète des champs que vous pouvez faire correspondre, consultez[Structure et syntaxe des événements du cycle de vie des groupes de ressources](monitor-groups-syntax.md).