Como usar a lista de supressão do Amazon SES por conta

A lista de supressão em nível de conta do Amazon SES foi introduzida para que os clientes possam criar e controlar sua própria lista de supressão e gerenciar sua reputação; portanto, a lista de supressão em nível de conta é aplicada somente à sua conta. A interface da lista de supressão por conta no console do SES fornece uma maneira fácil de gerenciar endereços em sua lista de supressão por conta, incluindo ações em massa para adicionar ou remover endereços.

A lista de supressão no nível da conta do SES é aplicada à sua Conta da AWS na Região da AWS atual. Você pode adicionar ou remover, individualmente ou em massa, endereços da lista de supressão no nível da conta usando o console ou a API v2 do SES.

nota

Para adicionar ou remover endereços em massa, você deve ter acesso de produção. Para saber mais sobre a sandbox, consulte Solicitar acesso à produção (sair da sandbox do Amazon SES).

Importante

As listas de supressão de contas SES diferenciam maiúsculas de minúsculas. Quando um endereço de e-mail é adicionado à lista de supressão, User@Example.com, ele é armazenado exatamente como recebido, preservando a caixa original. Embora a funcionalidade de envio de e-mail trate endereços com casos diferentes como idênticos, por exemplo, User@Example.com é o mesmo que user@example.com, as chamadas de API para gerenciamento de listas de supressão exigem uma correspondência exata de casos. Portanto, ao usar APIs relacionado ao gerenciamento da lista de supressão, certifique-se de usar a letra exata do endereço de e-mail conforme ele aparece na lista de supressão.

Considerações sobre a lista de supressão do Amazon SES por conta

Você deve considerar os seguintes fatores ao usar a lista de supressão no nível da conta:

Se você começou a usar o Amazon SES após 25 de novembro de 2019, sua conta usa a lista de supressão no nível da conta por padrão tanto para devoluções como para reclamações. Se tiver começado a usar o SES antes dessa data, é necessário habilitar esse recurso usando a operação PutAccountSuppressionAttributes na API do SES.
Se você tentar enviar uma mensagem a um endereço que está na lista de supressão em nível de conta e tenha um motivo de supressão que corresponde ao mesmo motivo de supressão escolhido em Configurações em nível de conta, o SES aceitará a mensagem, mas não a enviará. Entretanto, se não houver correspondência, o SES vai enviá-la. Para ajudar a elucidar isso, os seguintes exemplos são fornecidos:
- Você definiu as configurações de supressão em nível de conta com o motivo de supressão Somente devoluções. O SES não tentará entregar para endereços na lista de supressão em nível de conta com o motivo de supressão Devolução. No entanto, a SES tentará a entrega de endereços em sua lista de supressão em nível de conta com o motivo da supressão da Reclamação (porque, nesse caso, eles não coincidem).
- Você definiu as configurações de supressão em nível de conta com o motivo de supressão Devoluções e reclamações, então o SES não tentará entregar para endereços na lista de supressão em nível de conta com o motivo de supressão Devolução ou Reclamação.
O SES não contabiliza as mensagens que você envia para os endereços da sua lista de supressão em nível de conta na Reputação. BounceRateou reputação. ComplaintRatemétricas no namespace AWS/SES da sua conta. Essas mensagens são contabilizadas nas métricas Bounce ou Complaint no namespace AWS/SES.
Se um endereço estiver na lista de supressão global, mas não na lista de supressão no nível da sua conta (o que significa que você quer enviar para ele), e você enviar para ele mesmo assim, o SES tentará realizar a entrega. No entanto, se voltar, a tentativa de envio será contabilizada na taxa de rejeição da conta e na cota diária de envio.
O SES contabiliza as mensagens enviadas para endereços na lista de supressão no nível da conta na sua cota de envio diário.
Os endereços de e-mail na lista de supressão no nível da conta são mantidos ali até que você os remova.
Se a capacidade de envio de e-mails da sua conta for pausada, o SES excluirá automaticamente os endereços na lista de supressão no nível da conta após 90 dias. Se a capacidade da conta de enviar e-mails for restaurada antes do término desse período de 90 dias, os endereços da lista não serão excluídos.
O Gmail não fornece dados de reclamação para o SES. Se um destinatário usar o botão Spam no cliente Web do Gmail para denunciar uma mensagem recebida de você como spam, ele não será adicionado à lista de supressão no nível da conta.
Você poderá habilitar a lista de supressão no nível da conta se a sua conta estiver no sandbox do SES. No entanto, você não pode usar a CreateImportJoboperação PutSuppressedDestinationor até que sua conta seja removida da sandbox. Para saber mais sobre a sandbox, consulte Solicitar acesso à produção (sair da sandbox do Amazon SES).
Somente as devoluções definitivas são adicionadas à lista de supressão no nível da conta. Para obter informações sobre as diferenças entre devoluções flexíveis e definitivas, consulte Depois que o Amazon SES envia um e-mail.
Quando você usa a lista de supressão em nível de conta, o SES adiciona endereços que também resultam em devoluções definitivas à lista de supressão global.

