アカウントレベルのサプレッションリストの使用 - Amazon Simple Email Service

英語の翻訳が提供されている場合で、内容が矛盾する場合には、英語版がオリジナルとして取り扱われます。翻訳は機械翻訳により提供されています。

アカウントレベルのサプレッションリストの使用

Amazon SES には、現在の AWS リージョンの AWS アカウントに適用されるアカウントレベルのサプレッションリストが含まれています。このサプレッションリストを使用すると、以前にバウンスイベントや苦情イベントが発生したアドレスへの E メール送信を防止できます。アカウントレベルのサプレッションリストを設定する場合、アドレスがハードバウンスになったとき、苦情が発生したとき、またはその両方の場合に、アドレスをリストに追加するかどうかを指定します。アカウントレベル抑制リストから個別またはバルクアドレスを手動で追加または削除するには、 Amazon SES API v2。

注記

アドレスを一括追加または削除するには、本番アクセスが必要です。サンドボックスの詳細については、「Amazon SES サンドボックス外への移動」を参照してください。

Amazon SES には、グローバルサプレッションリストも含まれています。詳細については、Amazon SES グローバルサプレッションリストの使用 を参照してください。

アカウントレベルの抑制リストの考慮事項

アカウントレベルのサプレッションリストを使用する場合は、次の要素を考慮する必要があります。

  • 2019 年 11 月 25 日以降に Amazon SES の使用を開始した場合、アカウントはバウンスと苦情の両方に対してアカウントレベルのサプレッションリストをデフォルトで使用します。この日付より前に Amazon SES の使用を開始した場合は、Amazon SES API の PutAccountSuppressionAttributes オペレーションを使用してこの機能を有効にする必要があります。

  • アカウントレベルのサプレッションリストに含まれているアドレスにメッセージを送信しようとすると、Amazon SES はメッセージを受け付けますが、送信はしません。

  • Amazon SES は、アカウントレベルのサプレッションリストのアドレスに送信したメッセージを、アカウントのバウンスレートに対してカウントしません。

  • Amazon SES は、アカウントレベルのサプレッションリストのアドレスに送信したメッセージを、毎日の送信クォータに対してカウントします。

  • アカウントレベルのサプレッションリストの E メールアドレスは、Amazon SES API v2 で DeleteSuppressedDestination オペレーションを使用して削除するまでリストに残ります。

  • アカウントのメール送信機能が一時停止されている場合、Amazon SES はアカウントレベルのサプレッションリストのアドレスを 90 日後に自動的に削除します。この 90 日の期間が終了する前にアカウントのメール送信機能が復元された場合、アカウントレベルのサプレッションリストのアドレスは削除されません。

  • Gmail では、Amazon SES に苦情データが提供されません。受取人が Gmail ウェブクライアントの [迷惑メール] ボタンを使用して、受信したメールを迷惑メールとして報告した場合、アカウントレベルのサプレッションリストには追加されません。

  • アカウントが Amazon SES サンドボックスにある場合は、アカウントレベルのサプレッションリストを有効にすることができます。ただし、 PutSuppressedDestination(プットサプレッスドデスティネーション) または インポートジョブの作成 サンドボックスからアカウントが削除されるまで操作を続けます。サンドボックスの詳細については、「Amazon SES サンドボックス外への移動」を参照してください。

  • アカウントレベルのサプレッションリストを使用すると、Amazon SES はハードバウンスを引き起こすアドレスもグローバルサプレッションリストに追加します。

科目レベル抑制リストの有効化

アカウントレベルのサプレッションリストを有効にして設定するには、Amazon SES API v2 で PutAccountSuppressionAttributes オペレーションを使用できます。AWS CLI を使用すると、この設定をすばやく簡単に設定できます。AWS CLI のインストールと設定についての詳細は、AWS Command Line Interface ユーザーガイドを参照してください。

