Conditions préalables Ajouter une adresse Vérifier une adresse Supprimer une adresse Adresses de la liste Entrées de suppression automatique

Gestion des entrées de la liste de suppression des locataires

Vous gérez les entrées sur la liste de suppression d'un locataire en utilisant les mêmes opérations d'API Amazon Simple Email Service (SES) que celles que vous utilisez pour la liste de suppression au niveau du compte. Pour cibler la liste d'un locataire spécifique, incluez le --tenant-name paramètre dans chaque demande. Lorsque vous omettez ce paramètre, les opérations ciblent la liste au niveau du compte. Utilisez le AWS CLI pour ajouter, vérifier, supprimer et répertorier les adresses supprimées pour un locataire spécifique.

Important

Les adresses e-mail figurant sur la liste de suppression sont conservées en majuscules et minuscules. Alors que la fonctionnalité d'envoi d'e-mails traite les adresses présentant des cas différents comme identiques, les appels d'API pour la gestion des listes de suppression nécessitent une correspondance exacte entre les cas. Assurez-vous d'utiliser la majuscule exacte de l'adresse e-mail telle qu'elle apparaît dans la liste de suppression lorsque vous ajoutez, vérifiez ou supprimez des entrées.

Conditions préalables

Avant de gérer les entrées de la liste de suppression de locataires, assurez-vous que vous répondez aux exigences suivantes :

Tenant-level la suppression est activée pour le locataire. Pour de plus amples informations, veuillez consulter Configuration de la suppression au niveau du locataire.
AWS CLI la version 2 est installée et configurée avec les autorisations appropriées. Pour plus d’informations, consultez le Guide de l’utilisateur AWS Command Line Interface.
Le locataire existe dans votre compte SES.

Ajouter une adresse à la liste de suppression d'un locataire

Utilisez l'opération PutSuppressedDestination API avec le --tenant-name paramètre pour ajouter une adresse e-mail à la liste de suppression d'un locataire.

Pour ajouter une adresse à la liste de suppression d'un locataire à l'aide du AWS CLI