nota

Os procedimentos nas seções a seguir pressupõem que você já tenha instalado AWS CLI o. Para obter mais informações sobre como instalar e configurar o AWS CLI, consulte o Guia do AWS Command Line Interface usuário.

Como habilitar a lista de supressão do Amazon SES por conta

Você pode usar a PutAccountSuppressionAttributesoperação na API v2 do Amazon SES para habilitar e configurar sua lista de supressão em nível de conta. É possível definir essa configuração de forma rápida e fácil usando a AWS CLI. Para obter mais informações sobre a instalação e a configuração da AWS CLI, consulte o Guia do usuário da AWS Command Line Interface.

Para configurar sua lista de supressão em nível de conta usando o AWS CLI

Na linha de comando, insira o seguinte comando:
Linux, macOS, or Unix
```
aws sesv2 put-account-suppression-attributes \
--suppressed-reasons BOUNCE COMPLAINT
```
Windows
```
aws sesv2 put-account-suppression-attributes `
--suppressed-reasons BOUNCE COMPLAINT
```
Para habilitar a lista de supressão no nível da conta, é necessário especificar pelo menos um motivo para o parâmetro suppressed-reasons. É possível especificar BOUNCE ou COMPLAINT ou ambos, conforme mostrado no exemplo anterior.

Como configurar a lista de supressão no nível da conta usando o console do SES:

Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.
No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).
No painel Account-level settings (Configurações no nível da conta), escolha Edit (Editar).
Em Suppression list, desmarque a caixa Enabled.
Em Suppression reasons (Motivos da supressão), selecione um dos motivos pelos quais os endereços de e-mail do destinatário devem ser adicionados automaticamente à sua lista de supressão no nível da conta.
Escolha Salvar alterações.

Como habilitar a lista de supressão do Amazon SES por conta para um conjunto de configurações

Também é possível configurar a supressão por conta do Amazon SES para que ela seja aplicável exclusivamente a conjuntos de configuração específicos. Quando fizer isso, os endereços serão adicionados à lista de supressão somente se você tiver especificado o conjunto de configurações quando enviar o e-mail que gerou a devolução ou a reclamação.

Para configurar sua lista de supressão em nível de conta para um conjunto de configurações usando o AWS CLI

Na linha de comando, insira o seguinte comando:

No exemplo anterior, configSet substitua pelo nome do conjunto de configurações que deve usar sua lista de supressão em nível de conta.

Para configurar a lista de supressão no nível da conta para um conjunto de configurações usando o console do SES:

Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.
No painel de navegação, em Configuration (Configuração), escolha Configuration sets (Conjuntos de configurações).
Em Configuration sets (Conjuntos de configurações), escolha o nome do conjunto de configurações que deseja configurar com supressão personalizada.
No painel Supression list options (Opções de lista de supressão), escolha Edit (Editar).
A seção Supression list options (Opções de lista de supressão) fornece um conjunto de decisões para definir a supressão personalizada, começando com a opção de usar esse conjunto de configurações para substituir a supressão no nível da conta. O configuration set-level suppression logic map (mapa lógico de supressão no nível do conjunto de configurações) ajudará você a entender os efeitos das combinações de substituição. Essas seleções em várias camadas de substituições podem ser combinadas para implementar três níveis diferentes de supressão:
1. Use account-level supression (Usar supressão no nível da conta): Não substituir a supressão no nível da conta e não implementar nenhuma supressão no nível do conjunto de configurações - basicamente, qualquer e-mail enviado usando esse conjunto de configurações usará apenas a supressão no nível da conta. Para fazer isso:
  1. Em Suppression list settings (Configurações da lista de supressão), desmarque a caixa Override account level settings (Substituir configurações no nível de conta).
2. Do not use any suppression (Não usar nenhuma supressão): Substituir sua supressão no nível da conta sem habilitar nenhuma supressão no nível do conjunto de configurações - isso significa que qualquer e-mail enviado usando este conjunto de configurações não usará nenhuma supressão no nível da conta; em outras palavras, toda a supressão é cancelada. Para fazer isso:
  1. Em Suppression list settings (Configurações da lista de supressão), marque a caixa Override account level settings (Substituir configurações no nível de conta).
  2. Em Suppression list (Lista de supressão), desmarque a caixa Enabled (Habilitada).
3. Use configuration set-level suppression (Usar a supressão no nível do conjunto de configurações): Substitui a supressão no nível da conta por configurações de lista de supressão personalizadas definidas neste conjunto de configurações - isso significa que qualquer e-mail enviado usando esse conjunto de configurações usará apenas suas próprias configurações de supressão e ignorará qualquer configuração de supressão no nível da conta. Para fazer isso:
  1. Em Suppression list settings (Configurações da lista de supressão), marque a caixa Override account level settings (Substituir configurações no nível de conta).
  2. Em Suppression list (Lista de supressão), marque Enabled (Habilitada).
  3. Em Specify the reason(s)… (Especificar o(s) motivo(s)..., selecione um dos motivos de supressão para esse conjunto de configurações usar.
Escolha Salvar alterações.

Como adicionar endereços de e-mail individuais à lista de supressão do Amazon SES por conta

Você pode adicionar endereços individuais à sua lista de supressão em nível de conta do Amazon SES usando a PutSuppressedDestinationoperação na API SES v2. Não há limite para o número de endereços que você pode adicionar à lista de supressão no nível da conta.

Como adicionar endereços individuais à lista de supressão no nível da conta usando a AWS CLI

Na linha de comando, insira o seguinte comando:
Linux, macOS, or Unix
```
aws sesv2 put-suppressed-destination \
--email-address recipient@example.com \
--reason BOUNCE
```
Windows
```
aws sesv2 put-suppressed-destination `
--email-address recipient@example.com `
--reason BOUNCE
```
No exemplo anterior, recipient@example.com substitua pelo endereço de e-mail que você deseja adicionar à sua lista de supressão no nível da conta e BOUNCE pelo motivo pelo qual você está adicionando o endereço à lista de supressão (os valores aceitáveis são e). BOUNCE COMPLAINT

Como adicionar endereços individuais à lista de supressão no nível da conta usando o console do SES:

Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.
No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).
No painel Suppression list (Lista de supressão), escolha Add email address (Adicionar endereço de e-mail).
Digite um endereço de e-mail no campo Email address (Endereço de e-mail) seguido da seleção de um motivo em Suppresion reason (Motivo da supressão). Se precisar inserir mais endereços, escolha Enter another address (Inserir outro endereço) e repita a operação para cada endereço adicional.
Quando terminar de inserir endereços, revise a precisão de suas entradas. Se decidir que alguma de suas entradas não deve integrar esse envio, escolha o botão Remove (Remover).
Escolha Save changes (Salvar as alterações) para adicionar os endereços de e-mail inseridos à sua lista de supressão por conta.

Adicionar endereços de e-mail em massa à lista de supressão no nível da conta do Amazon SES

Você pode adicionar endereços em massa fazendo primeiro o upload da sua lista de contatos em um objeto do Amazon S3 e, em seguida, usando CreateImportJoba operação na API v2 do Amazon SES.

nota

Não há limite para o número de endereços que você pode adicionar à lista de supressão no nível da conta, mas há um limite de adição em lote de 100.000 de endereços em um objeto do Amazon S3 por chamada de API.
Você não pode executar mais de 20 trabalhos de importação simultâneos.
Se sua fonte de dados for um bucket do S3, ela deverá existir na mesma região para a qual você está importando.

Para adicionar endereços de e-mail em lote à lista de supressão no nível da conta, conclua as etapas a seguir.

Carregue a lista de endereços em um objeto do Amazon S3 no formato CSV ou JSON.

Exemplo de formato CSV para adicionar endereços:

recipient1@example.com,BOUNCE

recipient2@example.com,COMPLAINT

Somente arquivos JSON delimitados por nova linha são suportados. Nesse formato, cada linha é um objeto JSON completo que contém uma definição de endereço individual.

Exemplo de formato JSON para adicionar endereços:

{"emailAddress":"recipient1@example.com","reason":"BOUNCE"}

{"emailAddress":"recipient2@example.com","reason":"COMPLAINT"}

Nos exemplos anteriores, substitua recipient1@example.com e pelos endereços recipient2@example.com de e-mail que você deseja adicionar à sua lista de supressão no nível da conta. Os motivos aceitáveis pelos quais você está adicionando os endereços à lista de supressão são BOUNCE e COMPLAINT.
Conceda permissão ao SES para usar sua chave do AWS KMS .

Se o objeto do Amazon S3 estiver criptografado com uma AWS KMS chave, você precisará dar permissão ao Amazon SES para usar a AWS KMS chave. O SES só pode obter permissão de uma chave gerenciada pelo cliente, não de uma chave padrão do KMS. Você precisa conceder permissão ao SES para usar a chave gerenciada pelo cliente, adicionando uma instrução à política da chave.

Cole a seguinte instrução de política na política de chave para permitir que o SES use sua chave gerenciada pelo cliente.
```
{
   "Sid": "AllowSESToDecrypt", 
   "Effect": "Allow",
   "Principal": {
       "Service":"ses.amazonaws.com"
   },
   "Action": [
       "kms:Decrypt", 
   ],
   "Resource": "*"
}
```
Use a CreateImportJoboperação na API SES v2.

nota

O exemplo a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre como instalar e configurar o AWS CLI, consulte o Guia do AWS Command Line Interface usuário.

Na linha de comando, insira o seguinte comando: s3bucketSubstitua pelo nome de um bucket do Amazon S3 e s3object pelo nome de um objeto do Amazon S3.


aws sesv2 create-import-job --import-destination SuppressionListDestination={SuppressionListImportAction=PUT} --import-data-source S3Url=s3://s3bucket/s3object,DataFormat=CSV

Para adicionar endereços de e-mail em massa à sua lista de supressão por conta usando o console do SES:

Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.
No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).
Na tabela Suppression list (Lista de supressão), expanda o botão Bulk actions (Ações em massa) e selecione Add email addresses in bulk (Adicionar endereços de e-mail em massa).
Em Bulk action specifications (Especificações da ação em massa), selecione (a) Choose file from S3 bucket (Escolher arquivo do bucket do S3) ou (b) Import from file (Importar do arquivo). Os procedimentos são indicados para cada método de importação:
1. Choose file from S3 bucket (Escolher arquivo do bucket do S3) - Se seu arquivo de origem já estiver armazenado em um bucket do Amazon S3:
  1. Se você sabe o URI do bucket do Amazon S3 que deseja usar, insira-o no campo Amazon S3 URI (URI do Amazon S3); caso contrário, escolha Browse S3 (Procurar no S3):
    1. Em Buckets, selecione o nome do bucket do S3.
    2. Em Objects (Objetos), selecione o nome do arquivo e selecione Choose (Escolher). Você será direcionado de volta para Bulk action specifications (Especificações da ação em massa).
    3. (Opcional) Se você quiser ser levado ao console do Amazon S3 para exibir detalhes sobre o seu objeto do S3, escolha View (Exibir).
  2. Em File format (Formato do arquivo), selecione o formato do arquivo que você escolheu para importar do bucket do Amazon S3.
  3. Escolha Add e-mail addresses (Adicionar endereços de e-mail) para iniciar a importação de endereços do seu arquivo - uma tabela abaixo da guia Bulk actions (Ações em massa) é exibida.
2. Import from file (Importar do arquivo) - se você tiver um arquivo de origem local para carregar em um bucket do Amazon S3 novo ou existente:
  1. Em Import source file (Importar arquivo de origem), selecione Choose file (Escolher arquivo).
  2. Selecione o arquivo JSON ou CSV no navegador de arquivos e escolha Open (Abrir). Você verá o nome, o tamanho e a data do seu arquivo exibidos sob o botão Choose file (Escolher arquivo).
  3. Expanda Amazon S3 bucket (Bucket do Amazon S3) e selecione o bucket do S3.
    1. Para carregar seu arquivo em um novo bucket, escolha Create S3 bucket (Criar bucket do S3), insira um nome no campo Bucket name (Nome do bucket) e escolha Create bucket (Criar bucket).
  4. Escolha Add e-mail addresses (Adicionar endereços de e-mail) para iniciar a importação de endereços do seu arquivo - uma tabela abaixo da guia Bulk actions (Ações em massa) é exibida.
Independentemente do método de importação que você usou, seu ID de trabalho será listado em Bulk actions (Ações em massa), juntamente com o tipo de importação, o status e a data. Para exibir os detalhes do trabalho, selecione o ID do trabalho.
Selecione a guia Suppression list (Lista de supressão) e todos os endereços de e-mail importados com êxito serão exibidos com o motivo da supressão e a data de adição. As seguintes opções estão disponíveis:
1. Selecione um endereço de e-mail ou marque a caixa de seleção correspondente e escolha View report (Exibir relatório) para exibir seus detalhes. (Se for um endereço que foi adicionado automaticamente à sua lista de supressão devido a uma devolução ou reclamação, serão exibidas informações sobre o evento de feedback que fez com que ele fosse adicionado, incluindo detalhes sobre a mensagem de e-mail que produziu o evento de acionamento.)
2. Marque a caixa de seleção correspondente de um ou mais endereços de e-mail que você deseja remover da sua lista de supressão da conta e escolha Remove (Remover).

Visualizar uma lista dos endereços que estão na lista de supressão no nível da conta do Amazon SES

Você pode ver uma lista de todos os endereços de e-mail que estão na lista de supressão em nível de conta da sua conta usando a ListSuppressedDestinationsoperação na API SES v2.

Como visualizar uma lista de todos os endereços de e-mail que estão na lista de supressão no nível da conta

Na linha de comando, insira o seguinte comando:
```
aws sesv2 list-suppressed-destinations
```

O comando anterior retorna todos os endereços de e-mail que estão na lista de supressão no nível da conta da sua conta. A saída será semelhante ao seguinte exemplo:


{
    "SuppressedDestinationSummaries": [
        {
            "EmailAddress": "recipient2@example.com",
            "Reason": "COMPLAINT",
            "LastUpdateTime": "2020-04-10T21:03:05Z"
        },
        {
            "EmailAddress": "recipient0@example.com",
            "Reason": "COMPLAINT",
            "LastUpdateTime": "2020-04-10T21:04:26Z"
        },
        {
            "EmailAddress": "recipient1@example.com",
            "Reason": "BOUNCE",
            "LastUpdateTime": "2020-04-10T22:07:59Z"
        }
    ]
}

Observação — Se sua saída incluir um campo NextToken "" com um valor de string, isso indica que há endereços de e-mail adicionais na lista de supressão da sua conta. Para exibir endereços suprimidos adicionais, emita outra solicitação para ListSuppressedDestinations e passe o valor da string retornado no parâmetro da --next-token da seguinte forma:
```
aws sesv2 list-suppressed-destinations --next-token string
```
No comando anterior, string substitua pelo NextToken valor retornado.

Para saber mais, consulte How to list over 1000 email addresses from account-level suppression list.

Você pode usar a opção StartDate para mostrar apenas os endereços de e-mail que foram adicionados à lista após uma determinada data.

Como visualizar uma lista dos endereços que foram adicionados à lista de supressão no nível da conta após uma data específica

Na linha de comando, insira o seguinte comando:
```
aws sesv2 list-suppressed-destinations --start-date 1604394130
```
No comando anterior, 1604394130 substitua pelo timestamp Unix da data de início.

Você também pode usar a opção EndDate para mostrar apenas os endereços de e-mail que foram adicionados à lista antes de uma determinada data.

Como visualizar uma lista dos endereços que foram adicionados à lista de supressão no nível da conta antes de uma data específica

Na linha de comando, insira o seguinte comando:
```
aws sesv2 list-suppressed-destinations --end-date 1611126000
```
No comando anterior, substitua pelo carimbo 1611126000 de data/hora Unix da data de término.

Na linha de comando do Linux, macOS ou Unix, você também pode usar o utilitário interno grep para procurar endereços ou domínios específicos.

Como pesquisar um endereço específico na lista de supressão no nível da conta

Na linha de comando, insira o seguinte comando:
```
aws sesv2 list-suppressed-destinations | grep -A2 'example.com'
```
No comando anterior, example.com substitua pela sequência de texto (como endereço ou domínio) que você deseja pesquisar.

Como visualizar uma lista de todos os endereços de e-mail que estão na lista de supressão no nível da conta usando o console do SES:

Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.
No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).
Selecione a guia Suppression list e todos os endereços de e-mail importados com êxito serão exibidos com o motivo da supressão e a data de adição. As seguintes opções estão disponíveis:
1. Selecione um endereço de e-mail ou marque a caixa de seleção correspondente e escolha View report (Exibir relatório) para exibir seus detalhes. (Se for um endereço que foi adicionado automaticamente à sua lista de supressão devido a uma devolução ou reclamação, serão exibidas informações sobre o evento de feedback que fez com que ele fosse adicionado, incluindo detalhes sobre a mensagem de e-mail que produziu o evento de acionamento.)
2. Você pode personalizar a tabela da lista de supressão escolhendo o ícone de engrenagem - um modal será apresentado, onde você pode personalizar o tamanho da página, a quebra de linha e as colunas a visualizar - depois de fazer suas seleções, escolha Confirm (Confirmar). A tabela da lista de supressão refletirá suas opções de exibição.

Remover endereços de e-mail individuais da lista de supressão do Amazon SES no nível da conta

Se um endereço estiver na lista de supressão da sua conta, mas você souber que o endereço não deveria estar na lista, você pode removê-lo usando a DeleteSuppressedDestinationoperação na API SES v2.

Como remover endereços individuais da lista de supressão no nível da conta usando a AWS CLI

Na linha de comando, insira o seguinte comando:
Linux, macOS, or Unix
```
aws sesv2 delete-suppressed-destination \
--email-address recipient@example.com
```
Windows
```
aws sesv2 delete-suppressed-destination `
--email-address recipient@example.com
```
No exemplo anterior, recipient@example.com substitua pelo endereço de e-mail que você deseja remover da sua lista de supressão no nível da conta.