AWS CLI を使用してアカウントレベルのサプレッションリストを設定するには

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

    Linux, macOS, or Unix
    aws sesv2 put-account-suppression-attributes \ --suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-account-suppression-attributes ` --suppressed-reasons BOUNCE COMPLAINT

    アカウントレベルのサブレッションリストを有効にするには、suppressed-reasons パラメータに少なくとも 1 つの理由を指定する必要があります。前の例に示すように、COMPLAINT または BOUNCE、または両方を指定することもできます。

構成セットのアカウントレベル抑制リストの有効化

特定の 設定セットにのみ適用されるように、アカウントレベルのサプレッションを設定することもできます。この操作を行うと、バウンスイベントまたは苦情イベントの原因となった E メールを送信したときに設定セットを指定した場合にのみ、アドレスがサプレッションリストに追加されます。

注記

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

AWS CLI を使用して設定セット用にアカウントレベルのサプレッションリストを設定するには

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

    Linux, macOS, or Unix
    aws sesv2 put-configuration-set-suppression-options \ --configuration-set-name configSet \ --suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-configuration-set-suppression-options ` --configuration-set-name configSet ` --suppressed-reasons BOUNCE COMPLAINT

    前述の例では、configSet アカウントレベルの抑制リストを使用する構成セットの名前。

アカウントレベルの抑制リストに個々の電子メールアドレスを手動で追加する

アカウントレベルの抑制リストに個々のアドレスを手動で追加するには、 PutSuppressedDestination(プットサプレッスドデスティネーション) のオペレーション Amazon SES API v2。アカウントレベルのサプレッションリストに追加できるアドレスの数に制限はありません。

注記

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

AWS CLI を使用してアカウントレベルのサプレッションリストにアドレスを手動で追加するには

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

    Linux, macOS, or Unix
    aws sesv2 put-suppressed-destination \ --email-address recipient@example.com \ --reason BOUNCE
    Windows
    aws sesv2 put-suppressed-destination ` --email-address recipient@example.com ` --reason BOUNCE

    前述の例では、recipient@example.com アカウントレベルの抑制リストに追加する電子メールアドレス BOUNCE アドレスをサプレッションリストに追加する理由(許容値は BOUNCE および COMPLAINT)。

アカウントレベルの抑制リストに電子メールアドレスを一括追加する

連絡先リストを Amazon S3 オブジェクトに続いて、 インポートジョブの作成 のオペレーション Amazon SES API v2。

注記

アカウントレベルの抑制リストに追加できるアドレス数に制限はありませんが、 Amazon S3 のオブジェクトです。

アカウントレベルの抑制リストに電子メールアドレスを一括で追加するには、次の手順を実行します。

  • 住所リストを Amazon S3 CSV または JSON 形式のオブジェクト。

    アドレスを追加するためのCSV形式の例:

    recipient1@example.com,BOUNCE

    recipient2@example.com,COMPLAINT

    newline区切りのJSONファイルのみがサポートされています。この形式では、各行は個々のアドレス定義を含む完全なJSONオブジェクトです。

    アドレスを追加するためのJSON形式の例:

    {“emailAddress”:“recipient1@example.com”,“reason”:“BOUNCE”}

    {“emailAddress”:“recipient2@example.com”,“reason”:“COMPLAINT”}

    前述の例では、recipient1@example.com および recipient2@example.com アカウントレベルの抑制リストに追加する電子メールアドレス。アドレスをサプレッションリストに追加する理由は、次のとおりです。 BOUNCE および COMPLAINT.

  • 与える Amazon SES を読み取る権限 Amazon S3 オブジェクト。

    を に適用すると Amazon S3 次のポリシーでは、 Amazon SES バケットを読み取る許可。ポリシーの添付についての詳細は、 Amazon S3 バケット、参照 バケットポリシーとユーザーポリシーの使用Amazon Simple Storage Service 開発者ガイド.

    { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESGet", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::BUCKET-NAME/OBJECT-NAME", "Condition": { "StringEquals": { "aws:Referer": "AWSACCOUNTID" } } } ] }
  • 与える Amazon SES AWS KMSマスターキーを使用する許可。

    _が Amazon S3 オブジェクトは AWS KMS キーで暗号化されています。AWS KMS キーを使用する Amazon SES 許可を与える必要があります。 Amazon SES は、カスタムマスターキーからのみ許可を得ることができ、デフォルトマスターキーからは許可を得ることができません。あなたは Amazon SES ステートメントをキーのポリシーに追加することにより、カスタムマスターキーを使用する権限。

    以下の方針声明を主な方針に貼り付けて許可する Amazon SES カスタムマスターキーを使用します。

    { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" }
  • _を使用 インポートジョブの作成 のオペレーション Amazon SES API v2。

注記

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

バルクアドレスをアカウントレベル抑制リストに手動で追加するには、 AWS CLI

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

    Linux, macOS, or Unix
    aws sesv2 create-import-job \ --import-destination "{\"SuppressionListDestination\": {\"SuppressionListImportAction\”:\”PUT\"}}" \ --import-data-source "{\"S3Url\": \"s3://s3bucket/s3object\",\"DataFormat\": \"CSV\"}"
    Windows
    aws sesv2 create-import-job ` --import-destination "{\"SuppressionListDestination\": {\"SuppressionListImportAction\”:\”PUT\"}}" ` --import-data-source "{\"S3Url\": \"s3://s3bucket/s3object\",\"DataFormat\": \"CSV\"}"

    前述の例では、s3bucket および s3object と Amazon S3 バケット名と Amazon S3 オブジェクト名。

アカウントレベル抑制リストにあるアドレスのリストの表示

Amazon SES API v2 の ListSuppressedDestinations オペレーションを使用すると、アカウントのアカウントレベルのサプレッションリストにあるすべての E メールアドレスを一覧表示できます。

注記

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

アカウントレベルのサプレッションリストにあるすべての E メールアドレス一覧表示するには

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

    aws sesv2 list-suppressed-destinations

上記のコマンドは、アカウントのアカウントレベルのサプレッションリストにあるすべての E メールアドレスを返します。出力は以下の例のようになります。

{ "SuppressedDestinationSummaries": [ { "EmailAddress": "recipient2@example.com", "Reason": "COMPLAINT", "LastUpdateTime": 1586552585.077 }, { "EmailAddress": "recipient0@example.com", "Reason": "COMPLAINT", "LastUpdateTime": 1586552666.613 }, { "EmailAddress": "recipient1@example.com", "Reason": "BOUNCE", "LastUpdateTime": 1586556479.141 } ] }

StartDate オプションを使用すると、特定の日付のにリストに追加された E メールアドレスのみを表示できます。

特定の日付の後にアカウントレベルのサプレッションリストに追加されたアドレスを一覧表示するには

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

    aws sesv2 list-suppressed-destinations --start-date 1604394130

    前述のコマンドで、1604394130 開始日のUnixタイムスタンプ付き。

また、EndDate オプションを使用すると、特定の日付のにリストに追加された E メールアドレスのみを表示することもできます。

特定の日付の前にアカウントレベルのサプレッションリストに追加されたアドレスを一覧表示するには

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

    aws sesv2 list-suppressed-destinations --end-date 1611126000

    前述のコマンドで、1611126000 終了日のUnixタイムスタンプ付き。

Linux, macOS, or Unix コマンドラインで、組み込みの grep ユーティリティを使用して、特定のアドレスまたはドメインを検索することもできます。

アカウントレベルのサプレッションリストで特定のアドレスを検索するには

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

    aws sesv2 list-suppressed-destinations | grep -A2 'example.com'

    前述のコマンドで、example.com 検索するテキストの文字列(アドレスやドメインなど)。

アカウントレベル抑制リストからの電子メールアドレスの削除

アカウントのサプレッションリストに追加されているアドレスをリストから除外する場合は、Amazon SES API v2 の DeleteSuppressedDestination オペレーションを使用して手動で削除できます。

注記

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

AWS CLI を使用してアカウントレベルのサプレッションリストからアドレスを削除するには

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

    Linux, macOS, or Unix
    aws sesv2 delete-suppressed-destination \ --email-address recipient@example.com
    Windows
    aws sesv2 delete-suppressed-destination ` --email-address recipient@example.com

    前述の例では、recipient@example.com アカウントレベルの抑制リストから削除する電子メールアドレス。

