

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

# Criação de conjuntos de configurações no SES
<a name="creating-configuration-sets"></a>

É possível usar o console do SES, a ação `CreateConfigurationSet` na API do Amazon SES v2 ou o comando `aws sesv2 create-configuration-set` na CLI v2 do Amazon SES para criar um conjunto de configurações. Esta seção mostra como criar conjuntos de configurações usando o console do SES e a CLI v2 do Amazon SES.

## Para criar um conjunto de configurações (console)
<a name="config-sets-create-console"></a>

Para criar um conjunto de configurações usando o console do SES, siga estas etapas:

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. Escolha **Create Route (Criar rota)**.

1. <a name="create-config-set-step-4"></a>**Detalhes gerais**: esta seção fornece opções para personalizar seu conjunto de configuração:
   + **Nome do conjunto de configurações**: o nome do seu conjunto de configurações. O nome pode conter até 64 caracteres alfanuméricos, incluindo apenas letras, números, hifens (-) e sublinhas (\$1).
   + **Grupo de IPs de envio**: quando você envia e-mails usando esse conjunto de configurações, as mensagens são enviadas dos endereços IP dedicados no grupo atribuído. Selecione um grupo de IPs na lista.
**nota**  
O **padrão** (ses-default-dedicated-pool) contém endereços IP dedicados que não foram atribuídos a nenhum outro pool. Para saber mais sobre grupos de IPs, consulte [Atribuir grupos de IP](managing-ip-pools.md).
   + **Opções de rastreamento**
     + **Usar um domínio de redirecionamento personalizado**: marque a caixa de seleção para usar um domínio de redirecionamento personalizado para lidar com o rastreamento de aberturas e cliques para e-mails enviados com esse conjunto de configurações.
     + **Domínio de redirecionamento personalizado**: selecione um domínio verificado na lista *Escolher um domínio verificado* para ser seu domínio de redirecionamento personalizado. Você também pode inserir um subdomínio no campo *Inserir um subdomínio*.
**nota**  
Os domínios de redirecionamento personalizados podem ser especificados da seguinte forma:  
Primeiro, você deve criar e verificar um domínio de redirecionamento personalizado no qual Região da AWS deseja enviar e rastrear e-mails, bem como configurar uma Rede de Distribuição de Conteúdo (CDN). Isso é explicado em [Configurar domínios personalizados para lidar com rastreamento de abertura e clique](configure-custom-open-click-domains.md).
Em seguida, para usar seu domínio de redirecionamento personalizado para rastreamento de aberturas e cliques, você deve indicá-lo ao criar ou editar seu conjunto de configurações aqui nesta etapa.
Por fim, depois de especificar seu domínio de redirecionamento personalizado, a opção **Visualizar registros DNS** aparecerá no contêiner de **Detalhes gerais** do conjunto de configurações. Se você expandi-lo, verá o registro CNAME que contém o domínio de rastreamento que está sendo usado no seu Região da AWS. Por exemplo, se o seu subdomínio personalizado se chamar *marketing.example.com* e tiver sido criado na Região da AWS `us-east-1`, a expansão de **Visualizar registros DNS** revelaria um registro CNAME com os seguintes valores: **Nome** = *marketing.example.com* e **Valor** = *r.us-east-1.awstrack.me*.  
Você pode usar essas informações simplesmente como uma confirmação de que escolheu o domínio de rastreamento correto na tabela ao configurar sua CDN conforme explicado em [Configurar domínios personalizados para lidar com rastreamento de abertura e clique](configure-custom-open-click-domains.md) ou pode fazer isso primeiro e usar os valores do registro CNAME daqui para usar na configuração da CDN.
     + **Política HTTPS**: selecione uma opção de política HTTPS para o protocolo dos links de rastreamento de aberturas e cliques para seu domínio de redirecionamento personalizado:
       + **Opcional**: (comportamento padrão) os links de rastreamento de aberturas serão agrupados usando HTTP. Os links de rastreamento de cliques serão agrupados usando o protocolo original do link.
       + **Obrigatório**: os links de rastreamento de aberturas e cliques serão agrupados usando HTTPS.
       + **Obrigatório para aberturas**: os links de rastreamento de aberturas serão agrupados usando HTTPS. Os links de rastreamento de cliques serão agrupados usando o protocolo original do link.
   + **Opções avançadas de entrega**: escolha a seta à esquerda para expandir a seção de opções avançadas de entrega.
     + **Transport Layer Security (TLS)**: para exigir que o SES estabeleça uma conexão segura com o servidor de e-mail de recebimento e envie e-mails usando o protocolo TLS, selecione a caixa de seleção **Obrigatório**.