Sur la ligne de commande, entrez la commande suivante :
Linux, macOS, or Unix
```
aws sesv2 put-suppressed-destination \
--email-address recipient@example.com \
--reason BOUNCE \
--tenant-name MyTenant
```
Windows
```
aws sesv2 put-suppressed-destination `
--email-address recipient@example.com `
--reason BOUNCE `
--tenant-name MyTenant
```
Dans l'exemple précédent, remplacez recipient@example.com par l'adresse e-mail à ajouter, BOUNCE par le motif de suppression (les valeurs acceptables sont BOUNCE etCOMPLAINT) et MyTenant par le nom de votre locataire.

La commande ne produit aucun résultat en cas de succès (HTTP 200). L'adresse figure désormais sur la liste de suppression du locataire.

Note

Le --reason paramètre accepte BOUNCE ouCOMPLAINT. Vous pouvez ajouter la même adresse pour différentes raisons.

Vérifier si une adresse figure sur la liste de suppression d'un locataire

Utilisez l'opération GetSuppressedDestination API avec le --tenant-name paramètre pour vérifier si une adresse e-mail figure sur la liste de suppression d'un locataire.

Pour vérifier si une adresse figure sur la liste de suppression d'un locataire à l'aide du AWS CLI

Sur la ligne de commande, entrez la commande suivante :
Linux, macOS, or Unix
```
aws sesv2 get-suppressed-destination \
--email-address recipient@example.com \
--tenant-name MyTenant
```
Windows
```
aws sesv2 get-suppressed-destination `
--email-address recipient@example.com `
--tenant-name MyTenant
```
Dans l'exemple précédent, remplacez recipient@example.com par l'adresse e-mail à vérifier et MyTenant par le nom de votre locataire.

Si l'adresse figure sur la liste de suppression du locataire, la commande renvoie un résultat semblable à l'exemple suivant :


{
    "SuppressedDestination": {
        "EmailAddress": "recipient@example.com",
        "Reason": "BOUNCE",
        "LastUpdateTime": "2026-03-15T10:30:00.000Z",
        "Attributes": {
            "MessageId": "0100018e1234abcd-12345678-abcd-1234-abcd-123456789012-000000",
            "FeedbackId": "0100018e1234abce-12345678-abcd-1234-abcd-123456789012-000000"
        }
    }
}

La réponse inclut les champs suivants :

EmailAddress— L'adresse e-mail supprimée.
Reason— Pourquoi l'adresse a été supprimée (BOUNCEouCOMPLAINT).
LastUpdateTime— Date de dernière mise à jour de l'entrée.
Attributes— Contient MessageId et FeedbackId provient de l'événement à l'origine de la suppression. Ces champs sont présents pour les adresses supprimées automatiquement et absents pour les entrées ajoutées manuellement.

Note

Si l'adresse ne figure pas sur la liste de suppression du locataire, l'API renvoie unNotFoundException.

Supprimer une adresse de la liste de suppression d'un locataire

Utilisez l'opération DeleteSuppressedDestination API avec le --tenant-name paramètre pour supprimer une adresse e-mail de la liste de suppression d'un locataire.

Pour supprimer une adresse de la liste de suppression d'un locataire à l'aide du AWS CLI

Sur la ligne de commande, entrez la commande suivante :
Linux, macOS, or Unix
```
aws sesv2 delete-suppressed-destination \
--email-address recipient@example.com \
--tenant-name MyTenant
```
Windows
```
aws sesv2 delete-suppressed-destination `
--email-address recipient@example.com `
--tenant-name MyTenant
```
Dans l'exemple précédent, remplacez recipient@example.com par l'adresse e-mail à supprimer et MyTenant par le nom de votre locataire.

La commande ne produit aucun résultat en cas de succès (HTTP 200). L'adresse est supprimée de la liste de suppression du locataire.

Important

La suppression d'une adresse de la liste de suppression d'un locataire ne la supprime pas de la liste de suppression globale ou de la liste de suppression au niveau du compte. Chaque liste est gérée de manière indépendante.

Inscrire des adresses sur la liste de suppression d'un locataire

Utilisez l'opération ListSuppressedDestinations API avec le --tenant-name paramètre pour récupérer toutes les adresses supprimées pour un locataire spécifique.

Pour répertorier toutes les adresses figurant sur la liste de suppression d'un locataire à l'aide du AWS CLI

Sur la ligne de commande, entrez la commande suivante :
Linux, macOS, or Unix
```
aws sesv2 list-suppressed-destinations \
--tenant-name MyTenant
```
Windows
```
aws sesv2 list-suppressed-destinations `
--tenant-name MyTenant
```
Dans l'exemple précédent, remplacez MyTenant par le nom de votre locataire.

L'exemple de sortie suivant montre deux adresses supprimées :


{
    "SuppressedDestinationSummaries": [
        {
            "EmailAddress": "bounce@example.com",
            "Reason": "BOUNCE",
            "LastUpdateTime": "2026-03-10T08:15:00.000Z"
        },
        {
            "EmailAddress": "complaint@example.com",
            "Reason": "COMPLAINT",
            "LastUpdateTime": "2026-03-12T14:30:00.000Z"
        }
    ]
}

Filtrer les résultats

Vous pouvez filtrer les résultats par raison, par plage de dates ou par les deux.

La commande suivante filtre par raison :

La commande suivante filtre par plage de dates :

Si la réponse inclut une NextToken valeur, utilisez-la dans une demande ultérieure pour obtenir d'autres résultats. Utilisez le --page-size paramètre pour contrôler le nombre de résultats par page.

Note

L'opération de liste renvoie uniquement des informations récapitulatives. Pour obtenir tous les détailsAttributes, y compris, utilisez GetSuppressedDestination les adresses individuelles.

Entrées de suppression automatique

SES gère automatiquement les entrées de suppression en fonction de la configuration de suppression du locataire. Vous n'avez aucune action à effectuer pour les saisies automatiques. Ils apparaissent dans la liste de suppression du locataire à côté des entrées ajoutées manuellement.

SES ajoute automatiquement des entrées dans les cas suivants :

Un rebond dur se produit si la suppression du rebond est activée pour le locataire.
Une plainte est reçue si la suppression de la plainte est activée pour le locataire.

SES supprime automatiquement les entrées dans les cas suivants :

Un rapport de non-spam est reçu pour une adresse dont la plainte a été supprimée.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Configuration de la suppression au niveau du locataire

Utilisation de la de suppression au niveau du jeu de configurations