アカウントレベル抑制リストからのメール アドレスの一括削除

連絡先リストを Amazon S3 オブジェクトに続いて、 インポートジョブの作成 のオペレーション Amazon SES API v2。

注記

アカウントレベルの抑制リストから削除できるアドレスの数に制限はありませんが、 Amazon S3 のオブジェクトです。

アカウントレベルの抑制リストから電子メールアドレスを一括削除するには、次の手順を実行します。

  • 住所リストを Amazon S3 CSV または JSON 形式のオブジェクト。

    アドレスを削除するCSV形式の例:

    recipient3@example.com

    newline区切りのJSONファイルのみがサポートされています。この形式では、各行は個々のアドレス定義を含む完全なJSONオブジェクトです。

    アドレスを追加するためのJSON形式の例:

    {“emailAddress”:“recipient3@example.com”}

    前述の例では、recipient3@example.com アカウントレベルの抑制リストから削除する電子メールアドレス。

  • 与える Amazon SES を読み取る権限 Amazon S3 オブジェクト。

    を に適用すると Amazon S3 次のポリシーでは、 Amazon SES バケットを読み取る許可。ポリシーの添付についての詳細は、 Amazon S3 バケット、参照 バケットポリシーとユーザーポリシーの使用Amazon Simple Storage Service 開発者ガイド.

    { "Version": "2012-10-17", "Statement": [ { "Sid": "AllowSESGet", "Effect": "Allow", "Principal": { "Service": "ses.amazonaws.com" }, "Action": "s3:GetObject", "Resource": "arn:aws:s3:::BUCKET-NAME/OBJECT-NAME", "Condition": { "StringEquals": { "aws:Referer": "AWSACCOUNTID" } } } ] }
  • 与える Amazon SES AWS KMSマスターキーを使用する許可。

    _が Amazon S3 オブジェクトは AWS KMS キーで暗号化されています。AWS KMS キーを使用する Amazon SES 許可を与える必要があります。 Amazon SES は、カスタムマスターキーからのみ許可を得ることができ、デフォルトマスターキーからは許可を得ることができません。あなたは Amazon SES ステートメントをキーのポリシーに追加することにより、カスタムマスターキーを使用する権限。

    以下の方針声明を主な方針に貼り付けて許可する Amazon SES カスタムマスターキーを使用します。

    { "Sid": "AllowSESToDecrypt", "Effect": "Allow", "Principal": { "Service":"ses.amazonaws.com" }, "Action": [ "kms:Decrypt", ], "Resource": "*" }
  • _を使用 インポートジョブの作成 のオペレーション Amazon SES API v2。

