As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Usando listas de supressão em nível de inquilino no Amazon SES
Se você usa a multilocação do Amazon Simple Email Service (SES) para enviar e-mails em nome de vários inquilinos, você pode dar a cada inquilino sua própria lista de supressão. Tenant-level a supressão isola rejeições e reclamações para que elas afetem somente o inquilino que enviou o e-mail. Sem esse recurso, todos os inquilinos compartilham a lista de supressão no nível da conta. Quando um destinatário devolve ou reclama do e-mail de um inquilino, esse endereço é suprimido para cada inquilino na conta. Tenant-level a supressão evita essa contaminação entre inquilinos, mantendo uma lista separada de endereços suprimidos para cada inquilino.
## Como funciona a supressão em nível de inquilino
*Duas configurações controlam o comportamento de supressão para cada inquilino: *escopo da supressão e motivos suprimidos*.* Você define as duas configurações em conjunto usando a operação de `PutTenantSuppressionAttributes` API ou especificando `SuppressionAttributes` quando você cria um inquilino com a operação de `CreateTenant` API.
O **escopo da supressão** determina qual lista de supressão o SES usa para o inquilino:
+ `TENANT`— Use a própria lista de supressão do inquilino.
+ `ACCOUNT`— Use a lista de supressão no nível da conta. Esse é o padrão para inquilinos existentes e novos.
Os **motivos suprimidos** determinam quais eventos fazem com que o SES adicione endereços à lista de supressão:
+ `BOUNCE`— Adicione endereços que produzam rejeições difíceis.
+ `COMPLAINT`— Adicione endereços que gerem reclamações.
+ `BOUNCE`e `COMPLAINT` — Adicione endereços que produzam qualquer um dos eventos.
+ Vazio — Não verifique nem registre em nenhuma lista de supressão.
**nota**
Você deve fornecer `SuppressionScope` e `SuppressedReasons` em conjunto, ou definir ambos como nulos. Definir ambos como nulos limpa as configurações de supressão do inquilino e retorna o inquilino ao comportamento padrão do escopo. `ACCOUNT`
### Comportamento de supressão por configuração
A tabela a seguir descreve o horário de envio e o comportamento de gravação para cada combinação de escopo de supressão e motivos suprimidos.
| Escopo | Motivos | Send-time comportamento | Comportamento de gravação |
| --- | --- | --- | --- |
| TENANT | BOUNCE, COMPLAINT | Verifica a lista de inquilinos em busca de devoluções e reclamações | Registra ambos na lista de inquilinos |
| TENANT | BOUNCE | Verifica apenas as devoluções na lista de inquilinos | Os registros são retornados somente para a lista de inquilinos |
| TENANT | COMPLAINT | Verifica apenas reclamações na lista de inquilinos | Registra reclamações somente na lista de inquilinos |
| TENANT | Vazio | Sem verificação de supressão | Sem gravação |
| ACCOUNT | BOUNCE, COMPLAINT | Verifica a lista de contas em busca de devoluções e reclamações | Registra ambos na lista de contas |
| ACCOUNT | BOUNCE | Verifica a lista de contas somente para devoluções | Os registros são devolvidos somente para a lista de contas |
| ACCOUNT | COMPLAINT | Verifica a lista de contas apenas para reclamações | Registra reclamações somente na lista de contas |
| ACCOUNT | Vazio | Sem verificação de supressão | Sem gravação |
## Precedência de supressão e comportamento no horário de envio
O SES resolve as configurações de supressão na seguinte ordem de precedência, da maior para a menor:
1. **Conjunto de configurações** — Se o conjunto de configurações especificar configurações de supressão, o SES usará essas configurações.
1. **Locatário** — Se nenhuma substituição do conjunto de configurações existir, o SES usa as configurações de supressão do inquilino.
1. **Conta** — Se nem o conjunto de configurações nem o inquilino especificarem as configurações, o SES usará os padrões em nível de conta.
**Importante**
O escopo da supressão determina qual lista de supressão o SES verifica no momento do envio. Quando o escopo é`TENANT`, o SES verifica somente a lista de supressão do inquilino e ignora a lista de supressão no nível da conta. Um endereço que está na lista de supressão no nível da conta, mas não na lista de supressão do inquilino, não é suprimido. Quando o escopo é`ACCOUNT`, o SES verifica somente a lista de supressão no nível da conta. O escopo também controla onde as devoluções e reclamações são registradas.
### Substituições do conjunto de configurações
O `SuppressionOptions` para um conjunto de configurações agora inclui um `SuppressionScope` campo. Você pode usar um conjunto de configurações para substituir somente o escopo, somente os motivos ou ambos de forma independente. Isso proporciona um controle refinado sobre o comportamento de supressão para fluxos de trabalho de envio específicos. Você não precisa alterar as configurações padrão do inquilino.
## Gravação automática de supressão
Quando o escopo da supressão é`TENANT`, o SES registra automaticamente as entradas de supressão da seguinte forma:
+ Devoluções **forçadas —** O SES adiciona o endereço à lista de supressão do inquilino e à lista de supressão global. O SES *não* adiciona o endereço à lista de supressão em nível de conta.
+ **Reclamações** — A SES adiciona o endereço somente à lista de supressão do inquilino.
+ **Not-spam feedback** — Quando um destinatário marca uma mensagem relatada anteriormente como não sendo spam, o SES remove automaticamente as entradas `COMPLAINT` -reason da lista de supressão do inquilino.
## Identificando os saltos de supressão de inquilinos
Quando o SES suprime uma mensagem porque o endereço está na lista de supressão do inquilino, você pode identificar o evento usando os seguintes indicadores:
+ **Notificação de rejeição** — O tipo de rejeição está `Permanent` com um subtipo de. `OnTenantSuppressionList`
+ **Virtual Deliverability Manager (VDM)** — O motivo da rejeição é. `ON_TENANT_SUPPRESSION_LIST`
+ **Código de diagnóstico** — `"Amazon SES did not send the message to this address because it is on the suppression list for your tenant."`
+ **Tag de evento** — O SES adiciona uma `ses:tenant-name` tag às notificações de devolução e reclamação para que você possa identificar a qual inquilino o evento pertence.
## Gerenciando entradas da lista de supressão de inquilinos
Você gerencia as entradas da lista de supressão de inquilinos usando as mesmas operações de API que você usa para entradas no nível da conta. Para direcionar a lista de supressão de um inquilino, inclua o `TenantName` parâmetro em sua solicitação:
+ `PutSuppressedDestination`— Adicione um endereço à lista de supressão de um inquilino.
+ `GetSuppressedDestination`— Recupere detalhes sobre um endereço suprimido de um inquilino.
+ `DeleteSuppressedDestination`— Remover um endereço da lista de supressão de um inquilino.
+ `ListSuppressedDestinations`— Liste todos os endereços suprimidos de um inquilino.
Se você omitir o `TenantName` parâmetro, essas operações terão como alvo a lista de supressão no nível da conta. Isso mantém a compatibilidade com versões anteriores das integrações existentes.
## Considerações e limitações
Lembre-se do seguinte ao usar listas de supressão em nível de inquilino:
+ **Multi-tenancy obrigatório** — Você deve ter a multilocação do SES configurada com pelo menos um inquilino para usar esse recurso.
+ **Uma lista por inquilino** — Cada inquilino tem exatamente uma lista de supressão. Há um mapeamento 1:1 entre inquilinos e listas de supressão.
+ **Region-specific**— As listas de supressão de inquilinos são específicas para as Região da AWS quais você as configura.
+ **Os endereços persistem** — os endereços suprimidos permanecem na lista do inquilino até que você os remova explicitamente ou até que o SES os remova automaticamente (por exemplo, quando um destinatário relata um evento sem spam por uma entrada com um motivo). `COMPLAINT`
+ **Case-sensitive armazenamento** — Os endereços de e-mail na lista de supressão são armazenados com maiúsculas e minúsculas preservadas. As chamadas de API para gerenciamento de listas de supressão exigem uma correspondência exata de casos.
+ **Impacto da cota de envio** — As mensagens suprimidas por uma lista de supressão de inquilinos são contabilizadas na sua cota de envio diária.
+ **Dados de reclamação do Gmail** — O Gmail não envia dados de reclamação ao SES. Os endereços hospedados pelo Gmail não são adicionados automaticamente à lista de supressão de reclamações.
+ **Restrições do sandbox** — Você não pode ligar `PutSuppressedDestination` até que sua conta tenha acesso à produção.
+ **Limpando configurações** — Para limpar as configurações de supressão de um inquilino, chame `PutTenantSuppressionAttributes` com valores nulos por escopo e motivos.
+ **Excluindo um inquilino** — Quando você exclui um inquilino, o SES também exclui todas as entradas da lista de supressão desse inquilino.
## Recursos relacionados
Os recursos a seguir podem ajudá-lo a aprender mais sobre as listas de supressão no SES.
+ [Como usar a lista de supressão do Amazon SES por conta](sending-email-suppression-list.md)
+ [Lista de supressão global do Amazon SES](sending-email-global-suppression-list.md)