

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á.

# Como usar a lista de supressão do Amazon SES por conta
<a name="sending-email-suppression-list"></a>

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)](request-production-access.md).

**Importante**  
As listas de supressão de conta do 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 capitalização original. Embora a funcionalidade de envio de e-mails trate endereços com capitalizações diferentes como idênticos, por exemplo, *User@Example.com* é igual a *user@example.com*, as chamadas de API para gerenciamento de listas de supressão exigem uma correspondência exata de capitalização. 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
<a name="sending-email-suppression-list-considerations"></a>

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, o SES *tentará* entregar para endereços na lista de supressão no nível da conta com o motivo de supressão *Reclamação* (porque, nesse caso, eles não correspondem).
  + 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. BounceRate*ou *reputação. ComplaintRate*mé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 [CreateImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)operação [PutSuppressedDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutSuppressedDestination)or 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)](request-production-access.md).
+ 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](send-email-concepts-process.md#send-email-concepts-process-after-send).
+ 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á instalou a AWS CLI. Para obter mais informações sobre como instalar e configurar o AWS CLI, consulte o [Guia do AWS Command Line Interface usuário](https://docs.aws.amazon.com/cli/latest/userguide/).

## Como habilitar a lista de supressão do Amazon SES por conta
<a name="sending-email-suppression-list-enabling"></a>

Você pode usar a [PutAccountSuppressionAttributes](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutAccountSuppressionAttributes.html)operaçã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](https://docs.aws.amazon.com/cli/latest/userguide/).

**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:**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. No painel de navegação, em **Configuration** (Configuração), escolha **Suppression list** (Lista de supressão).

1. No painel **Account-level settings** (Configurações no nível da conta), escolha **Edit** (Editar).

1. Em **Suppression list**, desmarque a caixa **Enabled**.

1. 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.

1. Escolha **Salvar alterações**.

## Como habilitar a lista de supressão do Amazon SES por conta para um conjunto de configurações
<a name="sending-email-suppression-list-enabling-configuration-set"></a>

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](using-configuration-sets.md) 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:

------
#### [ Linux, macOS, or Unix ]

  ```
  aws sesv2 put-configuration-set-suppression-options \
  --configuration-set-name configSet \
  --suppressed-reasons BOUNCE COMPLAINT
  ```

------
#### [ Windows ]

  ```
  aws sesv2 put-configuration-set-suppression-options `
  --configuration-set-name configSet `
  --suppressed-reasons BOUNCE COMPLAINT
  ```

------

  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:**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. No painel de navegação, em **Configuration (Configuração)**, escolha **Configuration sets (Conjuntos de configurações)**.

1. Em **Configuration sets** (Conjuntos de configurações), escolha o nome do conjunto de configurações que deseja configurar com supressão personalizada. 

1. No painel **Supression list options** (Opções de lista de supressão), escolha **Edit** (Editar).

1. <a name="suppression-list-config-set-level"></a>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](sending-email-suppression-list-config-level.md) (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).

   1. **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).

      1. Em **Suppression list** (Lista de supressão), desmarque a caixa **Enabled** (Habilitada).

   1. **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). 

      1. Em **Suppression list** (Lista de supressão), marque **Enabled** (Habilitada). 

      1. Em **Specify the reason(s)…** (Especificar o(s) motivo(s)..., selecione um dos motivos de supressão para esse conjunto de configurações usar.

1. Escolha **Salvar alterações**.

## Como adicionar endereços de e-mail individuais à lista de supressão do Amazon SES por conta
<a name="sending-email-suppression-list-manual-add"></a>

Você pode adicionar endereços individuais à sua lista de supressão em nível de conta do Amazon SES usando a [PutSuppressedDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutSuppressedDestination.html)operaçã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.

**Para adicionar endereços individuais à 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-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:**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. No painel de navegação, em **Configuration** (Configuração), escolha **Suppression list** (Lista de supressão).

1. No painel **Suppression list** (Lista de supressão), escolha **Add email address** (Adicionar endereço de e-mail).

1. 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.

1. 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).

