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

Locatários

Este capítulo explica como usar o gerenciamento de locatários do Amazon SES para isolar, monitorar e gerenciar o envio de e-mails entre vários locatários em sua conta do SES. Esse recurso ajuda fornecedores independentes de software (ISVs), empresas e organizações que enviam e-mails em nome de várias entidades posteriores a manter perfis de reputação separados e evitar que problemas com um inquilino afetem outros.

O que é o gerenciamento de locatários?

O gerenciamento de locatários é um recurso que permite criar contêineres isolados chamados de “locatários” em sua conta do SES. Cada locatário pode ter suas próprias identidades de e-mail, conjuntos de configuração, modelos e métricas de reputação, garantindo que as atividades de e-mail sejam completamente separadas entre diferentes clientes ou unidades de negócios.

O gerenciamento de locatários aborda o desafio em que as práticas inadequadas de e-mail de um cliente antes podiam pausar uma conta do SES inteira, afetando todos os outros clientes. Com o isolamento do locatário, você pode gerenciar vários fluxos de e-mail de forma independente, mantendo a supervisão e o controle centralizados.

Um locatário serve como um contêiner lógico que agrupa os recursos relacionados do SES. Quando você envia e-mails em nome de um locatário específico, o SES rastreia as métricas de reputação e impõe políticas no nível do locatário. Esse isolamento garante que uma alta taxa de falha de entrega ou de reclamação de um locatário não afete a capacidade de entrega dos e-mails enviados por outros locatários.

O gerenciamento de locatários é particularmente valioso para:

Como funciona o gerenciamento de locatários

O gerenciamento da reputação de locatários funciona por meio da criação de um contêiner lógico para seus recursos de envio de e-mail. Atribua recursos específicos a cada locatário, incluindo identidades verificadas (domínios e endereços de e-mail), conjuntos de configuração e modelos. Ao enviar um e-mail em nome de um locatário, você especifica o locatário em sua chamada de API ou cabeçalho SMTP, e o SES verifica se os recursos que estão sendo usados estão associados adequadamente a esse locatário.

Associação de recursos

Os recursos em sua conta do SES podem ser associados aos locatários de duas formas:

Quando você associa um recurso a um locatário, esse locatário obtém permissão para usar esse recurso para o envio de e-mails. Com cada solicitação de envio, o SES valida se o locatário especificado tem permissão para usar a identidade, o conjunto de configuração e o modelo na solicitação. Se os recursos não estiverem associados adequadamente, a solicitação de envio falhará.

Monitoramento e imposição da reputação

O SES monitora continuamente as principais métricas de reputação de cada locatário, incluindo taxas de falha de entrega, taxas de reclamação (incluindo aquelas do sistema de ciclo de feedback (FBL) do provedor de caixa de e-mails) e sinais de feedback de terceiros. Quando essas métricas excedem os limites definidos, o SES cria “descobertas de reputação” categorizadas como:

Com base nessas descobertas, o SES pode pausar automaticamente locatários problemáticos por meio de políticas de reputação que você configura. Há três níveis de imposição disponíveis:

Quando as métricas de um locatário acionam uma descoberta de reputação que atende ao limite de imposição da política selecionada, o sistema atualiza automaticamente o status de envio do locatário para “Pausado” sem afetar a capacidade de envio de outros locatários. Enquanto um locatário estiver pausado, qualquer tentativa de enviar e-mail usando esse locatário falhará até que você revise o problema e reative manualmente o envio. Além disso, é possível pausar manualmente os recursos de envio de um locatário sempre que necessário e reiniciá-los quando estiver com tudo pronto para retomar o envio.

Configurar locatários

Criar locatários

Usando o console:

Usando o AWS CLI:

aws sesv2 create-tenant \
    --tenant-name "MyTenant" \
    --region us-east-1

Atribuir recursos a um locatário

Depois de criar um locatário, você deve atribuir pelo menos uma identidade verificada e um conjunto de configuração antes que o locatário possa enviar e-mails.

Usando o console:

Usando o AWS CLI:

# Assign an identity to a tenant
aws sesv2 create-tenant-resource-association \
    --tenant-name "MyTenant" \
    --resource-arn "arn:aws:ses:us-east-1:123456789012:identity/example.com" \
    --region us-east-1

