

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.

# Utilisation du contrôle de préparation dans ARC avec Amazon EventBridge
<a name="eventbridge-readiness"></a>

**Note**  
La fonction de vérification de l'état de préparation d'Amazon Application Recovery Controller (ARC) n'est plus accessible aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section Changement de disponibilité du contrôle de disponibilité d'[Amazon Application Recovery Controller (ARC)](https://docs.aws.amazon.com/r53recovery/latest/dg/arc-readiness-availability-change.html).

À l'aide d'Amazon EventBridge, vous pouvez configurer des règles pilotées par des événements qui surveillent vos ressources de vérification de l'état de préparation dans Amazon Application Recovery Controller (ARC), puis lancer des actions ciblées utilisant d'autres AWS services. Par exemple, vous pouvez définir une règle pour l'envoi de notifications par e-mail en signalant à une rubrique Amazon SNS lorsque l'état d'un contrôle de préparation passe de ** READY ** à ** NOT ** READY.

**Note**  
L'ARC publie uniquement des EventBridge événements pour le contrôle de l'état de préparation dans la région de l'Ouest des États-Unis (Oregon) (us-west-2). AWS Pour recevoir des EventBridge événements en vue d'un contrôle de préparation, créez des EventBridge règles dans la région Ouest des États-Unis (Oregon).

Vous pouvez créer des règles dans Amazon EventBridge pour agir sur l'événement de contrôle de préparation ARC suivant :
+ *État de préparation Vérifiez l'état de préparation. * L'événement indique si l'état du contrôle de préparation change, par exemple, de ** READY ** à ** NOT READY**.

Pour capturer les événements ARC spécifiques qui vous intéressent, définissez des modèles spécifiques à l'événement que vous EventBridge pouvez utiliser pour détecter les événements. Les modèles d'événements ont la même structure que les événements auxquels ils correspondent. Le modèle place entre guillemets les champs que vous voulez faire correspondre et fournit les valeurs que vous recherchez. 

Les événements sont générés dans la mesure du possible. Ils sont livrés de l'ARC à presque EventBridge en temps réel dans des circonstances opérationnelles normales. Cependant, des situations peuvent survenir qui pourraient retarder ou empêcher la livraison d'un événement.

Pour plus d'informations sur la façon dont EventBridge les règles fonctionnent avec les modèles d'événements, voir [ Événements et modèles d'événements dans EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html). 

## Surveillez une ressource de vérification de l'état de préparation avec EventBridge
<a name="arc-eventbridge-tasks-readiness"></a>

Avec EventBridge, vous pouvez créer des règles qui définissent les actions à entreprendre lorsque l'ARC émet des événements pour les ressources de contrôle de disponibilité. 

Pour taper ou copier et coller un modèle d'événement dans la EventBridge console, dans la console, sélectionnez l'option ** Entrez ma propre ** option. Pour vous aider à déterminer les modèles d'événements susceptibles de vous être utiles, cette rubrique inclut des [ exemples de modèles d'événements de préparation](#arc-eventbridge-examples-readiness).

**Pour créer une règle pour un événement de ressource**

1. Ouvrez la EventBridge console Amazon à l'adresse [ https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1.  Région AWS Pour créer la règle dans laquelle vous souhaitez créer la règle, choisissez USA West (Oregon). Il s'agit de la région requise pour les événements de préparation.

1. Choisissez **Create rule**.

1. Entrez un **nom** et éventuellement une description pour la règle.

1. Pour ** Event bus**, conservez la valeur par défaut, ** default**.

1. Choisissez **Suivant**.

1. Pour l'**étape ** Créer un modèle d'événement, pour Source de l'**événement**, laissez la valeur par défaut, **AWS events**.

1. Sous ** Exemple d'événement**, choisissez ** Entrez le mien**.

1. Pour ** Exemples d'événements**, saisissez ou copiez et collez un modèle d'événement. Pour des exemples, reportez-vous à la section suivante.

## Exemples de modèles d'événements de préparation
<a name="arc-eventbridge-examples-readiness"></a>

Les modèles d'événements ont la même structure que les événements auxquels ils correspondent. Le modèle place entre guillemets les champs que vous voulez faire correspondre et fournit les valeurs que vous recherchez.

Vous pouvez copier et coller des modèles d'événements à partir de cette section EventBridge pour créer des règles que vous pouvez utiliser pour surveiller les actions et les ressources ARC.

Les modèles d'événements suivants fournissent des exemples que vous pouvez utiliser EventBridge pour la fonctionnalité de vérification de l'état de préparation dans ARC.
+ *Sélectionnez tous les événements dans le contrôle de préparation ARC*.

  ```
  {
      "source": [
          "aws.route53-recovery-readiness"
      ]
  }
  ```
+ *Sélectionnez uniquement les événements liés aux cellules*.

  ```
  {
      "source": [
          "aws.route53-recovery-readiness"
      ],
      "detail-type": [
          "Route 53 Application Recovery Controller cell readiness status change"
      ]
  }
  ```
+ *Sélectionnez uniquement les événements liés à une cellule spécifique appelée `MyExampleCell`*.

  ```
  {
      "source": [
          "aws.route53-recovery-readiness"
      ],
      "detail-type": [
          "Route 53 Application Recovery Controller cell readiness status change"
      ],
      "resources": [
          "arn:aws:route53-recovery-readiness::111122223333:cell/MyExampleCell"
      ]
  }
  ```
+ *Sélectionnez uniquement les événements correspondant à l'état d'un groupe de récupération, d'une cellule ou d'un contrôle de préparation `NOT READY`*.

  ```
  {
     "source":[
        "aws.route53-recovery-readiness"
     ],
     "detail-type":{
        "new-state":{
           "readiness-status":[
              "NOT_READY"
           ]
        }
     }
  }
  ```
+ *Sélectionnez uniquement les événements lorsqu'un groupe de récupération, une cellule ou un contrôle de préparation devient quelque chose sauf `READY` *

  ```
  {
     "source":[
        "aws.route53-recovery-readiness"
     ],
     "detail":{
        "new-state":{
           "readiness-status":[
              {
                 "anything-but":"READY"
              }
           ]
        }
     }
  }
  ```

Voici un exemple d'événement ARC pour un changement de statut de préparation d'un groupe de * rétablissement * :

```
{
    "version": "0",
    "account":"111122223333",
    "detail-type":"Route 53 Application Recovery Controller recovery group readiness status change",
    "source":"route53-recovery-readiness.amazonaws.com",
    "time":"2020-11-03T00:31:54Z",
    "id": "1234a678-1b23-c123-12fd3f456e78",
    "region": "us-west-2",
    "resources":[
        "arn:aws:route53-recovery-readiness::111122223333:recovery-group/BillingApp"
    ],
    "detail": {
        "recovery-group-name": "BillingApp",
        "previous-state": {
            "readiness-status": "READY|NOT_READY|UNKNOWN|NOT_AUTHORIZED"
        },
        "new-state": {
            "readiness-status": "READY|NOT_READY|UNKNOWN|NOT_AUTHORIZED"
        }
    }
}
```

Voici un exemple d'événement ARC pour un changement d'état de préparation d'une * cellule * :

```
{
    "version": "0",
    "account":"111122223333",
    "detail-type":"Route 53 Application Recovery Controller cell readiness status change",
    "source":"route53-recovery-readiness.amazonaws.com",
    "time":"2020-11-03T00:31:54Z",
    "id": "1234a678-1b23-c123-12fd3f456e78",
    "region": "us-west-2",
    "resources":[
        "arn:aws:route53-recovery-readiness::111122223333:cell/PDXCell"
    ],
    "detail": {
        "cell-name": "PDXCell",
        "previous-state": {
            "readiness-status": "READY|NOT_READY|UNKNOWN|NOT_AUTHORIZED"
        },
        "new-state": {
            "readiness-status": "READY|NOT_READY|UNKNOWN|NOT_AUTHORIZED"
        }
    }
}
```

Voici un exemple d'événement ARC pour un changement de statut de contrôle de * disponibilité * :

```
{
    "version": "0",
    "account":"111122223333",
    "detail-type":"Route 53 Application Recovery Controller readiness check status change",
    "source":"route53-recovery-readiness.amazonaws.com",
    "time":"2020-11-03T00:31:54Z",
    "id": "1234a678-1b23-c123-12fd3f456e78",
    "region": "us-west-2",
    "resources":[
        "arn:aws:route53-recovery-readiness::111122223333:readiness-check/UserTableReadinessCheck"
    ],
    "detail": {
    "readiness-check-name": "UserTableReadinessCheck",
        "previous-state": {
            "readiness-status": "READY|NOT_READY|UNKNOWN|NOT_AUTHORIZED"
        },
        "new-state": {
            "readiness-status": "READY|NOT_READY|UNKNOWN|NOT_AUTHORIZED"
        }
    }
}
```

## Spécifiez un groupe de CloudWatch journaux à utiliser comme cible
<a name="arc-eventbridge-cw-loggroup"></a>

Lorsque vous créez une EventBridge règle, vous devez spécifier la cible vers laquelle sont envoyés les événements correspondant à la règle. Pour obtenir la liste des cibles disponibles pour EventBridge, consultez la section [ Cibles disponibles dans la EventBridge console](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html#eb-console-targets). L'une des cibles que vous pouvez ajouter à une EventBridge règle est un groupe de CloudWatch journaux Amazon. Cette section décrit les exigences relatives à l'ajout de groupes de CloudWatch journaux en tant que cibles et fournit une procédure pour ajouter un groupe de journaux lorsque vous créez une règle.

Pour ajouter un groupe de CloudWatch journaux en tant que cible, vous pouvez effectuer l'une des opérations suivantes :
+ Création d'un nouveau groupe de journaux 
+ Choisissez un groupe de journaux existant

Si vous spécifiez un nouveau groupe de journaux à l'aide de la console lorsque vous créez une règle, le groupe de journaux est EventBridge automatiquement créé pour vous. Assurez-vous que le groupe de journaux que vous utilisez comme cible pour la EventBridge règle commence par`/aws/events`. Si vous souhaitez choisir un groupe de journaux existant, sachez que seuls les groupes de journaux commençant par `/aws/events` apparaissent en tant qu'options dans le menu déroulant. Pour plus d'informations, consultez [ Créer un nouveau groupe de journaux ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) dans le Guide de CloudWatch l'utilisateur * Amazon*.

Si vous créez ou utilisez un groupe de CloudWatch journaux à utiliser comme cible à l'aide d' CloudWatch opérations extérieures à la console, assurez-vous de définir correctement les autorisations. Si vous utilisez la console pour ajouter un groupe de journaux à une EventBridge règle, la politique basée sur les ressources pour le groupe de journaux est automatiquement mise à jour. Toutefois, si vous utilisez le AWS Command Line Interface ou un AWS SDK pour spécifier un groupe de journaux, vous devez mettre à jour la politique basée sur les ressources pour le groupe de journaux. L'exemple de politique suivant illustre les autorisations que vous devez définir dans une stratégie basée sur les ressources pour le groupe de journaux :

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 

    "Statement": [
        {
            "Action": [
                "logs:CreateLogStream",
                "logs:PutLogEvents"
            ],
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "events.amazonaws.com",
                    "delivery.logs.amazonaws.com"
                ]
            },
            "Resource": "arn:aws:logs:us-east-1:{{222222222222}}:log-group:/aws/events/*:*",
            "Sid": "TrustEventsToStoreLogEvent"
        }
    ]
}
```

------

Vous ne pouvez pas configurer de politique basée sur les ressources pour un groupe de journaux à l'aide de la console. Pour ajouter les autorisations requises à une politique basée sur les ressources, utilisez l'opération CloudWatch [ PutResourcePolicy ](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutResourcePolicy.html) API. Vous pouvez ensuite utiliser la commande [ CLI ](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-resource-policies.html) describe-resource-policies pour vérifier que votre politique a été correctement appliquée.

**Pour créer une règle pour un événement de ressource et spécifier une cible de groupe de CloudWatch journaux**

1. Ouvrez la EventBridge console Amazon à l'adresse [ https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Choisissez la règle dans Région AWS laquelle vous souhaitez créer la règle.

1. Choisissez ** Créer une règle, ** puis entrez toutes les informations relatives à cette règle, telles que le schéma de l'événement ou les détails du calendrier.

   Pour plus d'informations sur la création de EventBridge règles de préparation, voir [ Surveiller une ressource de vérification de l'état de préparation avec EventBridge](#RCEventBridgeCreateRule).

1. Sur la ** page ** Sélectionner la cible, choisissez ** CloudWatch ** comme cible.

1. Choisissez un groupe de CloudWatch journaux dans le menu déroulant.