As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Além de criar modelos de e-mail, você também pode usar o Amazon SES v2 API para atualizar ou excluir modelos existentes, listar todos os modelos existentes ou visualizar o conteúdo de um modelo.
Esta seção contém procedimentos para usar o AWS CLI para realizar tarefas relacionadas aos SES modelos.
nota
Os procedimentos desta seção também pressupõem que você já instalou e configurou a AWS CLI. Para obter mais informações sobre como instalar e configurar o AWS CLI, consulte o Guia do AWS Command Line Interface usuário.
Visualização de uma lista de modelos de e-mail
Você pode usar a API operação ListEmailTemplate
SESv2 para ver uma lista de todos os seus modelos de e-mail existentes.
Para visualizar uma lista de modelos de e-mail
-
Na linha de comando, insira o seguinte comando:
aws sesv2 list-email-templates
Se houver modelos de e-mail existentes em sua SES conta na região atual, esse comando retornará uma resposta semelhante ao exemplo a seguir:
{ "TemplatesMetadata": [ { "Name": "SpecialOffers", "CreatedTimestamp": "2020-08-05T16:04:12.640Z" }, { "Name": "NewsAndUpdates", "CreatedTimestamp": "2019-10-03T20:03:34.574Z" } ] }
Se você ainda não criou nenhum modelo, o comando retorna um objeto
TemplatesMetadata
sem membros.
Visualização do conteúdo de um modelo de e-mail específico
Você pode usar a API operação GetEmailTemplate
SESv2 para visualizar o conteúdo de um modelo de e-mail específico.
Para visualizar o conteúdo de um modelo de e-mail específico
-
Na linha de comando, insira o seguinte comando:
aws sesv2 get-email-template --template-name
MyTemplate
No comando anterior,
MyTemplate
substitua pelo nome do modelo que você deseja visualizar.Se o nome do modelo que você forneceu corresponder a um modelo existente na sua SES conta, esse comando retornará uma resposta semelhante ao exemplo a seguir:
{ "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>" } }
Se o nome do modelo que você forneceu não corresponder a um modelo existente na sua SES conta, o comando retornará um
NotFoundException
erro.
Exclusão de um modelo de e-mail
Você pode usar a API operação DeleteEmailTemplate
SESv2 para excluir um modelo de e-mail específico.
Para excluir um modelo de e-mail
-
Na linha de comando, insira o seguinte comando:
aws sesv2 delete-email-template --template-name
MyTemplate
No comando anterior,
MyTemplate
substitua pelo nome do modelo que você deseja excluir.Esse comando não fornece nenhuma saída. Você pode verificar se o modelo foi excluído usando a GetTemplateoperação.
Atualização de um modelo de e-mail
Você pode usar a API operação UpdateEmailTemplate
SESv2 para atualizar um modelo de e-mail existente. Por exemplo, essa operação é útil se você quiser alterar a linha de assunto do modelo de email ou se precisar modificar o corpo da mensagem em si.
Para atualizar um modelo de e-mail
-
Use o comando
GetEmailTemplate
para recuperar o modelo existente inserindo o seguinte comando na linha de comandos:aws sesv2 get-email-template --template-name
MyTemplate
No comando anterior,
MyTemplate
substitua pelo nome do modelo que você deseja atualizar.Se o nome do modelo que você forneceu corresponder a um modelo existente na sua SES conta, esse comando retornará uma resposta semelhante ao exemplo a seguir:
{ "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>" } }
-
Em um editor de texto, crie um novo arquivo. Cole a saída do comando anterior no arquivo.
-
Modifique o template conforme necessário. Todas as linhas que você omitir são removidas do modelo. Por exemplo, se você quiser alterar apenas o
SubjectPart
do modelo, você ainda precisa incluir as propriedadesTextPart
eHtmlPart
.Ao concluir, salve o arquivo como
update_template.json
. -
Na linha de comando, insira o seguinte comando:
aws sesv2 update-email-template --cli-input-json file://
path/to/update_template.json
No comando anterior,
path/to/update_template.json
substitua pelo caminho para oupdate_template.json
arquivo que você criou na etapa anterior.Se o modelo for atualizado com êxito, esse comando não fornece nenhuma saída. Você pode verificar se o modelo foi atualizado usando a
GetEmailTemplate
operação.Se o modelo especificado não existir, esse comando retornará um erro de
TemplateDoesNotExist
. Se o modelo não contiver a propriedadeTextPart
nem a propriedadeHtmlPart
, este comando retornará um erroInvalidParameterValue
.