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á.
Gerenciando entradas da lista de supressão de inquilinos
Você gerencia entradas na lista de supressão de um inquilino usando as mesmas operações de API do Amazon Simple Email Service (SES) que você usa para a lista de supressão em nível de conta. Para segmentar uma lista específica de inquilinos, inclua o --tenant-name parâmetro em cada solicitação. Quando você omite esse parâmetro, as operações têm como alvo a lista no nível da conta. Use o AWS CLI para adicionar, verificar, remover e listar endereços suprimidos de um inquilino específico.
Importante
Os endereços de e-mail na lista de supressão são armazenados com maiúsculas e minúsculas preservadas. Embora a funcionalidade de envio de e-mail trate endereços com casos diferentes como idênticos, as chamadas de API para gerenciamento de listas de supressão exigem uma correspondência exata de casos. Certifique-se de usar a letra exata do endereço de e-mail conforme ele aparece na lista de supressão ao adicionar, verificar ou remover entradas.
Pré-requisitos
Antes de gerenciar as entradas da lista de supressão de inquilinos, verifique se você atende aos seguintes requisitos:
-
Tenant-level a supressão está ativada para o inquilino. Para obter mais informações, consulte Configurando a supressão em nível de inquilino.
-
AWS CLI a versão 2 é instalada e configurada com as permissões apropriadas. Para obter mais informações, consulte o Guia do usuário do AWS Command Line Interface.
-
O inquilino existe na sua conta SES.
Adicionar um endereço à lista de supressão de um inquilino
Use a operação de PutSuppressedDestination API com o --tenant-name parâmetro para adicionar um endereço de e-mail à lista de supressão do inquilino.
Para adicionar um endereço à lista de supressão de um inquilino usando o AWS CLI
-
Na linha de comando, insira o seguinte comando:
No exemplo anterior,
recipient@example.comsubstitua pelo endereço de e-mail a ser adicionado,BOUNCEpelo motivo da supressão (os valores aceitáveis sãoBOUNCEeCOMPLAINT) e pelo nome do seu inquilino.MyTenant
O comando não produz nenhuma saída em caso de sucesso (HTTP 200). O endereço está agora na lista de supressão do inquilino.
nota
O --reason parâmetro aceita BOUNCE ouCOMPLAINT. Você pode adicionar o mesmo endereço por motivos diferentes.
Verificando se um endereço está na lista de supressão de um inquilino
Use a operação de GetSuppressedDestination API com o --tenant-name parâmetro para verificar se um endereço de e-mail está na lista de supressão do inquilino.
Para verificar se um endereço está na lista de supressão de um inquilino usando o AWS CLI
-
Na linha de comando, insira o seguinte comando:
No exemplo anterior,
recipient@example.comsubstitua pelo endereço de e-mail a ser verificado eMyTenantpelo nome do seu inquilino.
Se o endereço estiver na lista de supressão do inquilino, o comando retornará uma saída semelhante ao exemplo a seguir:
{ "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" } } }
A resposta inclui os seguintes campos:
-
EmailAddress— O endereço de e-mail suprimido. -
Reason— Por que o endereço foi suprimido (BOUNCEouCOMPLAINT). -
LastUpdateTime— Quando a entrada foi atualizada pela última vez. -
Attributes— ContémMessageIde éFeedbackIdproveniente do evento que causou a supressão. Esses campos estão presentes para endereços suprimidos automaticamente e ausentes para entradas adicionadas manualmente.
nota
Se o endereço não estiver na lista de supressão do inquilino, a API retornará a. NotFoundException
Removendo um endereço da lista de supressão de um inquilino
Use a operação de DeleteSuppressedDestination API com o --tenant-name parâmetro para remover um endereço de e-mail da lista de supressão de um inquilino.
Para remover um endereço da lista de supressão de um inquilino usando o AWS CLI
-
Na linha de comando, insira o seguinte comando:
No exemplo anterior,
recipient@example.comsubstitua pelo endereço de e-mail a ser removido eMyTenantpelo nome do seu inquilino.
O comando não produz nenhuma saída em caso de sucesso (HTTP 200). O endereço é removido da lista de supressão do inquilino.
Importante
Remover um endereço da lista de supressão de um inquilino não o remove da lista de supressão global ou da lista de supressão em nível de conta. Cada lista é gerenciada de forma independente.
Listando endereços na lista de supressão de um inquilino
Use a operação de ListSuppressedDestinations API com o --tenant-name parâmetro para recuperar todos os endereços suprimidos de um locatário específico.
Para listar todos os endereços na lista de supressão de um inquilino usando o AWS CLI
-
Na linha de comando, insira o seguinte comando:
No exemplo anterior,
MyTenantsubstitua pelo nome do seu inquilino.
O exemplo de saída a seguir mostra dois endereços suprimidos:
{ "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" } ] }
Filtrando os resultados
Você pode filtrar os resultados por motivo, intervalo de datas ou ambos.
O comando a seguir filtra por motivo:
O comando a seguir filtra por intervalo de datas:
Se a resposta incluir um NextToken valor, use-o em uma solicitação subseqüente para recuperar mais resultados. Use o --page-size parâmetro para controlar o número de resultados por página.
nota
A operação de lista retorna somente informações resumidas. Para obter detalhes completosAttributes, incluindo, use GetSuppressedDestination para endereços individuais.
Entradas de supressão automática
O SES gerencia automaticamente as entradas de supressão com base na configuração de supressão do inquilino. Você não precisa realizar nenhuma ação para entradas automáticas. Eles aparecem na lista de supressão do inquilino junto com as entradas adicionadas manualmente.
O SES adiciona entradas automaticamente nos seguintes casos:
-
Uma rejeição forçada ocorre se a supressão de rejeição estiver ativada para o inquilino.
-
Uma reclamação é recebida se a supressão de reclamações estiver habilitada para o inquilino.
O SES remove automaticamente as entradas no seguinte caso:
-
Uma denúncia de não spam é recebida para um endereço suprimido pela reclamação.
