本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在 Amazon SES 中使用租户级别的禁止列表
如果您使用 Amazon Simple Email Service (SES) 多租户代表多个租户发送电子邮件，则可以为每个租户提供自己的禁止列表。 Tenant-level 抑制可以隔离退信和投诉，因此它们仅影响发送电子邮件的租户。如果没有此功能，则所有租户都共享账户级别的禁止列表。当收件人退回或抱怨一个租户的电子邮件时，该账户中每个租户的该地址都将被隐藏。 Tenant-level 抑制通过为每个租户维护一个单独的禁止地址列表来防止这种跨租户污染。
## 租户级抑制的工作原理
两个设置控制每个租户的抑制行为：*抑制范围*和*隐藏原因*。您可以使用 `PutTenantSuppressionAttributes` API 操作同时配置这两个设置，也可以通过 AP `CreateTenant` I 操作指定`SuppressionAttributes`何时创建租户。
**抑制范围**决定了 SES 为租户使用哪个抑制列表：
+ `TENANT`— 使用租户自己的禁止列表。
+ `ACCOUNT`— 使用账户级别的禁止列表。这是现有租户和新租户的默认设置。
**抑制原因**决定了哪些事件导致 SES 将地址添加到禁止列表中：
+ `BOUNCE`— 添加会产生硬退件的地址。
+ `COMPLAINT`— 添加产生投诉的地址。
+ `BOUNCE`和 `COMPLAINT`-添加产生任一事件的地址。
+ 空 — 不要勾选或记录到任何禁止列表中。
**注意**
必须`SuppressedReasons`同时提供`SuppressionScope`和，或者将两者都设置为空。将两者都设置为 null 会清除租户的抑制设置，并将租户恢复到默认`ACCOUNT`范围行为。
### 按配置抑制行为
下表描述了抑制范围和隐含原因的每种组合的发送时间和录制行为。
| Scope | 原因 | Send-time 行为 | 录制行为 |
| --- | --- | --- | --- |
| 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 仅检查账户级别的禁止列表。该范围还控制退回和投诉的记录位置。
### 配置集覆盖
配置集的现在包含一个`SuppressionScope`字段。`SuppressionOptions`您可以使用配置集来仅覆盖作用域、仅覆盖原因，或单独使用两者。这使您可以精细地控制特定发送工作流程的抑制行为。您无需更改租户的默认设置。
## 自动抑制录音
当抑制范围为时`TENANT`，SES 会自动记录抑制条目，如下所示：
+ **硬退回 — SES** 将地址添加到租户的禁止列表和全局禁止列表中。SES *不会*将该地址添加到账户级别的禁止列表中。
+ **投诉** — SES 仅将该地址添加到租户的禁止列表中。
+ **Not-spam 反馈** — 当收件人将之前报告的邮件标记为非垃圾邮件时，SES 会自动从租户的禁止列表中删除 `COMPLAINT`-reason 条目。
## 识别租户抑制反弹
当 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`参数，则这些操作将针对账户级别的禁止列表。这样可以保持与现有集成的向后兼容性。
## 注意事项和限制
使用租户级抑制列表时，请记住以下几点：
+ **Multi-tenancy 必需** — 您必须将 SES 多租户配置为至少一个租户才能使用此功能。
+ **每个租户一个列表**-每个租户只有一个禁止列表。租户和禁止列表之间有 1:1 的映射。
+ **Region-specific**— 租户抑制列表特定 AWS 区域 于您在其中配置这些列表的列表。
+ **地址保留** — 被禁止的地址会一直保留在租户的列表中，直到您明确将其移除或 SES 自动将其删除（例如，当收件人为 `COMPLAINT`-reason 条目报告非垃圾邮件事件时）。
+ **Case-sensitive 存储**-禁止列表中的电子邮件地址在存储时保留大小写。禁止列表管理的 API 调用需要精确的大小写匹配。
+ **发送配额影响**-租户抑制列表禁止的邮件计入您的每日发送配额。
+ **Gmail 投诉数据** — Gmail 不会向 SES 发送投诉数据。Gmail 托管的地址不会自动添加到禁止投诉列表中。
+ **沙盒限制** — 只有在您的账户拥有生产访问权限`PutSuppressedDestination`之前，您才能拨打沙盒电话。
+ **清除设置**-要清除租户的禁止设置，请`PutTenantSuppressionAttributes`出于范围和原因使用空值进行调用。
+ **删除租户**-删除租户时，SES 还会删除该租户的所有禁止列表条目。
## 相关资源
以下资源可以帮助您详细了解 SES 中的禁止列表。
+ [使用 Amazon SES 账户级黑名单](sending-email-suppression-list.md)
+ [Amazon SES 全局黑名单](sending-email-global-suppression-list.md)