# Assign a configuration set to a tenant
aws sesv2 create-tenant-resource-association \
    --tenant-name "MyTenant" \
    --resource-arn "arn:aws:ses:us-east-1:123456789012:configuration-set/MyConfigSet" \
    --region us-east-1

Configurar políticas de reputação

As políticas de reputação determinam quando o envio de e-mails de um locatário é automaticamente pausado com base nas métricas de reputação. Quando você cria um locatário, o SES atribui automaticamente a política de reputação Padrão. Use as etapas a seguir se quiser mudar para outra política.

Usando o console:

Usando o AWS CLI:

update-reputation-entity-policy \
    --reputation-entity-type "RESOURCE" \
    --reputation-entity-reference "arn:aws:ses:us-east-1:123456789012:tenant/tenantId" \
    --reputation-entity-policy "arn:aws:ses:us-east-1:aws:reputation-policy/standard"

Enviar e-mails com locatários

Ao enviar e-mails por meio de um locatário, você deve especificar o locatário em suas chamadas de API ou cabeçalhos SMTP e garantir que todos os recursos utilizados estejam associados a esse locatário.

Usando a SendEmail API com inquilinos

AWS CLI Exemplo:

aws sesv2 send-email \
  --tenant-name "MyTenant" \
  --from-email-address "sender@example.com" \
  --destination "ToAddresses=recipient@example.com" \
  --content "Simple={Subject={Data='Test Subject',Charset=utf-8},Body={Text={Data='Test email body',Charset=utf-8}}}" \
  --configuration-set-name "MyConfigSet"

AWS Exemplo de SDK para Python:

import boto3

client = boto3.client('sesv2')
response = client.send_email(
    FromEmailAddress='sender@example.com',
    Destination={
        'ToAddresses': ['recipient@example.com']
    },
    Content={
        'Simple': {
            'Subject': {
                'Data': 'Test email'
            },
            'Body': {
                'Text': {
                    'Data': 'This is a test email sent using a tenant.'
                }
            }
        }
    },
    ConfigurationSetName='MyConfigurationSet',
     TenantName='MyTenant'
)

Usar SMTP com locatários

Ao usar SMTP para enviar e-mails por meio de um locatário, inclua as informações do locatário em um cabeçalho de e-mail:

X-SES-TENANT: MyTenant

Esse cabeçalho informa ao SES qual locatário deve ser usado para a operação de envio de e-mail, permitindo que o SES aplique a validação de recursos e o rastreamento de reputação apropriados.

Gerenciar status de locatários

Visualizar status e métricas de locatários

Usando o console:

Usando o AWS CLI:

# Get tenant details
aws sesv2 get-tenant --tenant-name "MyTenant"

Pausar e retomar locatários

É possível pausar manualmente os recursos de envio de um locatário sempre que necessário e reiniciá-los quando estiver com tudo pronto para retomar o envio.

Usando o console:

Usando o AWS CLI:

Para pausar um locatário:

# Pause a tenant
aws sesv2 update-reputation-entity-customer-managed-status \
  --reputation-entity-type RESOURCE 
  --reputation-entity-reference "arn:aws:ses:us-east-1:593442965613:tenant/tenantId"
  --sending-status DISABLED

Para retomar um locatário:

# Unpause a tenant
aws sesv2 update-reputation-entity-customer-managed-status \
  --reputation-entity-type RESOURCE 
  --reputation-entity-reference "arn:aws:ses:us-east-1:593442965613:tenant/tenantId"
  --sending-status ENABLED

Como trabalhar com descobertas de reputação

Visualizar descobertas de reputação

Usando o console:

Usando o AWS CLI:

aws sesv2 list-recommendations \
   --filter='{ "RESOURCE_ARN":"arn:aws:ses:us-east-1:012345678901:tenant/tenantId"}'

A resposta inclui detalhes sobre todas as descobertas ativas:

{
    "Recommendations": [
        {
            "ResourceArn": "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}",
            "Type": "BOUNCE",
            "Description": "The bounce rate exceeded 15.0% based on a representative volume of 664 emails from July 11, 2025 at 14:41 (UTC) to July 11, 2025 at 16:26 (UTC).",
            "Status": "OPEN",
            "CreatedTimestamp": "2025-07-11T16:16:14.029000+00:00",
            "LastUpdatedTimestamp": "2025-07-11T16:37:14.145000+00:00",
            "Impact": "HIGH"
        }
    ]
}

