View a markdown version of this page

E メールテンプレートの管理 - Amazon Simple Email Service
E メールテンプレートの一覧表示特定の E メール テンプレートの内容の表示E メールテンプレートの削除E メールテンプレートの更新

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

E メールテンプレートの管理

E メールテンプレートの作成に加えて、Amazon SES v2 API を使用して、既存のテンプレートを更新または削除したり、既存のすべてのテンプレートを一覧表示したり、テンプレートの内容を表示したりできます。

このセクションでは、 AWS CLI を使用して SES テンプレートに関連するタスクを実行する手順について説明します。

注記

これらの手順では、 AWS CLIがすでにインストールされ、設定されていることを前提としています。のインストールと設定の詳細については AWS CLI、 AWS Command Line Interface ユーザーガイドを参照してください。

E メールテンプレートの一覧表示

SES v2 API オペレーション ListEmailTemplate を使用して、既存の E メールテンプレートのリストを表示します。

E メールテンプレートの一覧を表示するには

  • コマンドラインで以下のコマンドを入力します。

    aws sesv2 list-email-templates

    現在のリージョンの SES アカウントに既存の E メールテンプレートがある場合、このコマンドは次の例のようなレスポンスを返します。

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

    テンプレートをまだ作成していない場合、このコマンドはメンバーのいないTemplatesMetadataオブジェクトを返します。

特定の E メール テンプレートの内容の表示

SES v2 API オペレーション GetEmailTemplate を使用して、特定の E メールテンプレートの内容を表示できます。

E メールテンプレートの内容を表示するには

  • コマンドラインで以下のコマンドを入力します。

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

    上記のコマンドで、MyTemplateを、表示したいテンプレートの名前に置き換えます。

    指定したテンプレート名が SES アカウントに存在するテンプレートと一致する場合、このコマンドは次の例のようなレスポンスを返します。

    {
    "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>"
    }
}

    指定したテンプレート名が SES アカウントに存在するテンプレートと一致しない場合、このコマンドは NotFoundException エラーを返します。

E メールテンプレートの削除

SES v2 API オペレーション DeleteEmailTemplate を使用して、特定の E メールテンプレートを削除できます。

E メールテンプレートを削除する

  • コマンドラインで以下のコマンドを入力します。

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

    前述のコマンドで、MyTemplate を削除するテンプレート名で置き換えます。

    このコマンドは出力を提供しません。GetTemplate オペレーションを使用して、テンプレートが削除されたことを確認できます。

E メールテンプレートの更新

SES v2 API オペレーション UpdateEmailTemplate を使用して、既存の E メールテンプレートを更新できます。たとえば、このオペレーションは、E メールテンプレートの件名を変更する場合や、メッセージの本文を変更する必要がある場合に役立ちます。

E メールテンプレートを更新する

  1. GetEmailTemplate コマンドを使用し、コマンドラインに次のコマンドを入力して、既存のテンプレートを取得できます。

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

    上記のコマンドで、MyTemplateを、テンプレートの更新名に置き換えます。

    指定したテンプレート名が SES アカウントに存在するテンプレートと一致する場合、このコマンドは次の例のようなレスポンスを返します。

    {
    "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. テキストエディタで新規ファイルを作成します。前のコマンドの出力をファイルに貼り付けます。

  3. 必要に応じてテンプレートを変更します。省略した行は、テンプレートから削除されます。たとえば、テンプレートの SubjectPart を変更したい場合のみ、TextPart および HtmlPart のプロパティを含める必要があります。

    終了したら、update_template.jsonとしてファイルを保存します。

  4. コマンドラインで以下のコマンドを入力します。

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

    前述の上記のコマンドで、path/to/update_template.json を、前のステップで作成した update_template.json ファイルのパスに置き換えます。

    テンプレートが正常に更新された場合、このコマンドは出力を提供しません。GetEmailTemplate オペレーションを使用して、テンプレートが更新されたことを確認できます。

    指定したテンプレートが存在しない場合、このコマンドは TemplateDoesNotExist エラーを返します。テンプレートに TextPart または HtmlPart のプロパティ (またはその両方) が含まれていない場合、このコマンドは InvalidParameterValue エラーを返します。