翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
テナントサプレッションリストエントリの管理
テナントのサプレッションリストのエントリを管理するには、アカウントレベルのサプレッションリストに使用するのと同じ Amazon Simple Email Service (SES) API オペレーションを使用します。特定のテナントのリストをターゲットにするには、各リクエストに --tenant-nameパラメータを含めます。このパラメータを省略すると、オペレーションはアカウントレベルのリストをターゲットにします。を使用して、特定のテナントの抑制アドレス AWS CLI を追加、チェック、削除、一覧表示します。
重要
サプレッションリストの E メールアドレスは、ケースが保持された状態で保存されます。E メール送信機能は、異なるケースのアドレスを同一として扱いますが、サプレッションリスト管理の API コールでは、ケースが完全に一致する必要があります。エントリを追加、チェック、または削除するときに、サプレッションリストに表示される E メールアドレスの正確な大文字と小文字を使用してください。
前提条件
テナントサプレッションリストエントリを管理する前に、次の要件を満たしていることを確認してください。
-
テナントレベルの抑制は、テナントに対して有効になっています。詳細については、「テナントレベルの抑制の設定」を参照してください。
-
AWS CLI バージョン 2 がインストールされ、適切なアクセス許可で設定されます。詳細については、「AWS Command Line Interface ユーザーガイド」を参照してください。
-
テナントは SES アカウントに存在します。
テナントのサプレッションリストへのアドレスの追加
--tenant-name パラメータを指定して PutSuppressedDestination API オペレーションを使用して、テナントのサプレッションリストに E メールアドレスを追加します。
を使用してテナントのサプレッションリストにアドレスを追加するには AWS CLI
-
コマンドラインで以下のコマンドを入力します。
前の例では、
recipient@example.comを加算する E メールアドレスに置き換え、BOUNCEを抑制理由 (許容値はBOUNCEとCOMPLAINT) に置き換え、MyTenantをテナントの名前に置き換えます。
コマンドは、成功時に出力を生成しません (HTTP 200)。これで、アドレスはテナントのサプレッションリストに表示されます。
注記
--reason パラメータは BOUNCEまたは を受け入れますCOMPLAINT。同じアドレスをさまざまな理由で追加できます。
アドレスがテナントのサプレッションリストにあるかどうかを確認する
--tenant-name パラメータを指定して GetSuppressedDestination API オペレーションを使用して、E メールアドレスがテナントのサプレッションリストにあるかどうかを確認します。
を使用して、アドレスがテナントのサプレッションリストにあるかどうかを確認するには AWS CLI
-
コマンドラインで以下のコマンドを入力します。
前の例では、
recipient@example.comをチェックする E メールアドレスに置き換え、MyTenantをテナントの名前に置き換えます。
アドレスがテナントのサプレッションリストにある場合、コマンドは次の例のような出力を返します。
{ "SuppressedDestination": { "EmailAddress": "recipient@example.com", "Reason": "BOUNCE", "LastUpdateTime": "2026-03-15T10:30:00.000Z", "Attributes": { "MessageId": "0100018e1234abcd-12345678-abcd-1234-abcd-123456789012-000000", "FeedbackId": "0100018e1234abce-12345678-abcd-1234-abcd-123456789012-000000" } } }
レスポンスには、次のフィールドが含まれます。
-
EmailAddress– 抑制されている E メールアドレス。 -
Reason– アドレスが抑制された理由 (BOUNCEまたはCOMPLAINT)。 -
LastUpdateTime– エントリが最後に更新された日時。 -
Attributes– 抑制の原因となったイベントFeedbackIdからのMessageIdと が含まれます。これらのフィールドは、自動的に抑制されるアドレスには存在し、手動で追加されたエントリには存在しません。
注記
アドレスがテナントのサプレッションリストにない場合、API は を返しますNotFoundException。
テナントのサプレッションリストからアドレスを削除する
--tenant-name パラメータを指定して DeleteSuppressedDestination API オペレーションを使用して、テナントのサプレッションリストから E メールアドレスを削除します。
を使用してテナントのサプレッションリストからアドレスを削除するには AWS CLI
-
コマンドラインで以下のコマンドを入力します。
前の例では、
recipient@example.comを削除する E メールアドレスに置き換え、MyTenantをテナントの名前に置き換えます。
コマンドは、成功時に出力を生成しません (HTTP 200)。アドレスはテナントのサプレッションリストから削除されます。
重要
テナントのサプレッションリストからアドレスを削除しても、グローバルサプレッションリストまたはアカウントレベルのサプレッションリストからアドレスは削除されません。各リストは個別に管理されます。
テナントのサプレッションリストへのアドレスの一覧表示
--tenant-name パラメータを指定して ListSuppressedDestinations API オペレーションを使用して、特定のテナントのすべての抑制アドレスを取得します。
を使用してテナントのサプレッションリストのすべてのアドレスを一覧表示するには AWS CLI
-
コマンドラインで以下のコマンドを入力します。
前の例では、
MyTenantをテナントの名前に置き換えます。
次の出力例は、抑制された 2 つのアドレスを示しています。
{ "SuppressedDestinationSummaries": [ { "EmailAddress": "bounce@example.com", "Reason": "BOUNCE", "LastUpdateTime": "2026-03-10T08:15:00.000Z" }, { "EmailAddress": "complaint@example.com", "Reason": "COMPLAINT", "LastUpdateTime": "2026-03-12T14:30:00.000Z" } ] }
結果のフィルタリング
理由、日付範囲、またはその両方で結果をフィルタリングできます。
次のコマンドは、理由によってフィルタリングします。
次のコマンドは日付範囲でフィルタリングします。
レスポンスにNextToken値が含まれている場合は、後続のリクエストでそれを使用してより多くの結果を取得します。--page-size パラメータを使用して、ページあたりの結果の数を制御します。
注記
リストオペレーションは概要情報のみを返します。を含む詳細な情報を取得するにはAttributes、個々のアドレスGetSuppressedDestinationに を使用します。
自動サプレッションエントリ
SES は、テナントの抑制設定に基づいて抑制エントリを自動的に管理します。自動エントリに対してアクションを実行する必要はありません。これらは、手動で追加されたエントリとともにテナントのサプレッションリストに表示されます。
SES は、次の場合にエントリを自動的に追加します。
-
テナントでバウンス抑制が有効になっている場合、ハードバウンスが発生します。
-
テナントで苦情抑制が有効になっている場合、苦情が受信されます。
SES は、次の場合にエントリを自動的に削除します。
-
苦情が抑制されたアドレスのスパム以外のレポートが受信されます。