Noções básicas sobre as descobertas de reputação

As descobertas de reputação fornecem informações sobre possíveis problemas com as práticas de envio de e-mails de seus locatários. Cada descoberta inclui:

As descobertas comuns incluem:

Solucionar problemas de reputação

Ao receber uma descoberta de reputação, é importante investigar a causa-raiz e tomar medidas corretivas imediatamente:

Monitoramento e análise

Configurando CloudWatch métricas

A SES publica métricas específicas para inquilinos na Amazon. CloudWatch As seguintes métricas estão disponíveis para cada locatário:

Configurando EventBridge notificações

Por padrão, o SES envia eventos para o barramento de eventos EventBridge padrão quando as descobertas de reputação do inquilino são detectadas ou quando ocorrem alterações no status do inquilino.

Você pode criar regras no barramento de eventos padrão para identificar eventos específicos e enviá-los EventBridge para um ou mais destinos específicos.

Os seguintes tipos de detalhes estão disponíveis:

Para alterações no status de envio do locatário:

Para descobertas de reputação:

Exemplo de padrão de EventBridge regras para descobertas de reputação:

{
  "detail-type": "Advisor Recommendation Status Open",
  "source": "aws.ses",
  "account": "012345678901",
  "time": "2023-11-15T17:00:59Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}"
  ],
  "detail": { 
       "version": "1.0.0",
       "data": "The bounce rate exceeded 15.0% based on a representative volume of 197 emails from July 11, 2025 at 14:43 (UTC) to July 11, 2025 at 16:13 (UTC).",
       "metadata":{"impact":"HIGH","type":"BOUNCE"}
  
    }
}

Exemplo de padrão de EventBridge regra para enviar alterações de status:

{
        "detail-type": "Sending Status Disabled",
        "source": "aws.ses",
        "account": "012345678901",
        "time": "2025-07-24T12:44:28Z",
        "region": "us-east-1",
        "resources": [
            "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}"
        ],
        "detail": {
            "version": "1.0.0",
            "data": {
                "origin": "CUSTOMER_MANAGED",
                "record": {
                    "status": "DISABLED",
                    "cause": "Status manually updated.",
                    "lastUpdatedTimestamp": [2025, 7, 24, 12, 44, 28, 995000000]
                }
            }
        }
    }

Descrições dos campos:

Você pode usar esses eventos para monitorar alterações no status do locatário e automatizar respostas em suas aplicações. Por exemplo, talvez você queira acionar alertas quando os locatários estiverem desativados ou acompanhar as métricas de integridade dos locatários ao longo do tempo.

Integração com AWS Trust & Safety

Quando a AWS Trust & Safety detecta problemas que normalmente resultariam na fiscalização em nível de conta, o sistema de inquilinos permite respostas mais direcionadas. Em vez de pausar toda a sua conta, o Centro de Confiança e Segurança pode pausar apenas os locatários problemáticos, permitindo que os locatários compatíveis continuem enviando.

Essa imposição no nível do locatário reduz o impacto dos problemas de reputação e ajuda a manter a continuidade dos negócios em seus outros fluxos de e-mails.

Você receberá notificações quando o SES desativar o envio devido a problemas graves que afetam a reputação do locatário e tiver colocado sua conta sob análise. Um caso será aberto para você no AWS Support Center para que você possa trabalhar com a Trust & Safety para resolver problemas e restaurar o envio para o inquilino afetado.

Práticas recomendadas

Siga estas práticas recomendadas para gerenciar com eficácia a reputação dos locatários no Amazon SES:

Limitações

Ao usar o gerenciamento de locatários, esteja ciente destas limitações:

Preços

Há uma cobrança adicional por locatário por mês com base no número de e-mails. Para obter informações detalhadas sobre os preços, consulte a página de preços do SES.

Ao usar CloudWatch com métricas de inquilino, as CloudWatch métricas padrão para cada inquilino são fornecidas sem custo adicional como parte do monitoramento básico. CloudWatch Recursos adicionais, como painéis personalizados, alarmes ou monitoramento detalhado, podem incorrer em cobranças padrão. CloudWatch