

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.

# Configurer une destination d' CloudWatch événement Amazon dans un SMS de messagerie à l'utilisateur AWS final
<a name="configuration-sets-cloud-watch"></a>

Amazon CloudWatch Logs est un AWS service que vous pouvez utiliser pour surveiller, stocker et accéder aux fichiers journaux. Lorsque vous créez une destination d' CloudWatch événement, AWS la messagerie SMS destinée à l'utilisateur final envoie à un CloudWatch groupe les types d'événements que vous avez spécifiés dans la destination de l'événement. Pour en savoir plus CloudWatch, consultez le [guide de l'utilisateur d'Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/).

**Conditions préalables**

1. Avant de créer une destination d' CloudWatch événement, vous devez d'abord créer un CloudWatch groupe. Pour plus d'informations sur la création de groupes de journaux, consultez la section [Utilisation des groupes de journaux et des flux](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) de * CloudWatch journaux dans le guide de l'utilisateur Amazon Logs*.
**Important**  
Vous aurez besoin du nom de ressource Amazon (ARN) du CloudWatch groupe pour créer la destination de l'événement.

1. Vous devez créer un [rôle IAM](configuration-sets-cloud-watch-creating-role.md#configuration-sets-cloud-watch-creating-role.title) qui autorise les messages SMS de l'utilisateur AWS final à écrire dans le groupe de journaux.
**Important**  
Vous aurez besoin du nom de ressource Amazon (ARN) du rôle IAM pour créer la destination de l'événement.

1. Vous avez également configuré un ensemble de configuration pour associer les destinations des événements, voir[Création d'un ensemble de configuration dans le SMS de messagerie à l'utilisateur AWS final](configuration-set-create.md).

# Politique IAM pour Amazon CloudWatch
<a name="configuration-sets-cloud-watch-creating-role"></a>

Utilisez l'exemple suivant pour créer une politique d'envoi d'événements à un CloudWatch groupe.

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogStream",
                "logs:DescribeLogStreams",
                "logs:PutLogEvents"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:111122223333:log-group:log-group-name:*"
            ]
        }
    ]    
}
```

------

Pour des informations sur les politiques IAM, consultez [Politiques et autorisations dans IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) dans le *Guide de l'utilisateur IAM*.

L'exemple d'instruction suivant utilise les `SourceArn` conditions facultatives mais recommandées pour vérifier que seul le compte propriétaire de la messagerie SMS de l'utilisateur AWS final a accès au jeu de configuration. `SourceAccount` Dans cet exemple, remplacez-le *accountId* par votre identifiant de AWS compte, *region* par le Région AWS nom et *ConfigSetName* par le nom du jeu de configuration.

Après avoir créé la politique, créez un nouveau rôle IAM, puis associez-y la politique. Lorsque vous créez le rôle, ajoutez-y également la politique de confiance suivante :

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": {
        "Effect": "Allow",
        "Principal": {
            "Service": "sms-voice.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
            "StringEquals": {
                "aws:SourceAccount": "111122223333"
            },
            "ArnLike": {
                "aws:SourceArn": "arn:aws:sms-voice:us-east-1:111122223333:configuration-set/ConfigSetName"
            }
        }
    }
}
```

------

Pour plus d'informations sur la création de rôles IAM, consultez [Création de rôles IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html) dans le *Guide de l'utilisateur IAM*.

# Création d'une destination d' CloudWatch événement Amazon dans un SMS destiné aux utilisateurs AWS finaux
<a name="configuration-sets-cloud-watch-add"></a>

Après avoir créé le rôle IAM et le CloudWatch groupe, vous pouvez créer la destination de l'événement.

------
#### [ Create event destination (Console) ]

Pour créer une destination d'événement à l'aide de la console SMS de messagerie utilisateur AWS final, procédez comme suit :

1. Ouvrez la console SMS de messagerie utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration auquel ajouter une destination d'événement. 

1. Sur la page des **détails du jeu de configuration**, choisissez **Ajouter un événement de destination**.

1. Dans la section **Détails de l'événement**, entrez un nom convivial pour le nom de **destination de l'événement**.

1. Dans le menu déroulant **Type de destination**, sélectionnez Amazon CloudWatch.

1. Pour le **rôle IAM arn**, entrez l'ARN du rôle IAM. Pour plus d'informations sur le rôle IAM arn, consultez[Politique IAM pour Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md).

