View a markdown version of this page

Gestion des modèles d'e-mail - Amazon Simple Email Service
Affichage d'une liste de modèles d'e-mailAffichage du contenu d'un modèle d'e-mail spécifiqueSuppression d'un modèle d'e-mailMise à jour d'un modèle d'e-mail

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 modèles d'e-mail

Outre la création de modèles d'e-mail, vous pouvez également utiliser l'API Amazon SES v2 pour mettre à jour ou supprimer des modèles existants, pour répertorier tous vos modèles existants ou pour afficher le contenu d'un modèle.

Cette section contient les procédures d'utilisation du AWS CLI pour effectuer des tâches liées aux modèles SES.

Note

Les procédures de cette section supposent aussi que vous avez déjà installé et configuré l' AWS CLI. Pour plus d'informations sur l'installation et la configuration du AWS CLI, consultez le guide de AWS Command Line Interface l'utilisateur.

Affichage d'une liste de modèles d'e-mail

Vous pouvez utiliser le fonctionnement de l'API ListEmailTemplateSES v2 pour afficher la liste de tous vos modèles d'e-mails existants.

Pour afficher une liste de modèles d'e-mail

  • Sur la ligne de commande, entrez la commande suivante :

    aws sesv2 list-email-templates

    S'il existe des modèles d'e-mail dans votre compte SES dans la région actuelle, cette commande renvoie une réponse semblable à l'exemple suivant :

    {
    "TemplatesMetadata": [
        {
            "Name": "SpecialOffers",
            "CreatedTimestamp": "2020-08-05T16:04:12.640Z"
        },
        {
            "Name": "NewsAndUpdates",
            "CreatedTimestamp": "2019-10-03T20:03:34.574Z"
        }
    ]
}

    Si vous n'avez pas créé de modèles, la commande renvoie un objet TemplatesMetadata sans membre.

Affichage du contenu d'un modèle d'e-mail spécifique

Vous pouvez utiliser l'opération API GetEmailTemplateSES v2 pour afficher le contenu d'un modèle d'e-mail spécifique.

Pour afficher le contenu d'un modèle d'e-mail

  • Sur la ligne de commande, entrez la commande suivante :

    aws sesv2 get-email-template --template-name MyTemplate

    Dans la commande précédente, remplacez MyTemplate par le nom du modèle que vous souhaitez afficher.

    Si le nom du modèle que vous avez fourni correspond à un modèle existant dans votre compte SES, cette commande renvoie une réponse semblable à l'exemple suivant :

    {
    "Template": {
        "TemplateName": "TestMessage",
        "SubjectPart": "Amazon SES Test Message",
        "TextPart": "Hello! This is the text part of the message.",
        "HtmlPart": "<html>\n<body>\n<h2>Hello!</h2>\n<p>This is the HTML part of the message.</p></body>\n</html>"
    }
}

    Si le nom du modèle que vous avez fourni ne correspond pas à un modèle existant dans votre compte SES, la commande renvoie une NotFoundException erreur.

Suppression d'un modèle d'e-mail

Vous pouvez utiliser l'opération API DeleteEmailTemplateSES v2 pour supprimer un modèle d'e-mail spécifique.

Pour supprimer un modèle d'e-mail

  • Sur la ligne de commande, entrez la commande suivante :

    aws sesv2 delete-email-template --template-name MyTemplate

    Dans la commande précédente, remplacez MyTemplate par le nom du modèle que vous souhaitez supprimer.

    Cette commande ne fournit aucune sortie. Vous pouvez vérifier que le modèle a été supprimé à l'aide de cette GetTemplateopération.

Mise à jour d'un modèle d'e-mail

Vous pouvez utiliser l'opération API UpdateEmailTemplateSES v2 pour mettre à jour un modèle d'e-mail existant. Par exemple, cette opération est utile si vous souhaitez modifier la ligne d'objet du modèle d'e-mail ou si vous devez modifier le corps du message lui-même.

Pour mettre à jour un modèle d'e-mail

  1. Utilisez la commande GetEmailTemplate pour récupérer le modèle existant en entrant la commande suivante sur la ligne de commande :

    aws sesv2 get-email-template --template-name MyTemplate

    Dans la commande précédente, remplacez MyTemplate par le nom du modèle que vous souhaitez mettre à jour.

    Si le nom du modèle que vous avez fourni correspond à un modèle existant dans votre compte SES, cette commande renvoie une réponse semblable à l'exemple suivant :

    {
    "Template": {
        "TemplateName": "TestMessage",
        "SubjectPart": "Amazon SES Test Message",
        "TextPart": "Hello! This is the text part of the message.",
        "HtmlPart": "<html>\n<body>\n<h2>Hello!</h2>\n<p>This is the HTML part of the message.</p></body>\n</html>"
    }
}

  2. Dans un éditeur de texte, créez un fichier. Collez la sortie de la commande précédente dans le fichier.

  3. Modifiez le modèle selon les besoins. Toutes les lignes que vous omettez sont supprimées du modèle. Par exemple, si vous souhaitez uniquement modifier le SubjectPart du modèle, vous devez toujours inclure les propriétés TextPart et HtmlPart.

    Lorsque vous avez terminé, enregistrez le fichier sous update_template.json.

  4. Sur la ligne de commande, entrez la commande suivante :

    aws sesv2 update-email-template --cli-input-json file://path/to/update_template.json

    Dans la commande précédente, remplacez path/to/update_template.json par le chemin du update_template.json fichier que vous avez créé à l'étape précédente.

    Si le modèle est mis à jour avec succès, cette commande ne fournit aucune sortie. Vous pouvez vérifier que le modèle a été mis à jour en utilisant cette GetEmailTemplateopération.

    Si le modèle que vous avez spécifié n'existe pas, cette commande renvoie une erreur TemplateDoesNotExist. Si le modèle ne contient pas la propriété TextPart ou HtmlPart (ou les deux), cette commande renvoie une erreur InvalidParameterValue.