本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
管理租戶禁止名單項目
您可以使用用於帳戶層級禁止名單的相同 Amazon Simple Email Service (SES) API 操作，來管理租戶禁止名單上的項目。若要以特定租戶清單為目標，請在每個請求中包含 --tenant-name 參數。當您省略此參數時，操作會以帳戶層級清單為目標。使用 AWS CLI 新增、檢查、移除和列出特定租用戶的隱藏地址。
重要
禁止名單上的電子郵件地址會存放並保留大小寫。雖然電子郵件傳送功能將具有不同案例的地址視為相同，但用於禁止名單管理的 API 呼叫需要完全符合案例。當您新增、檢查或移除項目時，請務必使用隱藏清單中顯示的電子郵件地址的確切大小寫。
先決條件
在管理租戶禁止名單項目之前，請確定您符合下列要求：
-
租用戶層級禁止已啟用租用戶。如需詳細資訊，請參閱設定租戶層級禁止。
-
AWS CLI 第 2 版已安裝並設定了適當的許可。如需詳細資訊，請參閱「AWS Command Line Interface 使用者指南」。
-
租用戶存在於您的 SES 帳戶中。
將地址新增至租戶的禁止名單
使用 PutSuppressedDestination API 操作搭配 --tenant-name 參數，將電子郵件地址新增至租戶的禁止名單。
使用 將地址新增至租戶的禁止名單 AWS CLI
-
在命令列中輸入以下命令：
在上述範例中，將
recipient@example.com取代為要新增的電子郵件地址、將BOUNCE取代為禁止原因 （可接受的值為BOUNCE和COMPLAINT)，並將MyTenant取代為租戶的名稱。
命令在成功時不會產生輸出 (HTTP 200)。地址現在位於租戶的禁止名單上。
注意
--reason 參數接受 BOUNCE或 COMPLAINT。您可以新增具有不同原因的相同地址。
檢查地址是否在租戶的禁止名單上
使用 GetSuppressedDestination API 操作搭配 --tenant-name 參數，檢查電子郵件地址是否在租戶的禁止名單中。
使用 檢查地址是否在租戶的禁止名單上 AWS CLI
-
在命令列中輸入以下命令：
在上述範例中，將
recipient@example.com取代為要檢查的電子郵件地址，並將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– 隱藏的電子郵件地址。 -
Reason– 為什麼地址遭到隱藏 (BOUNCE或COMPLAINT)。 -
LastUpdateTime– 上次更新項目的時間。 -
Attributes– 包含來自造成抑制之事件的FeedbackIdMessageId和 。這些欄位適用於自動隱藏的地址，而缺少手動新增的項目。
注意
如果地址不在租戶的禁止名單上，API 會傳回 NotFoundException。
從租戶的禁止名單中移除地址
使用 DeleteSuppressedDestination API 操作搭配 --tenant-name 參數，從租戶的禁止名單中移除電子郵件地址。
使用 從租戶的禁止名單中移除地址 AWS CLI
-
在命令列中輸入以下命令：
在上述範例中，將
recipient@example.com取代為要移除的電子郵件地址，並將MyTenant取代為租戶的名稱。
命令在成功時不會產生輸出 (HTTP 200)。地址會從租戶的禁止名單中移除。
重要
從租戶的禁止名單中移除地址並不會從全域禁止名單或帳戶層級禁止名單中移除。每個清單都會獨立管理。
列出租戶禁止名單上的地址
使用 ListSuppressedDestinations API 操作搭配 --tenant-name 參數來擷取特定租用戶的所有隱藏地址。
使用 列出租戶禁止名單上的所有地址 AWS CLI
-
在命令列中輸入以下命令：
在上述範例中，將
MyTenant取代為您的租用戶名稱。
下列範例輸出顯示兩個禁止的地址：
{ "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 會自動移除項目：
-
收到投訴抑制地址的非垃圾郵件報告。