Como remover endereços individuais da lista de supressão no nível da conta usando o console do SES:

Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.
No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).
Remova endereços de e-mail individuais mediante (a) seleção de tabela ou (b) entrada digitada:
1. Seleção na tabela: na tabela Suppression list (Lista de supressão), marque a caixa de seleção correspondente a um ou mais endereços de e-mail e escolha Remove (Remover).
2. Digitação no campo:
  1. Na tabela Suppression list (Lista de supressão), escolha Remove email address (Remover endereço de e-mail).
  2. Digite um endereço de e-mail no campo Email address (Endereço de e-mail). Se precisar inserir mais endereços, escolha Enter another address (Inserir outro endereço) e repita a operação para cada endereço adicional.
  3. Quando terminar de inserir endereços, revise a precisão de suas entradas. Se decidir que alguma de suas entradas não deve integrar esse envio, escolha o botão Remove (Remover).
  4. Escolha Save changes (Salvar as alterações) para remover os endereços de e-mail inseridos da sua lista de supressão por conta.

Remover endereços de e-mail em massa da lista de supressão do Amazon SES no nível da conta

Você pode remover endereços em massa fazendo primeiro o upload da sua lista de contatos em um objeto do Amazon S3 e, em seguida, usando CreateImportJoba operação na API SES v2.

