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 inquilinos do Amazon SES para isolar, monitorar e gerenciar o envio de e-mail entre vários inquilinos em sua conta 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 é gerenciamento de inquilinos?

O gerenciamento de inquilinos é um recurso que permite criar contêineres isolados chamados “inquilinos” em sua conta SES. Cada locatário pode ter suas próprias identidades de e-mail, conjuntos de configurações, 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 inquilinos aborda o desafio em que as práticas inadequadas de e-mail de um cliente poderiam anteriormente pausar uma conta SES inteira, afetando todos os outros clientes. Com o isolamento do inquilino, você pode gerenciar vários fluxos de e-mail de forma independente, mantendo a supervisão e o controle centralizados.

Um inquilino 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 aplica políticas no nível do inquilino. Esse isolamento garante que uma alta taxa de rejeição ou taxa de reclamação de um inquilino não afete a capacidade de entrega de e-mails enviados por outros inquilinos.

O gerenciamento de inquilinos é particularmente valioso para:

Como funciona o gerenciamento de inquilinos

O gerenciamento da reputação do inquilino funciona criando um contêiner lógico para seus recursos de envio de e-mail. Você atribui recursos específicos a cada inquilino, incluindo identidades verificadas (domínios e endereços de e-mail), conjuntos de configurações e modelos. Ao enviar um e-mail em nome de um inquilino, 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 inquilino.

Associação de recursos

Os recursos em sua conta SES podem ser associados aos inquilinos de duas maneiras:

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

Monitoramento e fiscalização da reputação

A SES monitora continuamente as principais métricas de reputação de cada inquilino, incluindo taxas de rejeição, taxas de reclamação (incluindo aquelas do sistema Feedback Loop (FBL) do provedor de caixas de correio) e sinais de feedback de terceiros. Quando essas métricas excedem os limites definidos, a SES cria “descobertas de reputação” categorizadas como:

Com base nessas descobertas, o SES pode pausar automaticamente inquilinos problemáticos por meio de políticas de reputação que você configura. Três níveis de fiscalização estão disponíveis:

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

Configurando inquilinos

Criação de inquilinos

Usando o console:

Usando o AWS CLI:

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

Atribuição de recursos a um inquilino

Depois de criar um inquilino, você deve atribuir pelo menos uma identidade verificada e um conjunto de configurações antes que o inquilino possa enviar e-mail.

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

Configurando políticas de reputação

As políticas de reputação determinam quando o envio de e-mails de um inquilino é automaticamente pausado com base nas métricas de reputação. Quando você cria um inquilino, 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"

Envio de e-mail com inquilinos

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 usados estejam associados a esse inquilino.

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'
)

Usando SMTP com inquilinos

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

X-SES-TENANT: MyTenant

Esse cabeçalho informa ao SES qual inquilino 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.

Gerenciando o status do inquilino

Visualizando o status e as métricas do inquilino

Usando o console:

Usando o AWS CLI:

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

Pausando e retomando inquilinos

Você pode pausar manualmente os recursos de envio de um inquilino quando necessário e retomá-los quando estiver pronto para retomar o envio.

Usando o console:

Usando o AWS CLI:

Para pausar um inquilino:

# 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 a pausa de um inquilino:

# 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

Trabalhando com descobertas de reputação

Visualizando 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"
        }
    ]
}

Entendendo 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-mail de seus inquilinos. Cada descoberta inclui:

As descobertas comuns incluem:

Resolvendo 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 métricas a seguir estão disponíveis para cada inquilino:

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 de status de envio do inquilino:

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 de campo:

Você pode usar esses eventos para monitorar as alterações no status do inquilino e automatizar as respostas em seus aplicativos. Por exemplo, talvez você queira acionar alertas quando os inquilinos estão desativados ou acompanhar as métricas de saúde dos inquilinos 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 Trust & Safety pode pausar apenas os inquilinos problemáticos, permitindo que os inquilinos compatíveis continuem enviando.

Essa fiscalização em nível de inquilino reduz o impacto dos problemas de reputação e ajuda a manter a continuidade dos negócios em seus outros fluxos de e-mail.

Você receberá notificações quando a SES desativar o envio devido a problemas de alta gravidade que afetam a reputação do inquilino 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 melhores práticas para gerenciar com eficácia a reputação do inquilino no Amazon SES:

Limitações

Ao usar o gerenciamento de inquilinos, esteja ciente dessas limitações:

Preços

Há uma taxa adicional por inquilino por mês com base no número de e-mails. Para obter informações detalhadas sobre preços, consulte a página de preços da 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 gerar cobranças padrão. CloudWatch