Amazon SES デフォルト設定セットの管理 - Amazon Simple Email Service Classic

Amazon SES Classic のユーザーガイドです。更新プログラムや新機能は、推奨している新しい Amazon SES デベロッパーガイドに記述されています。

Amazon SES デフォルト設定セットの管理

ID を作成するときに、電子メール ID にデフォルト設定セットを追加したり、既存の ID にデフォルト設定セットを追加したりできます。デフォルト設定セットは、E メール ID とドメイン ID の両方に適用できます。

デフォルト設定セットは、その設定セットに関連付けられた電子メール ID から送信するすべてのメッセージに、その規則を自動的に適用します。

デフォルト設定セットに関する考慮事項

  • ID に関連付ける前に、まず設定セットを作成する必要があります。

  • デフォルト設定セットは、ID が検証された場合にのみ適用されます。

  • E メール ID は、一度に 1 つの設定セットにのみ関連付けることができます。ただし、同じ設定セットを複数の ID に適用することができます。

  • 電子メールアドレスレベルのデフォルトの設定セットは、ドメインレベルのデフォルトの設定セットよりも優先されます。たとえば、joe@example.com に関連するデフォルト設定セットが、 example.com のドメインの設定セットをオーバーライドします。

  • ドメインレベルで設定されたデフォルト設定は、そのドメインのすべての電子メールアドレスに適用されます (ドメインの特定アドレスを確認しない限り)。

  • ID のデフォルト設定セットとして指定されている設定セットを削除し、その ID を使用して E メールを送信しようとすると、Amazon SES への呼び出しが「bad request」エラーで失敗します。

Amazon SES API を使用したデフォルト設定セットの ID の作成と検証

Amazon SES API v2で、CreateEmailIdentity オペレーションを使用して、新しい E メール ID を作成し、同時にデフォルト設定を設定します。

注記

このセクションの手順を完了する前に、まず AWS CLI をインストールして設定する必要があります。詳細については、AWS Command Line Interface ユーザーガイドを参照してください。

を使用してデフォルト設定セットを設定するには AWS CLI

  • コマンドラインで以下のコマンドを入力して、CreateEmailIdentity オペレーションを使用します。

aws sesv2 create-email-identity --email-identity ADDRESS-OR-DOMAIN --configuration-set-name CONFIG-SET

上記のコマンドで、ADDRESS-OR-DOMAIN を、検証する E メール ID に置き換えます。CONFIG-SET を、ID のデフォルト設定セットとして設定する設定セット名に置き換えます。

コマンドが正常に実行された場合、何の出力もなく終了します。

E メールアドレスを検証するには

  1. 受信箱で、検証するメールアドレスをチェックします。「アマゾン ウェブ サービス - Email Address Verification Request in region RegionName」という件名のメッセージが表示されます。ここで言う、 RegionName は、E メールアドレスを確認しようとした AWS リージョンの名前です。

    メッセージを開き、メッセージ内のリンクをクリックします。

    注記

    検証メッセージ内のリンクは、メッセージが送信されてから 24 時間で期限切れになります。確認メールを受信してから 24 時間が経過した場合は、手順 1 〜 5 を繰り返して、有効なリンクが設定された確認メールを受信してください。

  2. Amazon SES コンソールの [Identity Management] で [Email Addresses] を選択します。E メールアドレスのリストで、検証する E メールアドレスを探します。E メールアドレスが検証された場合は、[Status] 列の値が 「verified」になります。

ドメインを検証するには

ドメインの検証の詳細については、「Amazon SES でのドメインの検証」を参照してください。

Amazon SES API を使用して既存の E メール ID にデフォルト設定セットを追加する

PutEmailIdentityConfigurationSetAttributes オペレーションを使用して、既存の電子メール ID からデフォルト設定セットを追加または削除できます。

注記

このセクションの手順を完了する前に、まず AWS CLI をインストールして設定する必要があります。詳細については、AWS Command Line Interface ユーザーガイドを参照してください。

を使用してデフォルト設定セットを追加するには AWS CLI

aws sesv2 put-email-identity-configuration-set-attributes --email-identity ADDRESS-OR-DOMAIN --configuration-set-name CONFIG-SET

上記のコマンドで、ADDRESS-OR-DOMAIN を、検証する E メール ID に置き換えます。CONFIG-SET を、ID のデフォルト設定セットとして設定する設定セット名に置き換えます。

コマンドが正常に実行された場合、何の出力もなく終了します。

を使用してデフォルト設定セットを削除するには AWS CLI

aws sesv2 put-email-identity-configuration-set-attributes --email-identity ADDRESS-OR-DOMAIN

上記のコマンドで、ADDRESS-OR-DOMAIN を、検証する E メール ID に置き換えます。

コマンドが正常に実行された場合、何の出力もなく終了します。

Amazon SES API を使用したデフォルト設定セットを返す

GetEmailIdentity オペレーションを使用して、電子メール ID のデフォルト設定セットを返します (該当する場合)。

注記

このセクションの手順を完了する前に、まず AWS CLI をインストールして設定する必要があります。詳細については、AWS Command Line Interface ユーザーガイドを参照してください。

を使用してデフォルト設定セットを返すには AWS CLI

  • コマンドラインで以下のコマンドを入力して GetEmailIdentity オペレーションを使用します。

aws sesv2 get-email-identity --email-identity ADDRESS-OR-DOMAIN

上記のコマンドで、ADDRESS-OR-DOMAIN を、デフォルト設定セットが知りたい電子メールIDに置き換えます(存在する場合)。

コマンドが正常に実行された場合、E メール ID の詳細を含む JSON オブジェクトが提供されます。

Amazon SES API を使用したデフォルト設定セットのオーバーライド

SendEmail オペレーションを使用して、異なる設定セットで電子メールを送信できます。そうした場合、指定した設定セットが、ID のデフォルト設定セットをオーバーライドします。

注記

このセクションの手順を完了する前に、まず AWS CLI をインストールして設定する必要があります。詳細については、AWS Command Line Interface ユーザーガイドを参照してください。

を使用してデフォルト設定セットをオーバーライドするには AWS CLI

  • コマンドラインで以下のコマンドを入力して、SendEmail オペレーションを使用します。

aws sesv2 send-email --destination file://DESTINATION-JSON --content file://CONTENT-JSON --from-email-address ADDRESS-OR-DOMAIN --configuration-set-name CONFIG-SET

上記のコマンドで、DESTINATION-JSON を宛先の JSON ファイルに置き換え、CONTENT-JSON をコンテンツ JSON ファイルに置き換え、ADDRESS-OR-DOMAIN を FROM メールアドレスに置き換え、CONFIG-SETを、ID のデフォルト設定セットではなく、使用する設定セットの名前に置き換えます。

コマンドが正常に実行された場合、MessageId を出力します。