nota

Não há limite para o número de endereços que você pode remover da lista de supressão no nível de conta, mas há um limite de exclusão em massa de 10.000 de endereços em um objeto do Amazon S3 por chamada de API.
Se sua fonte de dados for um bucket do S3, ela deverá existir na mesma região para a qual você está importando.

Para remover endereços de e-mail em massa da lista de supressão no nível da conta, conclua as etapas a seguir.

Carregue sua lista de endereços em um objeto do Amazon S3 no formato CSV ou JSON.

Exemplo de formato CSV para remoção de endereços:

recipient3@example.com

Somente arquivos JSON delimitados por nova linha são suportados. Nesse formato, cada linha é um objeto JSON completo que contém uma definição de endereço individual.

Exemplo de formato JSON para adicionar endereços:

{"emailAddress":"recipient3@example.com"}

Nos exemplos anteriores, recipient3@example.com substitua pelos endereços de e-mail que você deseja remover da sua lista de supressão no nível da conta.

Conceda permissão ao SES para ler o objeto do Amazon S3.

Quando aplicada a um bucket do Amazon S3, a seguinte política concede ao SES permissão de leitura desse bucket. Para obter mais informações sobre como anexar políticas aos buckets do Amazon S3, consulte Uso de políticas de bucket e políticas de usuário no Guia do usuário do Amazon Simple Storage Service.

