本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
在 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 會以下列優先順序解析抑制設定，從最高到最低：
-
組態設定 – 如果組態設定指定抑制設定，SES 會使用這些設定。
-
租用戶 – 如果沒有組態集覆寫，SES 會使用租用戶的禁止設定。
-
帳戶 – 如果組態集或租用戶都未指定設定，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 中的禁止名單。