**nota**  
O SES é compatível com o TLS 1.2 e recomenda o TLS 1.3. Para saber mais, consulte [Segurança da infraestrutura no SES](infrastructure-security.md).
     + **Duração máxima da entrega**: para especificar um limite de tempo para o SES tentar a entrega de e-mail por meio desse conjunto de configurações, insira um valor em segundos que varia de 300 a 50.400. 
**nota**  
Definir um limite máximo de entrega personalizado (menor do que o padrão SES de 14 horas) pode ser útil em casos como e-mails urgentes (como aqueles que contêm um one-time-password), e-mails transacionais e e-mails que você deseja garantir que não sejam entregues fora do horário comercial.  
Para converter minutos em segundos, multiplique por 60, por exemplo, 7 minutos x 60 = 420 segundos.
Para converter horas em segundos, multiplique por 3.600, por exemplo, 2 horas x 3.600 = 7.200 segundos.

1. **Opções de reputação**: esta seção permite a configuração das métricas de reputação:
   + **Métricas de reputação** — usadas para rastrear métricas de rejeição e reclamação em CloudWatch e-mails enviados usando esse conjunto de configurações. *(Cobranças adicionais se aplicam, consulte [Preço por métrica para CloudWatch](event-publishing-add-event-destination-cloudwatch.md#cw-add-pricing).)*
     + **Habilitado**: marque essa caixa de seleção para habilitar métricas de reputação para o conjunto de configurações.

1. <a name="suppression-list-config-set-level"></a>**Opções de lista de supressão**: esta seçã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ção 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. <a name="vdm-create-config-overrides"></a>**Opções do gerenciador de capacidade de entrega virtual**: esta seção só estará presente se você tiver os recursos do Gerenciador Virtual de Capacidade de Entrega habilitados. Nela é possível definir configurações personalizadas de como um conjunto de configuração usará o rastreamento de engajamento e a entrega compartilhada otimizada, substituindo a forma como elas foram definidas nas configurações do Gerenciador Virtual de Capacidade de Entrega no nível da conta:

   1. Para desabilitar o rastreamento de engajamento e a entrega compartilhada otimizada para esse conjunto de configurações:

      1. Marque a caixa **Override account level settings** (Substituir configurações no nível da conta).

      1. Verifique se a opção **Enabled** (Habilitado) está desmarcada tanto para *Engagement tracking* (Rastreamento de engajamento) como para *Optimized shared delivery* (Entrega compartilhada otimizada) e selecione **Save changes** (Salvar alterações).

   1. Para habilitar ou desabilitar o rastreamento de engajamento e a entrega compartilhada otimizada (ou ambos) para esse conjunto de configurações:

      1. Marque a caixa **Override account level settings** (Substituir configurações no nível da conta).

      1. Marque ou desmarque a opção **Enabled** (Habilitado) para *Engagement tracking* (Rastreamento de engajamento) ou *Optimized shared delivery* (Entrega compartilhada otimizada) (ou para ambos) e selecione **Save changes** (Salvar alterações).

   1. Para voltar às configurações no nível da conta do Virtual Deliverability Manager para o rastreamento de engajamento e a entrega compartilhada otimizada para este conjunto de configurações:

      1. Desmarque a caixa **Override account level settings** (Substituir configurações no nível da conta) e selecione **Save changes** (Salvar alterações). 

1. **Opções de arquivamento**: esta seção fornece a opção de arquivar e-mails enviados desse conjunto de configuração:

   1. Marque a caixa de seleção **Enabled (Habilitado)**.

   1. Clique dentro do campo **Arquivar**, selecione um arquivo da lista e clique em **Salvar alterações** ou escolha **Criar arquivamento** e continue com as etapas restantes.

   1. Insira um nome exclusivo no campo **Nome do arquivo**.

   1. (Opcional) Selecione um período de retenção no campo **Período de retenção** para substituir o período de retenção padrão de 180 dias.

   1. (Opcional) Você pode criptografar seu arquivo inserindo sua própria AWS KMS chave no campo **ARN da chave KMS** ou selecionando **Criar uma** chave KMS. AWS 

   1. Escolha **Criar arquivo**.

1. **Etiquetas**: esta seção permite adicionar uma ou mais tags ao seu conjunto de configuração:

   1. Selecione **Add new tag (Adicionar nova tag)**.

   1. Insira a etiqueta **Key (Chave)**.

   1. Insira a etiqueta **Value (Valor)** (opcional).

   Para remover uma etiqueta que você inseriu, escolha **Remove (Remover)** para essa etiqueta. Você pode adicionar no máximo 50 etiquetas.

1. Selecione **Create set (Criar conjunto)** para criar seu conjunto de configurações.

Agora que criou o conjunto de configurações, você tem a opção de definir destinos de eventos para ele, o que permite a publicação de eventos acionada com base nos tipos de evento especificados para o destino do evento. Um conjunto de configurações pode ter vários destinos de eventos com diversos tipos de eventos definidos. Consulte [Criar destinos de eventos do Amazon SES](event-destinations-manage.md).

## Criar um conjunto de configurações (AWS CLI)
<a name="config-sets-create-cli"></a>

Você pode criar um conjunto de configurações usando um arquivo JSON como entrada para o comando `aws sesv2 create-configuration-set` na AWS CLI.

1. 

**Criar um arquivo JSON de entrada da CLI**

   Use sua ferramenta de edição de arquivos favorita para criar um arquivo JSON com as chaves a seguir, além dos valores que são válidos para seu ambiente, ou use o comando `aws sesv2 create-configuration-set` da API v2 do SES com a opção `--generate-cli-skeleton` sem nenhum valor especificado a fim de imprimir um exemplo de estrutura JSON para saída padrão.

   Este exemplo usa um arquivo denominado `create-configuration-set.json`:

   ```
   {
       "ConfigurationSetName": "sample-configuration-set",
       "TrackingOptions": {
           "CustomRedirectDomain": "some.domain.com",
           "HttpsPolicy": "REQUIRE"
       },
       "DeliveryOptions": {
           "TlsPolicy": "REQUIRE",
           "SendingPoolName": "sending pool",
           "MaxDeliverySeconds": 300            
       },
       "ReputationOptions": {
           "ReputationMetricsEnabled": true,
           "LastFreshStart": timestamp
       },
       "SendingOptions": {
           "SendingEnabled": true
       },
       "Tags": [
           {
               "Key": "tag key",
               "Value": "tag value"
           }
       ],
       "SuppressionOptions": {
           "SuppressedReasons": ["BOUNCE","COMPLAINT"]
       },
       "ArchivingOptions": {
           "ArchiveArn": "arn:aws:ses:us-east-1:123456789012:mailmanager-archive/MyArchiveID"
       }
   }
   ```
**nota**  
É necessário incluir a notação `file://` no início do caminho do arquivo JSON.
O caminho para o arquivo JSON deve seguir a convenção apropriada para o sistema operacional de base no qual você está executando o comando. Por exemplo, o Windows usa a barra invertida (\$1) para se referir ao caminho do diretório e o Linux usa a barra (/).

1. Execute o seguinte comando, usando o arquivo que você criou como entrada.

   ```
   aws sesv2 create-configuration-set --cli-input-json file://create-configuration-set.json
   ```

**nota**  
Para revisar a AWS CLI referência desse comando, consulte [create-configuration-set](https://docs.aws.amazon.com/cli/latest/reference/sesv2/create-configuration-set.html).