1. Pour **Log group arn**, entrez l'ARN du groupe de CloudWatch journaux Amazon auquel transmettre les événements. 

1. Activez la **publication d'événements**.

1. Sous **Types d'événements**, sélectionnez :
   + **Tous les événements SMS (recommandé)** — Choisissez cette option pour envoyer tous les événements SMS répertoriés sur Amazon CloudWatch. [Types d’événements](configuration-sets-event-types.md)
   + **Événements SMS personnalisés** : choisissez des événements SMS spécifiques auxquels envoyer CloudWatch. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements SMS**. Sur **Modifier la sélection des événements par SMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.
   + **Tous les événements vocaux (recommandé)** — Choisissez cette option pour envoyer tous les événements [Types d’événements](configuration-sets-event-types.md) vocaux répertoriés sur Amazon CloudWatch.
   + **Événements vocaux personnalisés** : choisissez des événements vocaux spécifiques auxquels envoyer CloudWatch. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements vocaux**. Sur **Modifier la sélection des événements vocaux**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.
   + **Tous les événements MMS (recommandé)** — Choisissez cette option pour envoyer tous les événements MMS répertoriés [Types d’événements](configuration-sets-event-types.md) sur Amazon. CloudWatch
   + Événements **MMS personnalisés — Choisissez des événements** MMS spécifiques auxquels envoyer. CloudWatch Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements MMS**. Lors de la **sélection des événements Edit MMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.

1. Choisissez **Create event (Créer un événement)**.

------
#### [ Create event destination (AWS CLI) ]

Vous pouvez utiliser la [create-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-event-destination.html)commande pour créer une destination d'événement.

Dans la ligne de commande, exécutez la commande suivante :

```
$ aws pinpoint-sms-voice-v2 create-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event-types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```

Dans l’exemple précédent, apportez les modifications suivantes :
+ *eventDestinationName*Remplacez-le par un nom décrivant la destination de l'événement.
+ *configurationSet*Remplacez-le par le nom du jeu de configuration auquel vous souhaitez associer la destination de l'événement.
+ Remplacez *eventTypes* par un ou plusieurs des types d'événements répertoriés dans[Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md). 
+ Remplacez la valeur de `IamRoleArn` par l'Amazon Resource Name (ARN) d'un rôle IAM dont les politiques sont décrites dans [Politique IAM pour Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md).
+ Remplacez la valeur `LogGroupArn` de par l'ARN du CloudWatch groupe auquel vous souhaitez envoyer des événements. 

------

# Modifier la destination d'un CloudWatch événement Amazon dans un SMS destiné aux utilisateurs AWS finaux
<a name="configuration-sets-cloud-watch-edit"></a>

Utilisez la console SMS de messagerie utilisateur AWS final ou AWS CLI pour modifier la destination d'un CloudWatch événement.

------
#### [ Update event destination (Console) ]

Pour mettre à jour la destination d'un événement à l'aide de la console SMS de messagerie utilisateur AWS final, procédez comme suit :

1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration à modifier. 

1. Dans l'onglet **Paramètres de l'événement**, choisissez une destination d' CloudWatchévénement Amazon, puis **Modifier**.

1. Dans le **champ ARN du rôle IAM**, entrez l'ARN du rôle IAM. Pour plus d'informations sur le rôle IAM arn, consultez[Politique IAM pour Amazon CloudWatch](configuration-sets-cloud-watch-creating-role.md).

1. Pour **Log group arn**, entrez l'ARN du groupe de CloudWatch journaux Amazon auquel transmettre les événements. 

1. Sous **Types d'événements**, sélectionnez :
   + **Tous les événements SMS (recommandé)** — Choisissez cette option pour envoyer tous les événements SMS répertoriés sur Amazon CloudWatch. [Types d’événements](configuration-sets-event-types.md)
   + **Événements SMS personnalisés** — Choisissez cette option pour sélectionner les événements SMS spécifiques auxquels envoyer CloudWatch. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements SMS**. Sur **Modifier la sélection des événements par SMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.
   + **Tous les événements vocaux (recommandé)** — Choisissez cette option pour envoyer tous les événements [Types d’événements](configuration-sets-event-types.md) vocaux répertoriés sur Amazon CloudWatch.
   + **Événements vocaux personnalisés** : choisissez cette option pour sélectionner les événements vocaux spécifiques auxquels envoyer CloudWatch. Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements vocaux**. Sur **Modifier la sélection des événements vocaux**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.
   + **Tous les événements MMS (recommandé)** — Choisissez cette option pour envoyer tous les événements MMS répertoriés [Types d’événements](configuration-sets-event-types.md) sur Amazon. CloudWatch
   + **Événements MMS personnalisés** — Choisissez cette option pour sélectionner les événements MMS spécifiques auxquels vous souhaitez les envoyer. CloudWatch Pour modifier la liste des événements, choisissez **Modifier la sélection d'événements MMS**. Lors de la **sélection des événements Edit MMS**, cochez uniquement les événements que vous souhaitez envoyer à Amazon CloudWatch. Choisissez **Enregistrer la sélection**.

