本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
管理租户禁止列表条目
您可以使用与账户级禁止列表相同的亚马逊简单电子邮件服务 (SES) Semple Service API 操作来管理租户禁止列表中的条目。要定位特定租户的列表，请在每个请求中包含该--tenant-name参数。省略此参数时，操作将以账户级别列表为目标。使用 AWS CLI 为特定租户添加、检查、移除和列出隐藏的地址。
重要
禁止列表中的电子邮件地址存储时保留大小写。虽然电子邮件发送功能将大小写不同的地址视为相同，但禁止列表管理的 API 调用需要精确的大小写匹配。添加、勾选或删除条目时，请确保使用与禁止列表中显示的电子邮件地址完全相同的大小写。
先决条件
在管理租户禁止列表条目之前，请确保满足以下要求：
-
Tenant-level 已为租户启用抑制。有关更多信息，请参阅 配置租户级抑制。
-
AWS CLI 版本 2 已安装并配置了相应的权限。有关更多信息，请参阅 AWS Command Line Interface 《用户指南》。
-
租户存在于您的 SES 帐户中。
将地址添加到租户的禁止列表中
使用带--tenant-name参数的 PutSuppressedDestination API 操作将电子邮件地址添加到租户的禁止列表中。
要将地址添加到租户的禁止列表中，请使用 AWS CLI
-
在命令行输入以下命令：
在前面的示例中，
recipient@example.com替换为要添加BOUNCE的电子邮件地址、禁止原因（可接受的值为BOUNCE和COMPLAINTMyTenant）以及租户的名称。
成功后，该命令不产生任何输出 (HTTP 200)。该地址现已出现在租户的禁止列表中。
注意
--reason参数接受BOUNCE或COMPLAINT。您可以出于不同的原因添加相同的地址。
检查某个地址是否在租户的禁止列表中
使用带--tenant-name参数的 GetSuppressedDestination API 操作来检查某个电子邮件地址是否在租户的禁止列表中。
要检查某个地址是否在租户的禁止列表中，请使用 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— 包含MessageId和FeedbackId来自导致抑制的事件。这些字段用于自动隐藏的地址，而对于手动添加的条目，则不存在这些字段。
注意
如果该地址不在租户的禁止列表中，API 将返回NotFoundException。
从租户的禁止列表中移除地址
使用带--tenant-name参数的 DeleteSuppressedDestination API 操作将电子邮件地址从租户的禁止列表中删除。
要从租户的禁止列表中删除地址，请使用 AWS CLI
-
在命令行输入以下命令：
在前面的示例中，
recipient@example.com替换为要删除MyTenant的电子邮件地址和租户的姓名。
成功后，该命令不产生任何输出 (HTTP 200)。该地址已从租户的禁止列表中删除。
重要
从租户的禁止列表中删除地址并不会将其从全局禁止列表或账户级别的禁止列表中删除。每个列表都是独立管理的。
在租户的禁止列表中列出地址
使用带--tenant-name参数的 ListSuppressedDestinations API 操作检索特定租户的所有隐藏地址。
要列出租户禁止列表中的所有地址，请使用 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 会自动删除条目：
-
对于被禁止投诉的地址，收到了非垃圾邮件报告。