Dê permissão ao SES para usar sua AWS KMS chave.

Se o objeto do Amazon S3 estiver criptografado com uma AWS KMS chave, você precisará dar permissão ao Amazon SES para usar a AWS KMS chave. O SES só pode obter permissão de uma chave gerenciada pelo cliente, não de uma chave padrão do KMS. Você precisa conceder permissão ao SES para usar a chave gerenciada pelo cliente, adicionando uma instrução à política da chave.

Cole a seguinte instrução de política na política de chave para permitir que o SES use sua chave gerenciada pelo cliente.
```
{
   "Sid": "AllowSESToDecrypt", 
   "Effect": "Allow",
   "Principal": {
       "Service":"ses.amazonaws.com"
   },
   "Action": [
       "kms:Decrypt", 
   ],
   "Resource": "*"
}
```
Use a CreateImportJoboperação na API SES v2.

nota

O exemplo a seguir pressupõe que a AWS CLI já foi instalada. Para obter mais informações sobre como instalar e configurar o AWS CLI, consulte o Guia do AWS Command Line Interface usuário.

Na linha de comando, insira o seguinte comando: s3bucketSubstitua pelo nome do bucket do Amazon S3 e s3object pelo nome do objeto do Amazon S3.


aws sesv2 create-import-job --import-destination SuppressionListDestination={SuppressionListImportAction=DELETE} --import-data-source S3Url="s3://s3bucket/s3object",DataFormat=CSV

