翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon SES でのテナントレベルのサプレッションリストの使用
Amazon Simple Email Service (SES) マルチテナンシーを使用して複数のテナントに代わって E メールを送信する場合は、各テナントに独自のサプレッションリストを付与できます。テナントレベルのサプレッションは、バウンスと苦情を分離して、E メールを送信したテナントのみに影響します。この機能がない場合、すべてのテナントはアカウントレベルのサプレッションリストを共有します。受信者が 1 つのテナントの E メールについてバウンスまたは苦情を送信すると、そのアドレスはアカウント内のすべてのテナントに対して抑制されます。テナントレベルの抑制は、テナントごとに抑制されたアドレスの個別のリストを維持することで、このクロステナントの汚染を防止します。
テナントレベルの抑制の仕組み
抑制範囲と抑制理由の 2 つの設定は、テナントごとに抑制動作を制御します。両方の設定を一緒に設定するには、 PutTenantSuppressionAttributes API オペレーションを使用するか、 CreateTenant API オペレーションでテナントを作成するSuppressionAttributesときに を指定します。
抑制スコープは、SES がテナントに使用する抑制リストを決定します。
-
TENANT– テナント独自のサプレッションリストを使用します。 -
ACCOUNT– アカウントレベルのサプレッションリストを使用します。これは、既存のテナントと新しいテナントの両方のデフォルトです。
抑制された理由によって、SES がサプレッションリストにアドレスを追加するイベントが決まります。
-
BOUNCE– ハードバウンスを生成するアドレスを追加します。 -
COMPLAINT– 苦情を生成するアドレスを追加します。 -
BOUNCEおよびCOMPLAINT– いずれかのイベントを生成するアドレスを追加します。 -
空 — サプレッションリストを確認または記録しないでください。
注記
SuppressionScope と をSuppressedReasons一緒に指定するか、両方を null に設定する必要があります。両方を null に設定すると、テナントの抑制設定がクリアされ、テナントはデフォルトのACCOUNTスコープ動作に戻ります。
設定別の抑制動作
次の表は、抑制範囲と抑制理由の組み合わせごとの送信時間と記録の動作を示しています。
| スコープ | 理由 | 送信時の動作 | 記録動作 |
|---|---|---|---|
TENANT |
BOUNCE, COMPLAINT |
テナントリストにバウンスと苦情がないか確認します | 両方をテナントリストに記録する |
TENANT |
BOUNCE |
テナントリストのバウンスのみをチェックします | テナントリストへのバウンスのみを記録します |
TENANT |
COMPLAINT |
テナントリストで苦情のみを確認します | 苦情をテナントリストにのみ記録します |
TENANT |
空 | 抑制チェックなし | 録画なし |
ACCOUNT |
BOUNCE, COMPLAINT |
アカウントリストにバウンスと苦情がないか確認します | 両方をアカウントリストに記録する |
ACCOUNT |
BOUNCE |
アカウントリストのバウンスのみをチェックします | アカウントリストのみにバウンスを記録します |
ACCOUNT |
COMPLAINT |
苦情のみのアカウントリストをチェックします | 苦情をアカウントリストにのみ記録します |
ACCOUNT |
空 | 抑制チェックなし | 録画なし |
抑制の優先順位と送信時の動作
SES は、抑制設定を最も高い順に解決します。
-
設定セット – 設定セットで抑制設定が指定されている場合、SES はそれらの設定を使用します。
-
テナント – 設定セットの上書きが存在しない場合、SES はテナントの抑制設定を使用します。
-
アカウント – 設定セットもテナントも設定を指定しない場合、SES はアカウントレベルのデフォルトを使用します。
重要
サプレッションスコープは、送信時に SES がチェックするサプレッションリストを決定します。スコープが の場合TENANT、SES はテナントのサプレッションリストのみをチェックし、アカウントレベルのサプレッションリストをスキップします。アカウントレベルのサプレッションリストにはあるが、テナントのサプレッションリストにはないアドレスは抑制されません。スコープが の場合ACCOUNT、SES はアカウントレベルのサプレッションリストのみをチェックします。このスコープは、バウンスと苦情が記録される場所も制御します。
設定セットの上書き
設定セットSuppressionOptionsの に SuppressionScopeフィールドが含まれるようになりました。設定セットを使用して、スコープのみ、理由のみ、またはその両方を個別に上書きできます。これにより、特定の送信ワークフローの抑制動作をきめ細かく制御できます。テナントのデフォルト設定を変更する必要はありません。
自動サプレッション記録
抑制範囲が の場合TENANT、SES は次のように抑制エントリを自動的に記録します。
-
ハードバウンス – SES は、テナントのサプレッションリストとグローバルサプレッションリストにアドレスを追加します。SES は、アカウントレベルのサプレッションリストにアドレスを追加しません。
-
苦情 – SES はテナントのサプレッションリストにのみアドレスを追加します。
-
スパム以外のフィードバック – 受信者が以前に報告されたメッセージをスパムではないとマークすると、SES はテナントのサプレッションリストから
COMPLAINT- 理由エントリを自動的に削除します。
テナント抑制バウンスの特定
アドレスがテナントのサプレッションリストにあるために SES がメッセージを抑制する場合、次のインジケータを使用してイベントを識別できます。
-
バウンス通知 – バウンスタイプは のサブタイプ
PermanentですOnTenantSuppressionList。 -
Virtual Deliverability Manager (VDM) – バウンス理由は です
ON_TENANT_SUPPRESSION_LIST。 -
診断コード –
"Amazon SES did not send the message to this address because it is on the suppression list for your tenant." -
イベントタグ – イベントが属するテナントを識別できるように、SES はバウンス通知と苦情通知に
ses:tenant-nameタグを追加します。
テナントサプレッションリストエントリの管理
テナントサプレッションリストエントリは、アカウントレベルのエントリに使用するのと同じ API オペレーションを使用して管理します。テナントのサプレッションリストをターゲットにするには、リクエストに TenantNameパラメータを含めます。
-
PutSuppressedDestination– テナントのサプレッションリストにアドレスを追加します。 -
GetSuppressedDestination– テナントの抑制されたアドレスに関する詳細を取得します。 -
DeleteSuppressedDestination– テナントのサプレッションリストからアドレスを削除します。 -
ListSuppressedDestinations– テナントのすべての抑制アドレスを一覧表示します。
TenantName パラメータを省略すると、これらのオペレーションはアカウントレベルのサプレッションリストを対象とします。これにより、既存の統合との下位互換性が維持されます。
考慮事項と制限事項
テナントレベルのサプレッションリストを使用する場合は、次の点に注意してください。
-
マルチテナンシーが必要 – この機能を使用するには、少なくとも 1 つのテナントで SES マルチテナンシーを設定する必要があります。
-
テナントごとに 1 つのリスト – 各テナントには 1 つのサプレッションリストしかありません。テナントとサプレッションリストの間には 1:1 のマッピングがあります。
-
リージョン固有 – テナントサプレッションリストは、設定する AWS リージョン に固有です。
-
アドレスの保持 — 抑制されたアドレスは、明示的に削除するか、SES が自動的に削除するまで (たとえば、受信者が
COMPLAINT-理由エントリのスパム以外のイベントを報告する場合）、テナントのリストに残ります。 -
大文字と小文字を区別するストレージ – サプレッションリストの E メールアドレスは、大文字と小文字が保持された状態で保存されます。サプレッションリスト管理の API コールには、大文字と小文字の完全一致が必要です。
-
送信クォータへの影響 – テナント抑制リストによって抑制されたメッセージは、毎日の送信クォータに対してカウントされます。
-
Gmail 苦情データ – Gmail は苦情データを SES に送信しません。Gmail によってホストされるアドレスは、苦情のサプレッションリストに自動的に追加されません。
-
サンドボックスの制限 – アカウントが本番稼働用アクセス権を持つ
PutSuppressedDestinationまで を呼び出すことはできません。 -
設定のクリア – テナントの抑制設定をクリアするには、スコープと理由の両方で null 値
PutTenantSuppressionAttributesを持つ を呼び出します。 -
テナントの削除 – テナントを削除すると、SES はそのテナントのすべてのサプレッションリストエントリも削除します。
関連リソース
以下のリソースは、SES のサプレッションリストの詳細を確認するのに役立ちます。