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.
# Interruption automatique d'envoi d'e-mails pour un ensemble de configurations
Vous pouvez configurer Amazon SES pour exporter des indicateurs de réputation spécifiques aux e-mails envoyés à l'aide d'une configuration spécifique définie à Amazon CloudWatch. Vous pouvez ensuite utiliser ces métriques pour créer des CloudWatch alarmes spécifiques à ces ensembles de configuration. Lorsque ces alarmes dépassent un certain seuil, vous pouvez automatiquement interrompre l'envoi d'e-mails qui utilisent les jeux de configurations spécifiés, sans aucune répercussion sur les capacités globales d'envoi d'e-mails de votre compte Amazon SES.
**Note**
La solution décrite dans cette section interrompt l'envoi d'e-mails pour une configuration spécifique définie dans une seule AWS région. Si vous envoyez un e-mail à partir de plusieurs régions, répétez les procédures de cette section pour chaque région dans laquelle vous souhaitez mettre en œuvre cette solution.
**Topics**
+ [1ère partie : Activation de la génération de rapports de métriques de réputation pour l'ensemble de configurations](#monitoring-sender-reputation-pausing-configuration-set-part-1)
+ [2e partie : Création d'un rôle IAM](#monitoring-sender-reputation-pausing-configuration-set-part-2)
+ [3e partie : Création de la fonction Lambda](#monitoring-sender-reputation-pausing-configuration-set-part-3)
+ [4e partie : Réactivation de l'envoi d'e-mails pour l'ensemble de configurations](#monitoring-sender-reputation-pausing-configuration-set-part-4)
+ [5e partie : Créer une rubrique Amazon SNS](#monitoring-sender-reputation-pausing-configuration-set-part-5)
+ [Partie 6 : Création d'une CloudWatch alarme](#monitoring-sender-reputation-pausing-configuration-set-part-6)
+ [7e partie : Test de la solution](#monitoring-sender-reputation-pausing-configuration-set-part-7)
## 1ère partie : Activation de la génération de rapports de métriques de réputation pour l'ensemble de configurations
Avant de pouvoir configurer l'interruption automatique de l'envoi d'e-mails pour un jeu de configurations dans Amazon SES, vous devez d'abord activer l'exportation des métriques de réputation pour le jeu de configurations.
Pour activer l'exportation de métriques de retour à l'expéditeur et de réclamation pour l'ensemble de configurations, complétez les étapes détaillées dans [Affichage et exportation des métriques de réputation](configuration-sets-export-metrics.md).
## 2e partie : Création d'un rôle IAM
La première étape de la procédure de configuration de l'interruption automatique de l'envoi d'e-mails consiste à créer un rôle IAM capable de créer l'opération d'API `UpdateConfigurationSetSendingEnabled`.
**Pour créer le rôle IAM**
1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Dans le panneau de navigation, choisissez **Rôles**.
1. Sélectionnez **Create role** (Créer un rôle).
1. Sous **Select type of trusted entity** (Sélectionner le type d'entité approuvée), choisissez ** service AWS **.
1. Sous **Choose the service that will use this role (Choisir le service qui utilisera ce rôle)**, choisissez **Lambda**. Sélectionnez **Next: Permissions (Étape suivante : autorisations)**.
1. Sur la page **Attach permissions policies (Attacher les stratégies d'autorisations)**, choisissez les stratégies suivantes :
+ **AWS Lambda BasicExecutionRole**
+ **Amazon SESFull Access** (nous vous recommandons d'utiliser un rôle personnalisé adapté à vos besoins, qui inclut les autorisations d'appel [https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetSendingEnabled.html](https://docs.aws.amazon.com/ses/latest/APIReference/API_UpdateConfigurationSetSendingEnabled.html).)
**Astuce**
Pour accéder rapidement à ces stratégies, servez-vous de la zone de recherche située en haut de la liste des stratégies.
Choisissez **Suivant : Vérification**.
1. Sur la page **Review (Vérifier)**, dans **Name (Nom)**, attribuez un nom au rôle. Sélectionnez **Create role (Créer un rôle)**.
## 3e partie : Création de la fonction Lambda
Une fois que vous avez créé un rôle IAM, vous pouvez créer la fonction Lambda qui interrompt l'envoi d'e-mails pour le jeu de configurations.
**Pour créer la fonction Lambda**
1. Ouvrez la AWS Lambda console à l'adresse [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).
1. Utilisez le sélecteur de région pour choisir la région dans laquelle vous souhaitez déployer la fonction Lambda.
**Note**
Cette fonction interrompt l'envoi d'e-mails uniquement pour les jeux de configurations de la région AWS sélectionnée au cours de cette étape. Si vous envoyez un e-mail à partir de plusieurs régions, répétez les procédures de cette section pour chaque région dans laquelle vous souhaitez interrompre automatiquement l'envoi d'e-mails.
1. Sélectionnez **Create function (Créer une fonction)**.
1. Sous **Create function (Créer une fonction)**, choisissez **Author from scratch (Créer de bout en bout)**.
1. Sous **Author from scratch (Créer de bout en bout)**, procédez comme suit :
+ Pour **Name (Nom)**, attribuez un nom à la fonction Lambda.
+ Pour **Runtime** (Exécution), choisissez **Node.js 14** (ou la version actuellement proposée dans la liste de sélection).
+ Pour **Role** (Rôle), choisissez **Choose an existing role** (Sélectionner un rôle existant).
+ Pour **Existing role (Rôle existant)**, choisissez le rôle IAM que vous avez créé dans [2e partie : Création d'un rôle IAM](#monitoring-sender-reputation-pausing-configuration-set-part-2).
Sélectionnez **Create function (Créer une fonction)**.
1. Sous **Function code (Code de fonction)**, dans l'éditeur de code, collez le code suivant :
```
'use strict';
import {
SES
}
from 'aws-sdk';
const ses = new SES();
const configSet = 'CONFIG_SET_NAME_HERE';
const params = {
ConfigurationSetName: configSet,
Enabled: false
};
export const handler = async (event) => {
try {
const data = await ses.updateConfigurationSetSendingEnabled(params).promise();
console.log('Configuration Set Update:', data);
return {
statusCode: 200,
body: JSON.stringify({
message: 'Successfully paused email sending for configuration set.',
data
}),
};
}
catch (err) {
console.error('Error:', err.message);
return {
statusCode: 500,
body: JSON.stringify({
message: 'Failed to pause email sending for configuration set.',
error: err.message
}),
};
}
};
```
Remplacez *ConfigSet* le code précédent par le nom du jeu de configuration. Choisissez **Enregistrer**.
1. Sélectionnez **Test (Tester)**. Si la fenêtre **Configure test event (Configurer un événement de test)** s'affiche, entrez un nom dans le champ **Event name (Nom d'événement)**, puis choisissez **Create (Créer)**.
1. Vérifiez que la barre de notifications située en haut de la page indique bien `Execution result: succeeded`. Si la fonction n'a pas pu s'exécuter, procédez comme suit :
+ Vérifiez que le rôle IAM que vous avez créé dans la [2e partie : Création d'un rôle IAM](#monitoring-sender-reputation-pausing-configuration-set-part-2) contient les stratégies appropriées.
+ Vérifiez que le code de la fonction Lambda ne comporte pas d'erreurs. L'éditeur de code Lambda met automatiquement en surbrillance les erreurs de syntaxe et d'autres problèmes potentiels.
## 4e partie : Réactivation de l'envoi d'e-mails pour l'ensemble de configurations
Le test de la fonction Lambda dans la [3e partie : Création de la fonction Lambda](#monitoring-sender-reputation-pausing-configuration-set-part-3) a pour conséquence d'interrompre l'envoi d'e-mails pour le jeu de configurations. Dans la plupart des cas, vous ne souhaitez pas suspendre l'envoi de l'ensemble de configuration tant que l' CloudWatch alarme n'est pas déclenchée.
Les procédures de cette section visent à réactiver l'envoi d'e-mails pour votre ensemble de configurations. Pour effectuer ces procédures, vous devez installer et configurer l' AWS Command Line Interface. Pour plus d’informations, consultez le [Guide de l’utilisateur AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/).
**Pour réactiver l'envoi d'e-mails**
1. Sur la ligne de commande, entrez la commande suivante pour réactiver l'envoi d'e-mails pour l'ensemble de configurations :
```
aws ses update-configuration-set-sending-enabled \
--configuration-set-name ConfigSet \
--enabled
```
Dans la commande précédente, remplacez *ConfigSet* par le nom du jeu de configuration pour lequel vous souhaitez suspendre l'envoi d'e-mails.
1. Sur la ligne de commande, entrez la commande suivante pour vérifier que l'envoi d'e-mails est activé :
```
aws ses describe-configuration-set \
--configuration-set-name ConfigSet \
--configuration-set-attribute-names reputationOptions
```
Cette commande produit un résultat similaire à ce qui suit :
```
{
"ConfigurationSet": {
"Name": "ConfigSet"
},
"ReputationOptions": {
"ReputationMetricsEnabled": true,
"SendingEnabled": true
}
}
```
Si la valeur de `SendingEnabled` est `true`, l'envoi d'e-mails pour l'ensemble de configurations a été correctement réactivé.
## 5e partie : Créer une rubrique Amazon SNS
CloudWatch Pour exécuter la fonction Lambda lorsqu'une alarme est déclenchée, vous devez d'abord créer une rubrique Amazon SNS et y abonner la fonction Lambda.
**Pour créer la rubrique Amazon SNS**
1. [Ouvrez la console Amazon SNS à l'adresse v3/home. https://console.aws.amazon.com/sns/](https://console.aws.amazon.com/sns/v3/home)
1. Utilisez le sélecteur de région pour choisir la région dans laquelle vous souhaitez interrompre automatiquement l'envoi d'e-mails.
1. Dans le panneau de navigation, sélectionnez **Topics (Rubriques)**.
1. Choisissez **Create new topic (Créer une nouvelle rubrique)**.
1. Dans la fenêtre **Create new topic (Créer une nouvelle rubrique)**, dans **Topic name (Nom de rubrique)**, attribuez un nom à la rubrique. Si vous le souhaitez, vous pouvez entrer un nom plus descriptif dans le champ **Display name (Nom d'affichage)**.
Choisissez **Create topic (Créer une rubrique)**.
1. Dans la liste des rubriques, cochez la case en regard de la rubrique que vous avez créée à l'étape précédente. Dans le menu **Actions**, choisissez **Subscribe to topic (S'abonner à la rubrique)**.
1. Dans la fenêtre **Create subscription (Créer un abonnement)**, effectuez les sélections suivantes :
+ Pour **Protocol (Protocole)**, choisissez **AWS Lambda**.
+ Pour **Endpoint (Point de terminaison)**, choisissez la fonction Lambda que vous avez créée dans la [3e partie : Création de la fonction Lambda](#monitoring-sender-reputation-pausing-configuration-set-part-3).
+ Pour **Version or alias (Version ou alias)**, choisissez **default (par défaut)**.
1. Choisissez **Create subscription (Créer un abonnement)**.
## Partie 6 : Création d'une CloudWatch alarme
Cette section contient des procédures permettant de créer une alarme déclenchée lorsqu'une métrique atteint un certain seuil. CloudWatch Lorsqu'elle se déclenche, l'alarme adresse une notification à la rubrique Amazon SNS que vous avez créée dans la [5e partie : Créer une rubrique Amazon SNS](#monitoring-sender-reputation-pausing-configuration-set-part-5), qui exécute alors la fonction Lambda que vous avez créée dans la [3e partie : Création de la fonction Lambda](#monitoring-sender-reputation-pausing-configuration-set-part-3).
**Pour créer une CloudWatch alarme**
1. Ouvrez la CloudWatch console à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Utilisez le sélecteur de région pour choisir la région dans laquelle vous souhaitez interrompre automatiquement l'envoi d'e-mails.
1. Dans le panneau de navigation de gauche, choisissez **Alarms (Alarmes)**.
1. Sélectionnez **Create Alarm (Créer une alarme)**.
1. Dans la fenêtre **Create Alarm (Créer une alarme)**, sous **SES Metrics (Métriques SES)**, choisissez **Configuration Set Metrics (Métriques de l'ensemble de configurations)**.
1. Dans la colonne **ses:configuration-set**, identifiez l'ensemble de configurations pour lequel vous souhaitez créer une alarme. Sous **Metric Name (Nom de la métrique)**, choisissez l'une des options suivantes :
+ **Réputation. BounceRate** — Choisissez cette métrique si vous souhaitez suspendre l'envoi d'e-mails pour le jeu de configuration lorsque le taux de rebond total du jeu de configuration dépasse un seuil que vous définissez.
+ **Réputation. ComplaintRate** — Choisissez cette métrique si vous souhaitez suspendre l'envoi d'e-mails pour l'ensemble de configuration lorsque le taux de plaintes global pour l'ensemble de configuration dépasse un seuil que vous définissez.
Choisissez **Suivant**.
1. Procédez comme suit :
+ Sous **Alarm Threshold (Seuil d'alarme)**, pour **Name (Nom)**, saisissez un nom pour l'alarme.
+ Sous **Whenever : Réputation. BounceRate**ou à **chaque fois : réputation. ComplaintRate**, spécifiez le seuil à partir duquel l'alarme se déclenche.
**Note**
Si le taux global de retours à l'expéditeur pour votre compte Amazon SES dépasse 10 %, ou si le taux global de réclamations pour votre compte Amazon SES dépasse 0,5 %, votre compte Amazon SES est automatiquement placé sous vérification. Lorsque vous spécifiez le taux de rebond ou de plaintes à l'origine du déclenchement de l' CloudWatch alarme, nous vous recommandons d'utiliser des valeurs bien inférieures à ces taux afin d'éviter que votre compte ne soit revu.
+ Sous **Actions**, pour **Whenever this alarm (Chaque fois que cette alarme)**, choisissez **State is ALARM (l'état est ALARME)**. Pour **Send notification to (Envoyer la notification à)**, choisissez la rubrique Amazon SNS que vous avez créée dans la [5e partie : Créer une rubrique Amazon SNS](#monitoring-sender-reputation-pausing-configuration-set-part-5).
Choisissez **Create Alarm (Créer l'alarme)**.
## 7e partie : Test de la solution
Vous pouvez maintenant tester l'alarme afin de vérifier qu'elle exécute la fonction Lambda lorsqu'elle passe à l'état `ALARM`. Vous pouvez utiliser l'`SetAlarmState`opération de l' CloudWatch API pour modifier temporairement l'état de l'alarme.
Bien que les procédures de cette section soient facultatives, nous vous recommandons de les exécuter pour vérifier que l'ensemble de la solution est correctement configurée.
**Pour tester la solution**
1. Sur la ligne de commande, entrez la commande suivante pour vérifier le statut d'envoi d'e-mails pour l'ensemble de configurations :
```
aws ses describe-configuration-set --configuration-set-name ConfigSet
```
Si l'envoi est activé pour l'ensemble de configurations défini, vous voyez la sortie suivante :
```
{
"ConfigurationSet": {
"Name": "ConfigSet"
},
"ReputationOptions": {
"ReputationMetricsEnabled": true,
"SendingEnabled": true
}
}
```
Si la valeur de `SendingEnabled` est `true`, l'envoi d'e-mails pour l'ensemble de configurations est activé.
1. Sur la ligne de commande, entrez la commande suivante afin de changer temporairement l'état de l'alarme en `ALARM` :
```
aws cloudwatch set-alarm-state \
--alarm-name MyAlarm \
--state-value ALARM \
--state-reason "Testing execution of Lambda function"
```
Remplacez *MyAlarm* la commande précédente par le nom de l'alarme que vous avez créée dans[Partie 6 : Création d'une CloudWatch alarme](#monitoring-sender-reputation-pausing-configuration-set-part-6).
**Note**
Lorsque vous exécutez cette commande, le statut de l'alarme passe de `OK` à `ALARM` et de nouveau à `OK` en l'espace de quelques secondes. Vous pouvez consulter ces changements d'état dans l'onglet **Historique de l'**alarme de la CloudWatch console ou en utilisant l'[DescribeAlarmHistory](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_DescribeAlarmHistory.html)opération.
1. Sur la ligne de commande, entrez la commande suivante pour vérifier le statut d'envoi d'e-mails pour l'ensemble de configurations :
```
aws ses describe-configuration-set \
--configuration-set-name ConfigSet
```
Si la fonction Lambda est exécutée avec succès, vous obtiendrez une sortie similaire à l'exemple suivant :
```
{
"ConfigurationSet": {
"Name": "ConfigSet"
},
"ReputationOptions": {
"ReputationMetricsEnabled": true,
"SendingEnabled": false
}
}
```
Si la valeur de `SendingEnabled` est `false`, l'envoi d'e-mails pour le jeu de configurations est désactivé, indiquant que la fonction Lambda a été exécutée avec succès.
1. Suivez les étapes de [4e partie : Réactivation de l'envoi d'e-mails pour l'ensemble de configurations](#monitoring-sender-reputation-pausing-configuration-set-part-4) pour réactiver l'envoi d'e-mails pour l'ensemble de configurations.