Para remover endereços de e-mail em massa da sua lista de supressão por conta usando o console do SES:

Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.
No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).
Na tabela Suppression list (Lista de supressão), expanda o botão Bulk actions (Ações em massa) e selecione Remove e-mail addresses in bulk (Remover endereços de e-mail em massa).
Em Bulk action specifications (Especificações da ação em massa), selecione (a) Choose file from S3 bucket (Escolher arquivo do bucket do S3) ou (b) Import from file (Importar do arquivo). Os procedimentos indicados para cada método de importação estão abaixo:
1. Choose file from S3 bucket (Escolher arquivo do bucket do S3) - Se seu arquivo de origem já estiver armazenado em um bucket do Amazon S3:
  1. Se você sabe o URI do bucket do Amazon S3 que deseja usar, insira-o no campo Amazon S3 URI (URI do Amazon S3); caso contrário, escolha Browse S3 (Procurar no S3):
    1. Em Buckets, selecione o nome do bucket do S3.
    2. Em Objects (Objetos), selecione o nome do arquivo e selecione Choose (Escolher). Você será direcionado de volta para Bulk action specifications (Especificações da ação em massa).
    3. (Opcional) Se você quiser ser levado ao console do Amazon S3 para exibir detalhes sobre o seu objeto do S3, escolha View (Exibir).
  2. Em File format (Formato do arquivo), selecione o formato do arquivo que você escolheu para importar do seu bucket do Amazon S3.
  3. Escolha Remove e-mail addresses (Remover endereços de e-mail) para iniciar a importação de endereços do seu arquivo - uma tabela abaixo da guia Bulk actions (Ações em massa) é exibida.
