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

Usar endpoints globais no Amazon SES

Os endpoints globais do Amazon SES são um recurso que melhora a continuidade e a confiabilidade de suas operações de envio de e-mails. Este capítulo apresentará o conceito, a configuração e o uso de endpoints globais, ajudando você a aproveitar o envio para várias regiões (MRS) a fim de obter maior disponibilidade e recursos aprimorados de recuperação de desastres para suas workloads de e-mail.

O que são endpoints globais?

Os endpoints globais são recursos que permitem que você distribua suas workloads de saída do SES entre duas Regiões da AWS. Depois de configurado, o SES dividirá automaticamente seu tráfego de envio entre as regiões primária e secundária selecionadas. Se alguma região sofrer uma deficiência, o SES automaticamente afastará o tráfego da região afetada para manter a continuidade de suas operações de envio.

Os principais benefícios do uso de endpoints globais incluem:

Como funcionam os endpoints globais

Ao configurar um endpoint global, selecione uma região primária (onde o endpoint é criado) e uma região secundária. Depois, o SES criará um endpoint multirregional (MREP) que serve como ponto de entrada para suas solicitações de envio de e-mail.

O processo de configuração do endpoint global sincroniza os principais artefatos e os limites de envio da região primária com a região secundária. Isso garante que ambas as regiões tenham identidades verificadas, conjuntos de configuração e limites de envio aprovados equivalentes e suficientes para todo o volume esperado.

Quando o endpoint global estiver pronto e seu ID de endpoint for especificado na chamada da SendEmail API, o SES encaminha automaticamente seu tráfego de saída uniformemente entre suas regiões primária e secundária. Se uma região ficar prejudicada, o tráfego será desviado dessa região para a outra até que a deficiência seja resolvida.

Configurar endpoints globais

Pré-requisitos

Antes de criar um endpoint global, primeiro você precisará conceder permissão à SES para criar funções vinculadas ao serviço (SLRs) em sua conta. Esses perfis habilitam as funcionalidades essenciais do serviço e o acesso aos recursos necessários para criar, usar e monitorar endpoints globais. Isso pode ser feito implementando a seguinte política:

JSON

{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "iam:CreateServiceLinkedRole",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "iam:AWSServiceName": "ses.amazonaws.com"
        }
      }
    }
  ]
}

Criar um endpoint global

Para criar um endpoint global:

O processo de criação pode levar alguns segundos. Depois de concluído, o status do seu endpoint global mudará para “Pronto”.

Usando o AWS CLI:

aws sesv2 create-multi-region-endpoint --primary-region us-west-2 --secondary-region us-east-1 --endpoint-name MyGlobalEndpoint

No exemplo anterior:

Estados de endpoint global

Os endpoints globais podem ter os seguintes estados:

Preparar a região secundária

Agora que você criou seu endpoint global, precisa garantir que a configuração de envio de e-mails, incluindo todos os respectivos componentes (identidades, conjuntos de configuração, modelos de e-mail e limites de envio), seja consistente nas regiões primária e secundária antes de utilizar o endpoint global para enviar e-mails. Esse alinhamento é crucial para evitar possíveis problemas e garantir a entrega e o rastreamento adequados dos e-mails.

O recurso de duplicação de regiões no console ajuda você a duplicar automaticamente os recursos e duplicar as configurações no nível da conta da região primária para a secundária, o que ajudará rapidamente a garantir que ambas as regiões tenham configurações equivalentes.

Com base nas dependências dos recursos, a ordem em que você duplica os recursos é importante. Para evitar conflitos, siga a ordem dos tópicos abaixo:

Duplicar conjuntos de configuração

Você pode selecionar vários conjuntos de configuração da região primária para serem duplicados, junto com as respectivas configurações, na região secundária.

O recurso “Duplicar conjuntos de configuração” permite que você:

Duplicar identidades de domínio verificadas

Para garantir que a configuração do endpoint global funcione de forma eficaz, sua identidade de domínio de envio precisa ser verificada nas regiões primária e secundária. O SES usa Easy DKIM determinístico (DEED) para simplificar esse processo.

O Deterministic Easy DKIM (DEED) é um recurso que gera tokens DKIM consistentes em todos, Regiões da AWS com base em um domínio principal configurado com o Easy DKIM. Essa consistência permite que o SES verifique automaticamente um domínio na região secundária depois de verificado na região primária, sem exigir atualizações adicionais do registro DNS. Portanto, você deve garantir que a identidade do domínio que deseja duplicar, ou seja, o principal, já esteja configurada com Easy DKIM.

O recurso “Duplicar identidades de domínio verificadas” permite que você:

Duplicar limites de produção

O SES verifica se os limites de envio estão alinhados entre as regiões e permite que você solicite aumentos de limite na região secundária, se necessário.

O recurso “Duplicar limites de produção” permite que você:

Usar endpoints globais

Integração ao seu aplicativo

O uso de um endpoint global em sua aplicação exige que você obtenha seu ID de endpoint.

Usando o AWS CLI:

aws sesv2 get-multi-region-endpoint --endpoint-name MyGlobalEndpoint --region us-west-2

No exemplo anterior:

Depois de obter o ID do endpoint global, você poderá atualizar as chamadas de API SendEmail ou SendBulkEmail para incluir o valor do ID do endpoint para o parâmetro endpoint-id. Aqui está um exemplo de como especificar o ID do endpoint em uma chamada de SendEmail API usando o AWS CLI:

aws sesv2 send-email \ 
                --from-email-address "sender@example.com" \ 
                --destination "ToAddresses=recipient@example.com" \ 
                --content "Subject={Data=Test email,Charset=UTF-8},Body={Text={Data=This is a test email sent using Amazon SES Global endpoints.,Charset=UTF-8}}" \ 
                --endpoint-id "abcdef12.g3h"

abcdef12.g3hSubstitua pela ID real do endpoint que você obteve por meio do console ou da API.

Monitoramento e métricas

O recurso de endpoints globais fornece uma visão unificada do volume de envio de e-mails nas regiões primária e secundária. É possível acessar essas métricas por meio da guia “Métricas entre regiões” na página de detalhes do endpoint global no console do SES.

Usando o AWS CLI:

aws cloudwatch get-metric-statistics \ 
                --namespace AWS/SES \ 
                --metric-name SendCount \ 
                --dimensions Name=ses:multi-region-endpoint-id,Value=abcdef12.g3h \ 
                --start-time 2024-10-01T00:00:00Z \ --end-time 2024-10-31T23:59:59Z \ 
                --period 86400 \ 
                --statistics Sum

abcdef12.g3hSubstitua pelo seu ID de endpoint real.

Práticas recomendadas e considerações

Seguir essas melhores práticas e considerações ajuda a garantir a utilização, o monitoramento e a otimização de custos eficazes de endpoints globais em vários Regiões da AWS para melhorar a disponibilidade e a confiabilidade dos recursos de envio de e-mail.

Preços

Embora os detalhes exatos dos preços estejam sujeitos a alterações, espera-se que os endpoints globais tenham um preço mais alto do que o envio do mesmo volume de e-mails em uma única região. Apesar desse aumento, espera-se que o custo geral permaneça competitivo em comparação com outros provedores de serviços de e-mail.

Para obter a maioria das informações sobre up-to-date preços, consulte a página de preços do Amazon SES.