Gestion des ensembles de configuration dans Amazon SES - Amazon Simple Email Service

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.

Gestion des ensembles de configuration dans Amazon SES

Après avoir créé un ensemble de configuration, vous pouvez le gérer à l'aide des options d'affichage, de modification et de suppression à l'aide de la SES console, d'Amazon SES API v2 et d'Amazon SES CLI v2. Les jeux de configurations peuvent également être affectés à une identité vérifiée en tant que jeu de configurations par défaut appliqué chaque fois qu'un e-mail est envoyé à partir de cette identité.

Afficher, modifier et supprimer le jeu de configurations (console)

Accédez à la page détaillée d'un jeu de configurations existant
  1. Connectez-vous à la SES console Amazon AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/ses/.

  2. Dans le panneau de navigation, sous Configuration, choisissez Configuration sets (Jeux de configurations).

  3. Pour afficher les détails d'un jeu de configuration, choisissez son Name (Nom) dans la liste du jeu de configuration. Vous accédez alors à la page des détails.

La page de description des jeux de configurations comporte deux onglets pour les détails du jeu de configuration, avec des panneaux dans chaque onglet où vous pouvez afficher, modifier ou supprimer de la manière suivante :

  • Onglet Overview (Présentation)
    • General details (Renseignements généraux) — Ce panneau affiche les détails généraux du jeu de configuration :

      • Sending status (État d'envoi) (s'il est activé)

      • Configuration set name (Nom du jeu de configuration)

      • Envoi d'adresses IP

      • Sécurité de la couche de transport (TLS)

      • Custom redirect domain (Domaine de redirection personnalisé)

    • Reputation options (Options de réputation) — Ce panneau affiche les détails relatifs à votre réputation d'envoi :

      • Reputation metrics (Métriques de réputation) (indique si vous effectuez le suivi des métriques)

      • Last fresh start (Dernier nouveau départ) (la date et l'heure à laquelle les métriques de réputation pour le jeu de configurations ont été réinitialisées pour la dernière fois)

    • Suppression list options (Options de liste de suppression) : ce volet indique si vous remplacez la liste de suppression au niveau du compte par le jeu de configurations et, si c'est le cas, les détails de ce remplacement :

      • Suppression list settings (Paramètres de la liste de suppression) (indique le remplacement des paramètres au niveau du compte ; dans le cas contraire, il s'agit du seul élément affiché dans le volet)

      • Suppression list (Liste de suppression) (indique comment vous remplacez vos paramètres de compte, que la liste de suppression soit activée ou non)

      • Suppression reasons (Motifs de suppression) (indique si les retours à l'expéditeur et/ou les réclamations sont à l'origine de l'ajout des adresses e-mail des destinataires à votre liste de suppression)

    • Virtual Deliverability Manager options (Options de Virtual Deliverability Manager) : ce volet indique si vous remplacez vos paramètres de compte Virtual Deliverability Manager pour le suivi de l'engagement et la livraison partagée optimisée par le jeu de configurations et, si c'est le cas, les détails du remplacement :

      • Engagement tracking (Suivi de l'engagement) (indique si le suivi de l'engagement est activé ou non)

      • Optimized shared delivery (Livraison partagée optimisée) (indique si la livraison partagée optimisée est activée ou non)

    • Tags (Balises) – Ce panneau affiche toutes les balises que vous avez attachées au jeu de configuration.

      • Key (Clé)

      • Value (Valeur)

    Vous pouvez effectuer les actions suivantes à partir des panneaux :

    • Cliquez sur le bouton Edit (Modifier) ou, dans le cas du panneau Tags (Balises), le bouton Manage tags (Gérer les balises) pour modifier les détails respectifs de chaque panneau.

    • Pour en savoir plus sur les champs, consultez la section connexe dans le document étapes Créer un jeu de configurations (console).

    Astuce

    N'oubliez pas de faire une sauvegarde des modifications lorsque vous avez terminé. Choisissez Cancel (Annuler) pour revenir à la page de description du jeu de configurations sans enregistrer.

  • Onglet Event destinations (Destinations de l'évènement)
    • Toutes les destinations (count of event destinations)  : ce panneau répertorie toutes les destinations d'événements que vous avez saisies pour votre ensemble de configuration. Pour chaque destination, vous pouvez voir :

      • Name (Nom)

      • Destination (Destination)

      • Event types (Types d'événements

      • Event publishing (Publication d'événement

    Vous pouvez effectuer les actions suivantes à partir de ce panneau :

    • Ajoutez une nouvelle destination d'événement en choisissant le bouton Add destination (Ajouter une destination). Pour en savoir plus sur l'ajout d'une destination d'événement, consultez Création d'une destination d'événement.

    • Modifiez une destination d'événement existante en en sélectionnant le nom pour ouvrir l'écran de modification.

    • Supprime une destination d'événement existante en cochant la case en regard de son nom, puis en choisissant le bouton Delete (Supprimer).

En haut de la page de description de chaque jeu de configuration, et visible à partir de l'onglet Overview (Présentation) ou Events destination (Destination des événements), vous trouverez les options suivantes :

  • Delete (Supprimer) — Ce bouton permet de supprimer votre jeu de configuration.

  • Disable sending (Désactiver l'envoi) — Ce bouton permet d'arrêter d'envoyer des e-mails à partir de votre jeu de configuration.

Faire une liste des jeux de configuration (AWS CLI)

Vous pouvez utiliser la list-configuration-sets commande dans le AWS CLI pour générer une liste de tous les ensembles de configuration associés à votre compte dans la région actuelle, comme suit :

aws sesv2 list-configuration-sets

Obtenez les détails du jeu de configuration (AWS CLI)

Vous pouvez utiliser la get-configuration-set commande dans le pour AWS CLI obtenir des informations détaillées sur un ensemble de configuration spécifique, comme suit :

aws sesv2 get-configuration-set --configuration-set-name name

Suppression d'un jeu de configurations (AWS CLI)

Vous pouvez utiliser la delete-configuration-set commande du AWS CLI pour supprimer un ensemble de configuration spécifique, comme suit :

aws sesv2 delete-configuration-set --configuration-set-name name

Arrêtez l'envoi d'e-mails à partir d'un jeu de configuration (AWS CLI)

Vous pouvez utiliser la put-configuration-set-sending-options commande AWS CLI pour arrêter d'envoyer des e-mails à partir d'un ensemble de configuration spécifique, comme suit :

aws sesv2 put-configuration-set-sending-options --configuration-set-name name --no-sending-enabled

Pour recommencer à envoyer, exécutez la même commande avec l'option --sending-enabled à la place, comme suit :

aws sesv2 put-configuration-set-sending-options --configuration-set-name name --sending-enabled

Comprendre les jeux de configurations par défaut

Le concept d'affectation d'un jeu de configurations par défaut à utiliser par une identité vérifiée est expliqué dans cette section, pour aider à comprendre les avantages et le cas d'utilisation.

Un jeu de configurations par défaut applique automatiquement ses règles à tous les messages que vous envoyez à partir de l'identité d'adresse e-mail associée à ce jeu de configuration. Vous pouvez appliquer des jeux de configurations par défaut à la fois à l'adresse e-mail et aux identités de domaine pendant la création de l'identité ou a posteriori en tant que fonction de modification d'une identité existante.

Considérations relatives aux jeux de configurations par défaut

  • Les jeux de configurations doivent d'abord être créés avant d'être associés à une identité.

  • Les jeux de configurations par défaut ne seront appliqués que si l'identité est vérifiée.

  • Une identité d'adresse e-mail ne peut être associée qu'à un seul jeu de configurations à la fois. Toutefois, vous pouvez appliquer le même jeu de configurations à plusieurs identités.

  • Une configuration par défaut définie au niveau de l'adresse e-mail remplace une configuration par défaut définie au niveau du domaine. Par exemple, un jeu de configurations par défaut associé à joe@exemple.com remplace le jeu de configurations pour le domaine exemple.com.

  • Une configuration par défaut définie au niveau du domaine s'applique à toutes les adresses e-mail de ce domaine (sauf si vous vérifiez des adresses spécifiques pour le domaine).

  • Si vous supprimez un ensemble de configuration désigné comme étant le jeu de configuration par défaut pour une identité, puis que vous tentez d'envoyer un e-mail via cette identité, votre appel à Amazon SES échoue avec une erreur de « mauvaise demande ».

  • Il n'est pas possible d'affecter un jeu de configurations par défaut à une identité vérifiée utilisée par un expéditeur délégué.

  • La façon de spécifier un jeu de configurations existant à utiliser comme jeu de configurations par défaut de l'identité est en fait une fonction des identités vérifiées. Les instructions sont donc données dans les flux de travail de l'identité en conséquence :

Note

Si les métriques de réputation sont activées dans le jeu de configuration que vous attribuez par défaut, des frais supplémentaires seront facturés pour tout courrier envoyé à l'aide du jeu de configuration par défaut, voir Prix par métrique pour CloudWatch.