本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 Amazon SES 中使用租戶層級禁止名單
如果您使用 Amazon Simple Email Service (SES) 多租用戶代表多個租用戶傳送電子郵件，您可以為每個租用戶提供自己的禁止名單。租用戶層級禁止隔離退信和投訴，以便它們僅影響傳送電子郵件的租用戶。如果沒有此功能，所有租戶都會共用帳戶層級禁止名單。當收件人退信或抱怨某個租戶的電子郵件時，帳戶的每個租戶都會隱藏該地址。租用戶層級禁止透過維護每個租用戶的個別禁止地址清單，來防止此跨租用戶污染。
## 租用戶層級禁止的運作方式
每個租用戶的兩個設定控制抑制行為：*抑制範圍*和*抑制原因*。您可以使用 `PutTenantSuppressionAttributes` API 操作來同時設定這兩個設定，或在建立具有 `CreateTenant` API 操作的租用戶`SuppressionAttributes`時指定 。
**禁止範圍**決定 SES 用於租用戶的禁止名單：
+ `TENANT` – 使用租戶自己的禁止名單。
+ `ACCOUNT` – 使用帳戶層級禁止名單。這是現有租用戶和新租用戶的預設值。
**隱藏原因**決定哪些事件導致 SES 將地址新增至禁止名單：
+ `BOUNCE` – 新增產生硬退信的地址。
+ `COMPLAINT` – 新增產生投訴的地址。
+ `BOUNCE` 和 `COMPLAINT` – 新增產生任一事件的地址。
+ 空白 – 不要檢查或記錄任何禁止名單。
**注意**
您必須`SuppressedReasons`同時提供 `SuppressionScope`和 ，或將兩者設定為 null。將兩者設定為 null 會清除租用戶的禁止設定，並將租用戶傳回預設`ACCOUNT`範圍行為。
### 依組態的抑制行為
下表說明每個禁止範圍和禁止原因組合的傳送時間和記錄行為。
| Scope (範圍) | 原因 | 傳送時間行為 | 錄製行為 |
| --- | --- | --- | --- |
| TENANT | BOUNCE, COMPLAINT | 檢查租戶清單是否有退信和投訴 | 同時記錄到租戶清單 |
| TENANT | BOUNCE | 僅檢查租戶清單是否有退信 | 僅記錄對租戶清單的退信 |
| TENANT | COMPLAINT | 僅檢查租戶清單是否有投訴 | 僅記錄對租戶清單的投訴 |
| TENANT | 空白 | 無抑制檢查 | 無錄製 |
| ACCOUNT | BOUNCE, COMPLAINT | 檢查帳戶清單是否有退信和投訴 | 記錄到帳戶清單 |
| ACCOUNT | BOUNCE | 僅檢查帳戶清單是否有退信 | 僅記錄對帳戶清單的退信 |
| ACCOUNT | COMPLAINT | 僅檢查帳戶清單是否有投訴 | 僅將投訴記錄到帳戶清單 |
| ACCOUNT | 空白 | 無抑制檢查 | 無錄製 |
## 隱藏優先順序和傳送時間行為
SES 會以下列優先順序解析抑制設定，從最高到最低：
1. **組態設定** – 如果組態設定指定抑制設定，SES 會使用這些設定。
1. **租用戶** – 如果沒有組態集覆寫，SES 會使用租用戶的禁止設定。
1. **帳戶** – 如果組態集或租用戶都未指定設定，SES 會使用帳戶層級預設值。
**重要**
禁止範圍會決定傳送時哪些禁止清單 SES 檢查。當範圍為 時`TENANT`，SES 只會檢查租戶的禁止名單，並略過帳戶層級禁止名單。不會隱藏在帳戶層級禁止名單上的地址，但不在租戶禁止名單上的地址。當範圍為 時`ACCOUNT`，SES 只會檢查帳戶層級禁止名單。範圍也會控制記錄退信和投訴的位置。
### 組態設定覆寫
組態設定`SuppressionOptions`的 現在包含 `SuppressionScope` 欄位。您可以使用組態設定來僅覆寫範圍、僅覆寫原因，或獨立覆寫兩者。這可讓您針對特定傳送工作流程的抑制行為進行精細控制。您不需要變更租戶的預設設定。
## 自動禁止記錄
當禁止範圍為 時`TENANT`，SES 會自動記錄禁止項目，如下所示：
+ **硬退信** – SES 會將地址新增至租戶的禁止名單和全域禁止名單。SES *不會*將地址新增至帳戶層級禁止名單。
+ **投訴** – SES 只會將地址新增至租戶的禁止名單。
+ **非垃圾郵件回饋** – 當收件人將先前回報的訊息標記為非垃圾郵件時，SES 會自動從租戶的禁止名單中移除 `COMPLAINT`原因項目。
## 識別租戶禁止退信
當 SES 由於地址在租戶的禁止名單上而隱藏訊息時，您可以使用下列指標來識別事件：
+ **退信通知** – 退信類型為 `Permanent` 的子類型`OnTenantSuppressionList`。
+ **虛擬可交付性管理員 (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` 參數，這些操作會以帳戶層級禁止名單為目標。這可維持與現有整合的回溯相容性。
## 考量和限制
當您使用租戶層級禁止名單時，請記住下列事項：
+ **需要多租用戶** – 您必須設定至少一個租用戶的 SES 多租用戶，才能使用此功能。
+ **每個租用戶一個清單** – 每個租用戶只有一個禁止清單。租用戶和禁止名單之間有 1：1 映射。
+ **區域特定** – 租用戶禁止名單專屬於您在 AWS 區域 其中設定它們的 。
+ **地址保留** – 隱藏的地址會保留在租戶的清單中，直到您明確移除或 SES 自動移除為止 （例如，當收件人回報 `COMPLAINT`原因項目的非垃圾郵件事件時）。
+ **區分大小寫的儲存** – 禁止名單上的電子郵件地址會保留大小寫。用於禁止名單管理的 API 呼叫需要完全符合大小寫。
+ **傳送配額影響** – 租用戶禁止名單隱藏的訊息會計入您的每日傳送配額。
+ **Gmail 投訴資料** – Gmail 不會將投訴資料傳送至 SES。Gmail 託管的地址不會自動新增至投訴的禁止名單。
+ **沙盒限制** – 在您的帳戶具有生產存取權`PutSuppressedDestination`之前，您無法呼叫 。
+ **清除設定** – 若要清除租戶的禁止設定，請針對範圍和原因`PutTenantSuppressionAttributes`使用 null 值呼叫 。
+ **刪除租用戶** – 當您刪除租用戶時，SES 也會刪除該租用戶的所有禁止名單項目。
## 相關資源
下列資源可協助您進一步了解 SES 中的禁止名單。
+ [使用 Amazon SES 帳戶層次禁止名單](sending-email-suppression-list.md)
+ [Amazon SES 全域禁止名單](sending-email-global-suppression-list.md)