1. Choisissez **Modifier l'événement**.

------
#### [ Update event destination AWS CLI) ]

Vous pouvez utiliser la [update-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-event-destination.html)commande pour mettre à jour la destination d'un événement.

La procédure de mise à jour d'une destination d' CloudWatch événement est similaire au processus de création d'une destination d'événement. Dans la ligne de commande, exécutez la commande suivante :

```
$ aws pinpoint-sms-voice-v2 update-event-destination \
> --event-destination-name eventDestinationName \
> --configuration-set-name configurationSet \
> --matching-event types eventTypes \
> --cloud-watch-logs-destination IamRoleArn=arn:aws:iam::111122223333:role/CWLSMSRole,LogGroupArn=arn:aws:logs:us-east-1:111122223333:log-group:MyCWLLogGroup
```

Dans l’exemple précédent, apportez les modifications suivantes :
+ *eventDestinationName*Remplacez-le par le nom de la destination de l'événement que vous souhaitez modifier.
+ *configurationSet*Remplacez-le par le nom du jeu de configuration auquel vous souhaitez associer la destination de l'événement. Vous pouvez associer la destination de l'événement à un autre jeu de configuration.
+ *eventTypes*Remplacez-le par l'un des types d'événements répertoriés dans[Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md).
+ Remplacez la valeur de `IamRoleArn` par l'Amazon Resource Name (ARN) d'un rôle IAM dont les politiques sont décrites dans [Types d'événements pour les SMS, les MMS et les appels vocaux](configuration-sets-event-types.md).
+ Remplacez la valeur `LogGroupArn` de par l'ARN du CloudWatch groupe auquel vous souhaitez envoyer des événements. 

------

# Supprimer une destination d' CloudWatch événement Amazon dans un SMS de messagerie à l'utilisateur AWS final
<a name="configuration-sets-cloud-watch-delete"></a>

Utilisez la console SMS de messagerie utilisateur AWS final ou AWS CLI pour supprimer une destination d' CloudWatch événement.

------
#### [ Delete an CloudWatch event destination (Console) ]

Le processus de suppression d'une destination d'événement est le même quel que soit le type de destination d'événement que vous souhaitez supprimer.

**Pour supprimer une destination d' CloudWatch événement dans la console**

1. Ouvrez la console SMS de messagerie de l'utilisateur AWS final à l'adresse [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Dans le volet de navigation, sous **Configurations**, sélectionnez **Ensembles de configuration**.

1. Sur la page **Ensembles de configuration**, choisissez le jeu de configuration dont vous souhaitez supprimer une destination d'événement. 

1. Dans la section **Toutes les destinations**, choisissez une destination d'événement, puis cliquez **sur Supprimer**.

------
#### [ Delete an CloudWatch event destination (AWS CLI) ]

Vous pouvez utiliser la [delete-event-destination](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-event-destination.html)commande pour supprimer la destination d'un événement.

Le processus de suppression d'une destination d'événement est le même quel que soit le type de destination d'événement que vous souhaitez supprimer.

**Pour supprimer une destination d' CloudWatch événement dans AWS CLI**
+ Dans la ligne de commande, exécutez la commande suivante :

  ```
  $ aws pinpoint-sms-voice-v2 delete-event-destination \
  > --event-destination-name eventDestinationName \
  > --configuration-set-name configurationSetName
  ```

  Dans l’exemple précédent, apportez les modifications suivantes :
  + *eventDestinationName*Remplacez-le par le nom ou le Amazon Resource Name (ARN) de la destination de l'événement que vous souhaitez supprimer.
  + Remplacez *configurationSetName* par le nom ou l'ARN du jeu de configuration auquel la destination de l'événement est associée.

------