1. 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
<a name="sending-email-suppression-list-manual-add-bulk"></a>

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 [CreateImportJob](#CIJ-add-bulk-API)a 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 [CreateImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)operaçã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](https://docs.aws.amazon.com/cli/latest/userguide/).

Na linha de comando, insira o seguinte comando: *s3bucket*Substitua 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:**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. No painel de navegação, em **Configuration** (Configuração), escolha **Suppression list** (Lista de supressão).

1. 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).

1. 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.

         1. 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).

         1. (Opcional) Se você quiser ser levado ao console do Amazon S3 para exibir detalhes sobre o seu objeto do S3, escolha **View** (Exibir).

      1. Em **File format** (Formato do arquivo), selecione o formato do arquivo que você escolheu para importar do bucket do Amazon S3.

      1. 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.

   1. **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).

      1. 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).

      1. 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).

      1. 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.

1. 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.

1. 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.)

   1. 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
<a name="sending-email-suppression-list-view-entries"></a>

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 [ListSuppressedDestinations](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListSuppressedDestinations.html)operaçã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](https://aws.amazon.com/blogs/messaging-and-targeting/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:**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. No painel de navegação, em **Configuration** (Configuração), escolha **Suppression list** (Lista de supressão).

1. 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.)

   1. 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
<a name="sending-email-suppression-list-manual-delete"></a>

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 [DeleteSuppressedDestination](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_DeleteSuppressedDestination.html)operação na API SES v2.

**Para remover endereços individuais da 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 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:**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. No painel de navegação, em **Configuration** (Configuração), escolha **Suppression list** (Lista de supressão).

1. 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).

   1. *Digitação no campo*:

      1. Na tabela **Suppression list** (Lista de supressão), escolha **Remove email address** (Remover endereço de e-mail).

      1. 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.

      1. 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).

      1. 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
<a name="sending-email-suppression-list-manual-delete-bulk"></a>

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 [CreateImportJob](#CIJ-remove-bulk-API)a 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-iam-policies.html) 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 [CreateImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_CreateImportJob.html)operaçã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](https://docs.aws.amazon.com/cli/latest/userguide/).

Na linha de comando, insira o seguinte comando: *s3bucket*Substitua 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:**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. No painel de navegação, em **Configuration** (Configuração), escolha **Suppression list** (Lista de supressão).

1. 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).

1. 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.

         1. 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).

         1. (Opcional) Se você quiser ser levado ao console do Amazon S3 para exibir detalhes sobre o seu objeto do S3, escolha **View** (Exibir).

      1. Em **File format** (Formato do arquivo), selecione o formato do arquivo que você escolheu para importar do seu bucket do Amazon S3.

      1. 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.

   1. **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).

      1. 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).

      1. 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).

      1. 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.

1. 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.

1. 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
<a name="sending-email-suppression-list-view-import-jobs"></a>

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 [ListImportJobs](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_ListImportJobs.html)operaçã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:**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. No painel de navegação, em **Configuration** (Configuração), escolha **Suppression list** (Lista de supressão).

1. No painel **Suppression list** (Lista de supressão), selecione a guia **Bulk actions** (Ações em massa).

1. 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.

1. 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.

   1. **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
<a name="sending-email-suppression-list-get-import-jobs"></a>

Você pode obter informações sobre um trabalho de importação para a conta usando a [GetImportJob](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_GetImportJob.html)operaçã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:**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. No painel de navegação, em **Configuration** (Configuração), escolha **Suppression list** (Lista de supressão).

1. No painel **Suppression list** (Lista de supressão), selecione a guia **Bulk actions** (Ações em massa).

1. 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.

1. 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.

   1. **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
<a name="sending-email-suppression-list-disabling"></a>

Você pode usar a [PutAccountSuppressionAttributes](https://docs.aws.amazon.com/ses/latest/APIReference-V2/API_PutAccountSuppressionAttributes.html)operaçã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:**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon SES em [https://console.aws.amazon.com/ses/](https://console.aws.amazon.com/ses/).

1. No painel de navegação, em **Configuration** (Configuração), escolha **Suppression list** (Lista de supressão).

1. No painel **Account-level settings** (Configurações no nível da conta), escolha **Edit** (Editar).

1. Em **Suppression list** (Lista de supressão), desmarque a caixa **Enabled** (Habilitada).

1. Escolha **Salvar alterações**.