注記

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

アカウントレベル抑制リストからバルクアドレスを手動で削除するには、 AWS CLI

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

    Linux, macOS, or Unix
    aws sesv2 create-import-job \ --import-destination "{\"SuppressionListDestination\": {\"SuppressionListImportAction\”:\”DELETE\"}}" \ --import-data-source "{\"S3Url\": \"s3://s3bucket/s3object\",\"DataFormat\": \"CSV\"}"
    Windows
    aws sesv2 create-import-job ` --import-destination "{\"SuppressionListDestination\": {\"SuppressionListImportAction\”:\”DELETE\"}}" ` --import-data-source "{\"S3Url\": \"s3://s3bucket/s3object\",\"DataFormat\": \"CSV\"}"

    前述の例では、s3bucket および s3object と Amazon S3 バケット名と Amazon S3 オブジェクト名。

科目のインポート ジョブのリストの表示

アカウントのアカウントレベル抑制リストにあるすべての電子メールアドレスのリストを表示するには、 リストインポートジョブ のオペレーション Amazon SES API v2。

注記

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

科目のすべてのインポート ジョブのリストを表示するには

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

    aws sesv2 list-import-jobs

前のコマンドは、科目のインポート ジョブをすべて返します。出力は以下の例のようになります。

{ "ImportJobs": [ { "CreatedTimestamp": 1596175615.804, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "JobStatus": "COMPLETED", "JobId": "755380d7-fbdb-4ed2-a9a3-06866220f5b5" }, { "CreatedTimestamp": 1596134732.398, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "DELETE" } }, "JobStatus": "COMPLETED", "JobId": "076683bd-a7ee-4a40-9754-4ad1161ba8b6" }, { "CreatedTimestamp": 1596645918.134, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "JobStatus": "COMPLETED", "JobId": "6e261869-bd30-4b33-b1f2-9e035a83a395" } ] }

アカウントのインポートジョブに関する情報の取得

アカウントのインポートジョブに関する情報は、 インポートジョブの取得 のオペレーション Amazon SES API v2。

注記

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

アカウントのインポートジョブに関する情報を取得するには

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

    aws sesv2 get-import-job --job-id JobId

前述のコマンドは、科目のインポートジョブに関する情報を返します。出力は以下の例のようになります。

{ "ImportDataSource": { "S3Url": "s3://bucket/object", "DataFormat": "CSV" }, "ProcessedRecordsCount": 2, "FailureInfo": { "FailedRecordsS3Url": "s3presignedurl" }, "JobStatus": "COMPLETED", "JobId": "jobid", "CreatedTimestamp": 1597251915.243, "FailedRecordsCount": 1, "ImportDestination": { "SuppressionListDestination": { "SuppressionListImportAction": "PUT" } }, "CompletedTimestamp": 1597252002.583 }

アカウントレベルの抑制リストを無効にする

suppressed-reasons 属性から値を削除することでアカウントレベルのサプレッションリストを事実上無効にするには、Amazon SES API v2 で PutAccountSuppressionAttributes オペレーションを使用できます。

注記

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

AWS CLI を使用してアカウントレベルのサプレッションリストを無効にするには

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

    aws sesv2 put-account-suppression-attributes --suppressed-reasons