2. Import from file (Importar do arquivo) - se você tiver um arquivo de origem local para carregar em um bucket do Amazon S3 novo ou existente:
  1. Em Import source file (Importar arquivo de origem), selecione Choose file (Escolher arquivo).
  2. Selecione o arquivo JSON ou CSV no navegador de arquivos e escolha Open (Abrir). Você verá o nome, o tamanho e a data do seu arquivo exibidos sob o botão Choose file (Escolher arquivo).
  3. Expanda Amazon S3 bucket (Bucket do Amazon S3) e selecione o bucket do S3.
    1. Para carregar seu arquivo em um novo bucket, escolha Create S3 bucket (Criar bucket do S3), insira um nome no campo Bucket name (Nome do bucket) e escolha Create bucket (Criar bucket).
  4. Escolha Remove e-mail addresses (Remover endereços de e-mail) para iniciar a importação de endereços do seu arquivo - uma tabela abaixo da guia Bulk actions (Ações em massa) é exibida.
Independentemente do método de importação que você usou, seu ID de trabalho será listado em Bulk actions (Ações em massa), juntamente com o tipo de importação, o status e a data. Para exibir os detalhes do trabalho, selecione o ID do trabalho.
Selecione a guia Suppression list (Lista de supressão) e todos os endereços de e-mail importados com êxito que foram removidos da sua lista de supressão não serão mais exibidos.

Visualização de uma lista de trabalhos de importação para a conta

Você pode ver uma lista de todos os endereços de e-mail que estão na lista de supressão em nível de conta da sua conta usando a ListImportJobsoperação na API v2 do Amazon SES.

Para exibir uma lista de todos os trabalhos de importação da conta

Na linha de comando, insira o seguinte comando:
```
aws sesv2 list-import-jobs
```

O comando anterior retorna todos os trabalhos de importação da conta. A saída será semelhante ao seguinte exemplo:


{
    "ImportJobs": [
        {
            "CreatedTimestamp": 2020-07-31T06:06:55Z",
            "ImportDestination": {
                "SuppressionListDestination": {
                    "SuppressionListImportAction": "PUT"
                }
            },
            "JobStatus": "COMPLETED",
            "JobId": "755380d7-fbdb-4ed2-a9a3-06866220f5b5"
        },
        {
            "CreatedTimestamp": "2020-07-30T18:45:32Z",
            "ImportDestination": {
                "SuppressionListDestination": {
                    "SuppressionListImportAction": "DELETE"
                }
            },
            "JobStatus": "COMPLETED",
            "JobId": "076683bd-a7ee-4a40-9754-4ad1161ba8b6"
        },
        {
            "CreatedTimestamp": "2020-08-05T16:45:18Z",
            "ImportDestination": {
                "SuppressionListDestination": {
                    "SuppressionListImportAction": "PUT"
                }
            },
            "JobStatus": "COMPLETED",
            "JobId": "6e261869-bd30-4b33-b1f2-9e035a83a395"
        }
    ]
}

Para exibir uma lista de todos os trabalhos de importação para a conta usando o console do SES:

Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.
No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).
No painel Suppression list (Lista de supressão), selecione a guia Bulk actions (Ações em massa).
Todos os trabalhos de importação serão listados na tabela Bulk actions (Ações em massa), juntamente com o tipo de importação, o status e a data.
Para exibir detalhes da tarefa, selecione o ID do trabalho e os seguintes painéis são exibidos:
1. Bulk action status (Status da ação em massa): mostra o status geral dos trabalhos, a hora e a data em que foram concluídas, quantos registros foram importados e a contagem de todos os registros que não foram importados com êxito.
2. Bulk action details (Detalhes da ação em massa): mostra o ID do trabalho, se ele foi usado para adicionar ou remover endereços, se o formato do arquivo era JSON ou CSV, o URI do bucket do Amazon S3 onde o arquivo em massa foi armazenado e a hora e a data em que a ação em massa foi criada.

Obtenção de informações sobre um trabalho de importação para a conta

Você pode obter informações sobre um trabalho de importação para a conta usando a GetImportJoboperação na API v2 do Amazon SES.

Para obter informações sobre um trabalho de importação para a conta

Na linha de comando, insira o seguinte comando:
```
aws sesv2 get-import-job --job-id JobId
```

O comando anterior retorna informações sobre um trabalho de importação para a conta. A saída será semelhante ao seguinte exemplo:


{
    "ImportDataSource": {
        "S3Url": "s3://bucket/object",
        "DataFormat": "CSV"
    },
    "ProcessedRecordsCount": 2,
    "FailureInfo": {
        "FailedRecordsS3Url": "s3presignedurl"
    },
    "JobStatus": "COMPLETED",
    "JobId": "jobid",
    "CreatedTimestamp": "2020-08-12T17:05:15Z",
    "FailedRecordsCount": 1,
    "ImportDestination": {
        "SuppressionListDestination": {
            "SuppressionListImportAction": "PUT"
        }
    },
    "CompletedTimestamp": "2020-08-12T17:06:42Z"
}

Para obter informações sobre um trabalho de importação para a conta usando o console do SES:

Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.
No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).
No painel Suppression list (Lista de supressão), selecione a guia Bulk actions (Ações em massa).
Todos os trabalhos de importação serão listados na tabela Bulk actions (Ações em massa), juntamente com o tipo de importação, o status e a data.
Para exibir detalhes da tarefa, selecione o ID do trabalho e os seguintes painéis são exibidos:
1. Bulk action status (Status da ação em massa): mostra o status geral dos trabalhos, a hora e a data em que foram concluídas, quantos registros foram importados e a contagem de todos os registros que não foram importados com êxito.
2. Bulk action details (Detalhes da ação em massa): mostra o ID do trabalho, se ele foi usado para adicionar ou remover endereços, se o formato do arquivo era JSON ou CSV, o URI do bucket do Amazon S3 onde o arquivo em massa foi armazenado e a hora e a data em que a ação em massa foi criada.

Como desabilitar a lista de supressão do Amazon SES por conta

Você pode usar a PutAccountSuppressionAttributesoperação na API SES v2 para desativar efetivamente sua lista de supressão em nível de conta removendo os valores do atributo. suppressed-reasons

Para desativar sua lista de supressão em nível de conta usando o AWS CLI

Na linha de comando, insira o seguinte comando:


aws sesv2 put-account-suppression-attributes --suppressed-reasons

Como desabilitar a lista de supressão no nível da conta usando o console do SES:

Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.
No painel de navegação, em Configuration (Configuração), escolha Suppression list (Lista de supressão).
No painel Account-level settings (Configurações no nível da conta), escolha Edit (Editar).
Em Suppression list (Lista de supressão), desmarque a caixa Enabled (Habilitada).
Escolha Salvar alterações.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Lista de supressão global

Uso da supressão no nível do conjunto de configurações