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

Outre la création de modèles d'e-mails, vous pouvez également utiliser Amazon SES API 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 SES modèles Amazon.

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 cette ListTemplatesopération sur Amazon SES API 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 ses list-templates

    S'il existe des modèles d'e-mail dans votre SES compte Amazon 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 cette GetTemplateopération dans Amazon SES API 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 ses get-template --template-name MyTemplate

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

    Si le nom du modèle que vous avez fourni correspond à un modèle existant dans votre SES compte Amazon, 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 SES compte Amazon, la commande renvoie une TemplateDoesNotExist erreur.

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

Vous pouvez utiliser l'DeleteTemplateopération dans Amazon SES API 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 ses delete-template --template-name MyTemplate

    Dans la commande précédente, remplacez MyTemplate avec 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 cette UpdateTemplateopération dans Amazon SES API 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 GetTemplate pour récupérer le modèle existant en entrant la commande suivante sur la ligne de commande :

    aws ses get-template --template-name MyTemplate

    Dans la commande précédente, remplacez MyTemplate avec 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 SES compte Amazon, 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 ses update-template --cli-input-json file://path/to/update_template.json

    Dans la commande précédente, remplacez path/to/update_template.json avec 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 GetTemplateopé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.