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.
# Configuration de la publication d'événements Amazon SES
Cette section décrit ce que vous devez faire pour configurer Amazon SES afin de publier vos événements d'envoi d'e-mails aux AWS services suivants :
+ Amazon CloudWatch
+ Amazon Data Firehose
+ Amazon Pinpoint
+ Amazon Simple Notification Service (Amazon SNS)
Les étapes suivantes, nécessaires à la configuration de la publication d'événements, sont décrites dans les rubriques ci-dessous :
1. Vous devez créer un *jeu de configurations* à l'aide de la console ou de l'API Amazon SES.
1. Ajoutez une ou plusieurs *destinations d'événements* (FirehoseCloudWatch, Pinpoint ou SNS) à l'ensemble de configuration et configurez des paramètres propres à la destination de l'événement.
1. Lorsque vous envoyez un e-mail, vous devez spécifier le jeu de configuration à utiliser qui contient la destination de votre événement.
**Topics**
+ [Étape 1 : Création d'un jeu de configurations](event-publishing-create-configuration-set.md)
+ [Étape 2 : Ajout d'une destination d'événement](event-publishing-add-event-destination.md)
+ [Étape 3 : Spécifier votre jeu de configuration lorsque vous envoyez un e-mail](event-publishing-send-email.md)
# Étape 1 : Création d'un jeu de configurations
Vous devez d'abord disposer d'un jeu de configuration pour mettre en place la publication d'événements. Si vous n'avez pas encore de jeu de configuration, ou si vous souhaitez en créer un nouveau, consultez [Création de jeux de configuration dans SES](creating-configuration-sets.md)
Vous pouvez également créer des ensembles de configuration à l'aide de l'[CreateConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateConfigurationSet.html)opération de l'API Amazon SES V2 ou de l'Amazon SES CLI v2, voir[Créer un jeu de configurations (AWS CLI)](creating-configuration-sets.md#config-sets-create-cli).
# Étape 2 : Ajout d'une destination d'événement
Les destinations d'événements sont des endroits où vous publiez des événements Amazon SES Chaque destination d'événement que vous configurez appartient à un, et à un seul, jeu de configurations. Lorsque vous configurez une destination d'événement avec Amazon SES, vous choisissez la destination du AWS service et vous spécifiez les paramètres associés à cette destination.
Lorsque vous configurez la destination d'un événement, vous pouvez choisir d'envoyer des événements à l'un des AWS services suivants :
+ Amazon CloudWatch
+ Amazon Data Firehose
+ Amazon EventBridge
+ Amazon Pinpoint
+ Amazon Simple Notification Service (Amazon SNS)
La destination d'événement que vous choisissez dépend du niveau de détail voulu sur les événements et de la façon dont vous souhaitez recevoir les informations sur les événements. Si vous voulez simplement un total cumulé de chaque type d'événement (par exemple, pour pouvoir définir le déclenchement d'une alarme lorsque le total devient trop élevé), utilisez CloudWatch.
Si vous souhaitez des enregistrements d'événements détaillés que vous pouvez envoyer à un autre service tel qu'Amazon OpenSearch Service ou Amazon Redshift à des fins d'analyse, vous pouvez utiliser Firehose.
Si vous souhaitez recevoir des notifications lorsque certains événements se produisent, choisissez Amazon SNS.
**Topics**
+ [Configurer une destination d' CloudWatch événement pour la publication d'événements](event-publishing-add-event-destination-cloudwatch.md)
+ [Configurer une destination d'événements Data Firehose pour la publication d'événements Amazon SES](event-publishing-add-event-destination-firehose.md)
+ [Configurer une EventBridge destination Amazon pour la publication d'événements](event-publishing-add-event-destination-eventbridge.md)
+ [Configuration d'une destination d'événement Amazon Pinpoint pour la publication d'événements](event-publishing-add-event-destination-pinpoint.md)
+ [Configurer une destination d'événement Amazon SNS pour la publication d'événements](event-publishing-add-event-destination-sns.md)
# Configurer une destination d' CloudWatch événement pour la publication d'événements
Avec [Amazon CloudWatch Metrics](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/working_with_metrics.html), vous pouvez utiliser les destinations des événements pour publier les événements d'envoi d'e-mails vers Amazon SES CloudWatch. Étant donné qu'une destination d' CloudWatch événement ne peut être configurée que dans un ensemble de configuration, vous devez d'abord [créer un ensemble de configuration](event-publishing-create-configuration-set.md), puis ajouter la destination de l'événement au jeu de configuration.
Lorsque vous ajoutez une destination d' CloudWatch événement à un ensemble de configuration, vous devez choisir une ou plusieurs CloudWatch *dimensions* correspondant aux balises de message que vous utilisez lorsque vous envoyez vos e-mails. À l'instar des balises de message, une CloudWatch dimension est une name/value paire qui vous permet d'identifier une métrique de manière unique.
Par exemple, vous pouvez utiliser une balise de message et une dimension appelée `campaign` pour identifier votre campagne d'e-mailing. Lorsque vous publiez vos événements d'envoi d'e-mails sur CloudWatch, il est important de choisir les balises et les dimensions de vos messages, car ces choix ont une incidence sur votre CloudWatch facturation et déterminent la manière dont vous pouvez filtrer les données de vos événements d'envoi d'e-mails CloudWatch.
Cette section fournit des informations pour vous aider à choisir vos dimensions, puis montre comment ajouter une destination d' CloudWatch événement à un ensemble de configuration.
**Topics**
+ [Ajouter une destination CloudWatch d'événement](#event-publishing-add-event-destination-cloudwatch-add)
+ [Choix des CloudWatch dimensions](#event-publishing-add-event-destination-cloudwatch-dimensions)
## Ajouter une destination CloudWatch d'événement
La procédure décrite dans cette section explique comment ajouter les détails de la destination d'un CloudWatch événement à un ensemble de configuration et suppose que vous avez effectué les étapes 1 à 6 dans[Création d'une destination d'événement](event-destinations-manage.md#event-destination-add).
Vous pouvez également utiliser l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)opération dans l'API Amazon SES V2 pour créer et modifier les destinations des événements.
**Pour ajouter les détails de la destination de l' CloudWatch événement à un ensemble de configuration à l'aide de la console**
1. Voici les instructions détaillées pour sélectionner le type CloudWatch de destination de votre événement à l'[étape 7](event-destinations-manage.md#specify-event-dest-step) et en supposant que vous avez effectué toutes les étapes précédentes[Création d'une destination d'événement](event-destinations-manage.md#event-destination-add). Après avoir sélectionné le **type de CloudWatch destination**, saisi un **nom** de destination et activé la **publication d'événements**, le volet des ** CloudWatch dimensions Amazon** s'affiche. Ses champs sont traités dans les étapes suivantes. *(Des frais supplémentaires s'appliquent, voir [Prix par métrique pour CloudWatch](#cw-add-pricing).)*
1. Pour **Value Source**, spécifiez comment Amazon SES obtiendra les données auxquelles elles seront transmises CloudWatch. Les sources de valeur suivantes sont disponibles :
+ **Message Tag (Balise de message)** – Amazon SES extrait le nom et la valeur de la dimension d'une balise que vous spécifiez à l'aide de l'en-tête `X-SES-MESSAGE-TAGS` ou du paramètre d'API `EmailTags`. Pour en savoir plus sur l'utilisation des balises de message, consultez la page [Étape 3 : Spécifier votre jeu de configuration lorsque vous envoyez un e-mail](event-publishing-send-email.md).
**Note**
Les balises de messages peuvent inclure les chiffres de 0 à 9, les lettres A-Z (majuscules et minuscules), des tirets (-) et des traits de soulignement (\$1).
Vous pouvez également utiliser la source de valeur **Message Tag (Balise de message)** pour créer des dimensions en fonction des balises automatiques pour Amazon SES. Pour utiliser une balise automatique, tapez le nom de cette balise automatique en tant que **Dimension Name (Nom de la dimension)**. Par exemple, pour créer une dimension basée sur la balise automatique de jeu de configurations, utilisez `ses:configuration-set` pour **Dimension Name (Nom de la dimension)**, et le nom du jeu de configurations pour **Default Value (Valeur par défaut)**. Pour obtenir la liste complète des balises automatiques, consultez [Comment fonctionne la publication d'événements avec les ensembles de configuration et les balises de message](monitor-using-event-publishing.md#event-publishing-how-works).
+ **Email Header (En-tête d'e-mail)** – Amazon SES extrait le nom et la valeur de la dimension d'un en-tête dans l'e-mail.
**Note**
Vous ne pouvez pas utiliser les en-têtes d'e-mail suivants comme **Dimension Name (Nom de dimension)** : `Received`, `To`, `From`, `DKIM-Signature`, `CC`, `message-id` ou `Return-Path`.
+ **Link Tag (Balise de lien)** – Amazon SES extrait le nom et la valeur de la dimension d'une balise que vous avez spécifiée dans un lien. Pour en savoir plus sur l'ajout des balises, consultez [Puis-je baliser les liens avec des identificateurs uniques ?](faqs-metrics.md#sending-metric-faqs-clicks-q5).
1. Pour **Dimension Name (Nom de la dimension)**, tapez le nom de la dimension que vous souhaitez transmettre à CloudWatch.
**Note**
Les noms de dimension peuvent uniquement contenir des lettres ASCII (a à z, A à Z), des chiffres (0 à 9), des traits de soulignement (\$1) ou des tirets (-). Les espaces, les caractères accentués, les caractères non latins et les autres caractères spéciaux ne sont pas autorisés.
1. Dans **Default Value (Valeur par défaut)**, saisissez la valeur de la dimension.
**Note**
Les valeurs de dimension ne peuvent contenir que des lettres ASCII (a à z, A à Z), des chiffres (0 à 9), des traits de soulignement (\$1), des tirets (-), des signes (@) et des points (.). Les espaces, les caractères accentués, les caractères non latins et les autres caractères spéciaux ne sont pas autorisés.
1. Pour ajouter d'autres dimensions, sélectionnez **Add Dimension (Ajouter une dimension)**. Sinon, choisissez **Next (Suivant)**.
1. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez **Add destination (Ajouter une destination)**.
## Choix des CloudWatch dimensions
Lorsque vous choisissez des noms et des valeurs à utiliser comme CloudWatch dimensions, tenez compte des facteurs suivants :
+ **Prix par métrique** — Vous pouvez consulter les statistiques de base d'Amazon SES CloudWatch gratuitement. Toutefois, lorsque vous collectez des statistiques à l'aide de la publication d'événements, vous encourez des coûts [de surveillance CloudWatch détaillée](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch-metrics-basic-detailed.html). Chaque combinaison unique de type d'événement, de nom de dimension et de valeur de dimension crée une métrique différente dans CloudWatch. Lorsque vous utilisez CloudWatch la surveillance détaillée, vous êtes facturé pour chaque métrique. Pour cette raison, vous pouvez décider de ne pas choisir de dimensions qui peuvent prendre de nombreuses valeurs différentes. Par exemple, à moins que vous soyez très intéressé par le suivi de vos événements d'envoi d'e-mails par domaine d'expédition, vous pouvez décider de ne pas définir de dimension pour la balise automatique `ses:from-domain` Amazon SES, car elle peut prendre de nombreuses valeurs différentes. Pour plus d’informations, consultez [Tarification d’CloudWatch](https://aws.amazon.com/cloudwatch/pricing).
+ **Filtrage des métriques** : si une métrique possède plusieurs dimensions, vous ne pouvez pas accéder à la métrique en CloudWatch fonction de chaque dimension séparément. Pour cette raison, réfléchissez bien avant d'ajouter plusieurs dimensions à une même destination d' CloudWatch événement. Par exemple, si vous souhaitez des métriques par `campaign` et par combinaison de `campaign` et `genre`, vous devez ajouter deux destinations d'événement : l'une avec uniquement `campaign` comme dimension, et l'autre avec `campaign` et `genre` comme dimensions.
+ **Source des valeurs de dimension** – Au lieu de spécifier vos valeurs de dimension en utilisant des en-têtes propres à Amazon SES ou un paramètre destiné à l'API, vous pouvez également choisir de laisser Amazon SES prendre les valeurs de dimension de vos propres en-têtes de message MIME. Vous pouvez opter pour cette solution si vous utilisez déjà des en-têtes personnalisés et que vous ne voulez pas modifier vos e-mails ou vos appels à l'API d'envoi d'e-mails de façon à collecter les métriques en fonction de vos valeurs d'en-tête. Si vous utilisez vos propres en-têtes de message MIME pour la publication d'événements Amazon SES, les noms et les valeurs d'en-tête que vous utilisez pour la publication d'événements Amazon SES peuvent uniquement inclure les lettres A à Z, les nombres 0 à 9, les traits de soulignement (\$1), les arobas (@), les traits d'union (-) et les points (.). Si vous spécifiez un nom ou une valeur contenant d'autres caractères, l'appel d'envoi d'e-mail réussira toujours, mais les statistiques de l'événement ne seront pas envoyées à Amazon CloudWatch.
Pour plus d'informations sur CloudWatch les concepts, consultez [Amazon CloudWatch Concepts](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html) dans le *guide de CloudWatch l'utilisateur Amazon*.
# Configurer une destination d'événements Data Firehose pour la publication d'événements Amazon SES
Une destination d'événement Amazon Data Firehose représente une entité qui publie des événements spécifiques d'envoi d'e-mails Amazon SES vers Firehose. Comme la destination d'un événement Firehose ne peut être configurée que dans un ensemble de configuration, vous devez d'abord [créer un ensemble de configuration](event-publishing-create-configuration-set.md). Ensuite, vous ajoutez la destination de l'événement au jeu de configuration.
La procédure décrite dans cette section explique comment ajouter les détails de la destination des événements Firehose à un ensemble de configuration et suppose que vous avez effectué les étapes 1 à 6 dans. [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add)
Vous pouvez également utiliser l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)opération dans la destination Amazon SES API V2 pour créer et mettre à jour des destinations d'événements.
**Pour ajouter les détails de la destination des événements Firehose à un ensemble de configuration à l'aide de la console**
1. Voici les instructions détaillées pour sélectionner Firehose comme type de destination de votre événement à l'[étape 7](event-destinations-manage.md#specify-event-dest-step) et en supposant que vous avez effectué toutes les étapes précédentes. [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add) Après avoir sélectionné le **type de destination** Firehose, saisi un **nom** de destination et activé la **publication d'événements**, le volet du **flux de diffusion Amazon Data Firehose** s'affiche. Ses champs sont traités dans les étapes suivantes.
1. Pour le **flux de diffusion**, choisissez un flux de diffusion Firehose existant ou choisissez **Create new stream pour en créer** un nouveau à l'aide de la console Firehose.
Pour plus d'informations sur la création d'un flux à l'aide de la console Firehose, consultez la section [Création d'un flux de diffusion Amazon Kinesis Firehose dans le manuel Amazon Data Firehose](https://docs.aws.amazon.com/firehose/latest/dev/basic-create.html) *Developer Guide*.
1. Pour le rôle **Identity and Access Management (IAM), choisissez un rôle** IAM pour lequel Amazon SES est autorisé à publier sur Firehose en votre nom. Vous pouvez choisir un rôle existant, demander à Amazon SES de créer un rôle à votre place ou créer votre propre rôle.
Si vous choisissez un rôle existant ou si vous créez votre propre rôle, vous devez modifier manuellement les politiques du rôle pour autoriser le rôle à accéder au flux de diffusion Firehose et pour autoriser Amazon SES à assumer ce rôle. Pour obtenir des exemples de politiques, consultez [Autoriser Amazon SES à publier sur votre flux de diffusion Firehose](#event-publishing-add-event-destination-firehose-role).
1. Choisissez **Next (Suivant)**.
1. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez **Add destination (Ajouter une destination)**.
Pour plus d'informations sur l'utilisation de l'`UpdateConfigurationSetEventDestination`API pour ajouter une destination d'événement Firehose, consultez le manuel [Amazon Simple Email Service API](https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetEventDestination.html) Reference.
## Autoriser Amazon SES à publier sur votre flux de diffusion Firehose
Pour permettre à Amazon SES de publier des enregistrements dans votre flux de diffusion Firehose, vous devez utiliser un [rôle Gestion des identités et des accès AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) (IAM) et associer ou modifier la politique d'autorisation et la politique de confiance du rôle. La politique d'autorisations permet au rôle de publier des enregistrements sur votre flux de diffusion Firehose, et la politique de confiance permet à Amazon SES d'assumer ce rôle.
Cette section fournit des exemples des deux stratégies. Pour obtenir des informations sur l'attachement de stratégies à des rôles IAM, consultez [Modification d'un rôle](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_modify.html) dans le *Guide de l'utilisateur IAM*.
### stratégie d'autorisations
La politique d'autorisation suivante permet au rôle de publier des enregistrements de données dans votre flux de diffusion Firehose.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Action": [
"firehose:PutRecordBatch"
],
"Resource": [
"arn:aws:firehose:us-east-1:111122223333:deliverystream/delivery-stream-name"
]
}
]
}
```
------
Dans l'exemple précédent, apportez les modifications suivantes :
+ *delivery-region*Remplacez-le par la AWS région dans laquelle vous avez créé le flux de diffusion Firehose.
+ Remplacez *111122223333* par votre ID de compte AWS .
+ Remplacez *delivery-stream-name* par le nom du flux de diffusion Firehose.
### Stratégie d’approbation
La stratégie d'approbation suivante permet à Amazon SES d'assumer ce rôle.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:delivery-region:111122223333:configuration-set/configuration-set-name"
}
}
}
]
}
```
------
Dans l'exemple précédent, apportez les modifications suivantes :
+ *delivery-region*Remplacez-le par la AWS région dans laquelle vous avez créé le flux de diffusion Firehose.
+ Remplacez *111122223333* par votre ID de compte AWS .
+ *configuration-set-name*Remplacez-le par le nom de votre ensemble de configuration associé au flux de diffusion Firehose.
# Configurer une EventBridge destination Amazon pour la publication d'événements
Une destination d' EventBridge événement Amazon vous informe des événements d'envoi d'e-mails que vous spécifiez dans un ensemble de configuration. SES génère et envoie les événements d'envoi d'e-mails que vous définissez lors de la création d'une destination d'événement au bus d'événements EventBridge par défaut. Un [bus d'événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html) est un routeur qui reçoit des événements et peut les transmettre à plusieurs destinations. Vous pouvez en savoir plus sur l'intégration des événements d'envoi d'e-mails EventBridge à Amazon dans[Surveillance des événements SES à l'aide d'Amazon EventBridge](monitoring-eventbridge.md). Comme une destination d' EventBridgeévénement ne peut être configurée que dans un ensemble de configuration, vous devez [créer un ensemble de configuration](event-publishing-create-configuration-set.md) avant d'ajouter la destination de l'événement au jeu de configuration.
La procédure décrite dans cette section explique comment ajouter les détails de la destination d'un EventBridge événement à un ensemble de configuration et suppose que vous avez effectué les étapes 1 à 6 dans[Création d'une destination d'événement](event-destinations-manage.md#event-destination-add).
Vous pouvez également utiliser l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)opération dans l'API Amazon SES V2 pour créer et modifier les destinations des événements.
**Pour ajouter les détails de la destination de l' EventBridge événement à un ensemble de configuration à l'aide de la console**
1. Voici les instructions détaillées pour sélectionner le type EventBridge de destination de votre événement à l'[étape 7](event-destinations-manage.md#specify-event-dest-step) et en supposant que vous avez effectué toutes les étapes précédentes[Création d'une destination d'événement](event-destinations-manage.md#event-destination-add). Après avoir sélectionné le **type de EventBridge destination** *Amazon*, saisi un **nom** de destination et activé la **publication d'événements**, un volet d'information sur le **bus d' EventBridge événements Amazon** s'affiche.
1. Choisissez **Suivant**.
1. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez **Add destination (Ajouter une destination)**. La page de résumé de la destination de l'événement s'ouvrira et une bannière de réussite confirmera que la destination de l'événement a été créée ou modifiée avec succès.
# Configuration d'une destination d'événement Amazon Pinpoint pour la publication d'événements
La destination d'un événement Amazon Pinpoint vous informe des événements d'envoi d'e-mails que vous spécifiez dans un ensemble de configuration. Comme la destination d'un événement Amazon Pinpoint ne peut être configurée que dans un ensemble de configuration, vous devez [créer un ensemble de configuration](event-publishing-create-configuration-set.md) avant d'ajouter la destination de l'événement au jeu de configuration.
La procédure de cette section montre comment ajouter les détails de la destination d'événement Amazon Pinpoint à un jeu de configurations et suppose que vous avez effectué les étapes 1 à 6 de la procédure de [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add).
Vous pouvez également utiliser l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)opération dans l'API Amazon SES V2 pour créer et modifier les destinations des événements.
Des frais supplémentaires s'appliquent pour les types de canaux que vous avez configurés dans vos projets Amazon Pinpoint. Pour plus d'informations, veuillez consulter [Tarification d'Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/).
**Pour ajouter les détails d'une destination d'événement Amazon Pinpoint à un jeu de configurations à l'aide de la console**
1. Voici les instructions détaillées pour sélectionner Amazon Pinpoint comme type de destination d'événement à l'[étape 7](event-destinations-manage.md#specify-event-dest-step). Cela suppose que vous avez terminé toutes les étapes précédentes de la procédure de [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add).
**Note**
Amazon Pinpoint ne prend pas en charge les types d'événements **Retards de livraison** ou **Abonnements**.
Après avoir sélectionné le **type de destination** Amazon Pinpoint, saisi un **nom** de destination et activé la **publication d'événements**, le volet des détails du **projet Amazon Pinpoint** s'affiche. Ses champs sont traités dans les étapes suivantes.
1. Pour **Projet**, choisissez un projet Amazon Pinpoint existant ou choisissez **Create a new project in Amazon Pinpoint** (Créer un projet dans Amazon Pinpoint) pour en créer un nouveau.
Pour plus d'informations sur la création d'un projet, consultez [Create a project](https://docs.aws.amazon.com/pinpoint/latest/userguide/gettingstarted-create-project.html) (Création d'un projet) dans le manuel *Amazon Pinpoint User Guide*.
1. Choisissez **Suivant**.
1. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez **Add destination (Ajouter une destination)**. La page de résumé de la destination de l'événement s'ouvrira et une bannière de réussite confirmera que la destination de l'événement a été créée ou modifiée avec succès.
# Configurer une destination d'événement Amazon SNS pour la publication d'événements
La destination d'un événement Amazon SNS vous informe des événements d'envoi d'e-mails que vous spécifiez dans un ensemble de configuration. Comme la destination d'un événement Amazon SNS ne peut être configurée que dans un ensemble de configuration, vous devez [créer un ensemble de configuration](event-publishing-create-configuration-set.md) avant d'ajouter la destination de l'événement au jeu de configuration.
La procédure de cette section montre comment ajouter les détails de la destination des événements Amazon SNS à un jeu de configuration et suppose que vous avez effectué les étapes 1 à 6 dans [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add).
Vous pouvez également utiliser l'[UpdateConfigurationSetEventDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_UpdateConfigurationSetEventDestination.html)opération dans l'API Amazon SES V2 pour créer et modifier les destinations des événements.
**Note**
Les notifications de commentaires concernant les retours à l'expéditeur, les réclamations et les livraisons peuvent également être configurées via Amazon SNS pour n'importe laquelle de vos identités d'expéditeur vérifiées. Pour plus d'informations, consultez [Configuration des notifications Amazon SNS pour Amazon SES](configure-sns-notifications.md).
Il y a des frais supplémentaires pour l'envoi de messages aux points de terminaison abonnés à vos rubriques Amazon SNS. Pour plus d'informations, consultez la [tarification Amazon SNS](https://aws.amazon.com/sns/pricing/).
**Pour ajouter les détails d'une destination Amazon SNS à un jeu de configurations à l'aide de la console**
1. Voici les instructions détaillées pour sélectionner Amazon SNS comme type de destination d'événement dans [Étape 7](event-destinations-manage.md#specify-event-dest-step). Cela suppose que vous avez terminé toutes les étapes précédentes de [Création d'une destination d'événement](event-destinations-manage.md#event-destination-add). Après avoir sélectionné le **type de destination** Amazon SNS, saisi un **nom** de destination et activé la **publication d'événements**, le volet thématique **Amazon Simple Notification Service (SNS) s'**affiche. Ses champs sont traités dans les étapes suivantes.
1. Pour **Topic SNS (Rubrique SNS)**, choisissez une rubrique Amazon SNS existante ou choisissez **Create new topic SNS (Créer une rubrique SNS)** pour en créer une nouvelle.
Pour en savoir plus, consultez [Création d'une rubrique (Create a Topic)](https://docs.aws.amazon.com/sns/latest/dg/CreateTopic.html) dans le *Guide du développeur d'Amazon Simple Notification Service *.
**Important**
Lorsque vous créez votre rubrique à l'aide d'Amazon SNS, pour **Type**, choisissez uniquement **Standard**. (SES ne prend pas en charge les rubriques de type FIFO.)
1. Choisissez **Suivant**.
1. Sur l'écran de révision, si vous êtes satisfait de la façon dont vous avez défini votre destination d'événement, choisissez **Add destination (Ajouter une destination)**. La page de résumé de la destination de l'événement s'ouvrira et une bannière de réussite confirmera que la destination de l'événement a été créée ou modifiée avec succès.
1. Que vous créiez une nouvelle rubrique SNS ou sélectionniez une rubrique existante, vous devez donner un accès à SES pour publier des notifications sur la rubrique. Sur la page récapitulative de la destination de l'événement à partir de l'étape précédente, choisissez **Amazon SNS** à partir de la colonne **Destination type (Type de destination)**, cela vous mènera à la list **Topics (Rubriques)** dans la console Amazon Simple Notification Service, *effectuez les étapes suivantes à partir de la console Amazon SNS :*
1. Sélectionnez le nom de la rubrique SNS que vous avez créée ou modifiée à l'étape précédente.
1. Sur l'écran de détails du sujet, choisissez **Edit (Modifier)**.
1. Pour donner à Amazon SES la permission de publier des notifications sur la rubrique, sur l'écran **Edit topic (Modifier la rubrique)** de la console SNS, développez **Access policy (Stratégie d'accès)** et dans **JSON editor (Éditeur JSON)**, ajoutez la politique d'autorisation suivante :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Id": "notification-policy",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "ses.amazonaws.com"
},
"Action": "sns:Publish",
"Resource": "arn:aws:sns:us-east-1:111122223333:topic_name",
"Condition": {
"StringEquals": {
"AWS:SourceAccount": "111122223333",
"AWS:SourceArn": "arn:aws:ses:topic_region:111122223333:configuration-set/configuration-set-name"
}
}
}
]
}
```
------
Dans l'exemple précédent, apportez les modifications suivantes :
+ *topic\$1region*Remplacez-le par la AWS région dans laquelle vous avez créé le sujet SNS.
+ Remplacez *111122223333* par votre identifiant de AWS compte.
+ *topic\$1name*Remplacez-le par le nom de votre rubrique SNS.
+ *configuration-set-name*Remplacez-le par le nom de votre ensemble de configuration associé à la destination de l'événement SNS.
1. Sélectionnez **Enregistrer les modifications**.
# Étape 3 : Spécifier votre jeu de configuration lorsque vous envoyez un e-mail
Une fois que vous avez [créé un jeu de configurations](event-publishing-create-configuration-set.md) et [ajouté une destination d'événement](event-publishing-add-event-destination.md), la dernière étape de la publication d'événements consiste à envoyer vos e-mails.
Pour publier les événements associés à un e-mail, vous devez indiquer le nom du jeu de configurations à associer à l'e-mail. Vous pouvez éventuellement fournir des balises de message pour classer l'e-mail dans une catégorie.
Vous fournissez ces informations à Amazon SES sous forme de paramètres pour l'API d'envoi d'e-mails, d'en-têtes d'e-mail propres à ou d'en-têtes personnalisés dans votre message MIME. La méthode que vous choisissez dépend de l'interface d'envoi d'e-mails que vous utilisez, comme le montre le tableau suivant.
****
| Interface d'envoi d'e-mails | Méthodes de publication d'événements |
| --- | --- |
| `SendEmail` | Paramètres d'API |
| `SendTemplatedEmail` | Paramètres d'API |
| `SendBulkTemplatedEmail` | Paramètres d'API |
| `SendCustomVerificationEmail` | Paramètres d'API |
| `SendRawEmail` | Paramètres d'API, en-têtes d'e-mail propres à Amazon SES ou en-têtes MIME personnalisés Si vous spécifiez des balises de message en utilisant à la fois des en-têtes de message et des paramètres d'API, Amazon SES utilise uniquement les balises de message fournies par les paramètres d'API. Amazon SES ne joint pas les balises de message spécifiées par les paramètres d'API et les en-têtes. |
| Interface SMTP | En-têtes d'e-mail propres à Amazon SES |
Les sections suivantes expliquent comment spécifier le jeu de configurations et les balises de message à l'aide d'en-têtes et de paramètres d'API.
+ [Utilisation des paramètres d'API Amazon SES](#event-publishing-using-ses-parameters)
+ [Utilisation d'en-têtes d'e-mail propres à Amazon SES](#event-publishing-using-ses-headers)
+ [Utilisation d'en-têtes d'e-mail personnalisés](#event-publishing-using-custom-headers)
**Note**
Vous pouvez éventuellement inclure des balises de message dans les en-têtes de vos e-mails. Les balises de messages peuvent inclure les chiffres de 0 à 9, les lettres A-Z (majuscules et minuscules), des tirets (-) et des traits de soulignement (\$1).
## Utilisation des paramètres d'API Amazon SES
Pour utiliser [SendEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendEmail.html),, [SendTemplatedEmail[SendBulkTemplatedEmail[SendCustomVerificationEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendCustomVerificationEmail.html)](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendBulkTemplatedEmail.html)](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendTemplatedEmail.html), ou [SendRawEmail](https://docs.aws.amazon.com/ses/latest/APIReference/API_SendRawEmail.html)avec la publication d'événements, vous devez spécifier le jeu de configuration et les balises de message en transmettant les structures de données appelées [ConfigurationSet](https://docs.aws.amazon.com/ses/latest/APIReference/API_ConfigurationSet.html)et [MessageTag](https://docs.aws.amazon.com/ses/latest/APIReference/API_MessageTag.html)à l'appel d'API.
Pour en savoir plus sur l'utilisation de l'API Amazon SES, consultez le document [Amazon Simple Email Service API Reference](https://docs.aws.amazon.com/ses/latest/APIReference/).
## Utilisation d'en-têtes d'e-mail propres à Amazon SES
Lorsque vous utilisez `SendRawEmail` ou l'interface SMTP, vous pouvez spécifier le jeu de configurations et les balises de message en ajoutant à l'e-mail des en-têtes propres à Amazon SES. Amazon SES supprime les en-têtes avant d'envoyer l'e-mail. Le tableau suivant présente les noms des en-têtes à utiliser.
| Informations de publication d'événements | En-tête |
| --- | --- |
| Jeu de configurations | `X-SES-CONFIGURATION-SET` |
| Balises de message | `X-SES-MESSAGE-TAGS` |
L'exemple suivant montre l'aspect des têtes dans un e-mail brut que vous envoyez à Amazon SES.
```
1. X-SES-MESSAGE-TAGS: tagName1=tagValue1, tagName2=tagValue2
2. X-SES-CONFIGURATION-SET: myConfigurationSet
3. From: sender@example.com
4. To: recipient@example.com
5. Subject: Subject
6. Content-Type: multipart/alternative;
7. boundary="----=_boundary"
8.
9. ------=_boundary
10. Content-Type: text/plain; charset=UTF-8
11. Content-Transfer-Encoding: 7bit
12.
13. body
14. ------=_boundary
15. Content-Type: text/html; charset=UTF-8
16. Content-Transfer-Encoding: 7bit
17.
18. body
19. ------=_boundary--
```
## Utilisation d'en-têtes d'e-mail personnalisés
Bien que vous soyez tenu de spécifier le nom du jeu de configurations à l'aide de l'en-tête propre à Amazon SES `X-SES-CONFIGURATION-SET`, vous pouvez spécifier les message des balises en utilisant vos propres en-têtes MIME.
**Note**
Les noms et les valeurs d'en-tête que vous utilisez pour la publication d'événements Amazon SES doivent être en ASCII. Si vous spécifiez un nom ou une valeur d'en-tête non ASCII pour la publication d'événements Amazon SES, l'appel d'envoi d'e-mail réussira toujours, mais les statistiques de l'événement ne seront pas transmises à Amazon. CloudWatch