Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Inquilinos

En este capítulo se explica cómo usar la administración de inquilinos de Amazon SES para aislar, monitorear y administrar el envío de correos electrónicos entre varios inquilinos dentro de su cuenta de SES. Esta función ayuda a los proveedores de software independientes (ISVs), las empresas y las organizaciones que envían correos electrónicos en nombre de varias entidades intermedias a mantener perfiles de reputación separados y evitar que los problemas con un inquilino afecten a otros.

¿Qué es la gestión de inquilinos?

La administración de inquilinos es una función que le permite crear contenedores aislados denominados «inquilinos» dentro de su cuenta de SES. Cada inquilino puede tener sus propias identidades de correo electrónico, conjuntos de configuraciones, plantillas y métricas de reputación, lo que garantiza que las actividades de correo electrónico estén completamente separadas entre los diferentes clientes o unidades de negocio.

La administración de arrendatarios aborda el problema de que las malas prácticas de correo electrónico de un cliente podían interrumpir toda una cuenta de SES y afectar a todos los demás clientes. Con el aislamiento de inquilinos, puede administrar varios flujos de correo electrónico de forma independiente y, al mismo tiempo, mantener una supervisión y un control centralizados.

Un inquilino actúa como un contenedor lógico que agrupa los recursos de SES relacionados. Cuando envías correos electrónicos en nombre de un inquilino específico, SES hace un seguimiento de las métricas de reputación y aplica las políticas a nivel de inquilino. Este aislamiento garantiza que una alta tasa de rebote o de quejas por parte de un inquilino no afecte a la capacidad de entrega de los correos electrónicos enviados por otros inquilinos.

La gestión de inquilinos es especialmente valiosa para:

Cómo funciona la gestión de inquilinos

La gestión de la reputación de los inquilinos funciona mediante la creación de un contenedor lógico para sus recursos de envío de correo electrónico. Usted asigna recursos específicos a cada inquilino, incluidas las identidades verificadas (dominios y direcciones de correo electrónico), los conjuntos de configuración y las plantillas. Al enviar un correo electrónico en nombre de un inquilino, debe especificarlo en su llamada a la API o en el encabezado SMTP, y SES verifica que los recursos que se utilizan estén asociados correctamente a ese inquilino.

Asociación de recursos

Los recursos de su cuenta de SES se pueden asociar a los inquilinos de dos maneras:

Cuando asocias un recurso a un inquilino, ese inquilino obtiene permiso para usar ese recurso para enviar correos electrónicos. Con cada solicitud de envío, SES valida que el inquilino especificado tiene permiso para usar la identidad, el conjunto de configuraciones y la plantilla de la solicitud. Si los recursos no están asociados correctamente, se produce un error en la solicitud de envío.

Supervisión y aplicación de la reputación

SES monitorea continuamente las principales métricas de reputación de cada inquilino, incluidas las tasas de rebote, las tasas de quejas (incluidas las del sistema Feedback Loop (FBL) del proveedor de buzones) y las señales de comentarios de terceros. Cuando estas métricas superan los umbrales definidos, SES crea «hallazgos de reputación» categorizados de la siguiente manera:

En función de estas conclusiones, SES puede detener automáticamente a los inquilinos problemáticos mediante las políticas de reputación que usted configure. Hay tres niveles de cumplimiento disponibles:

Cuando las estadísticas de un inquilino dan como resultado una reputación que cumple con los requisitos exigidos en virtud de la política seleccionada, el sistema actualiza automáticamente el estado de envío del inquilino a «En pausa», sin que ello afecte a la capacidad de envío de los demás inquilinos. Mientras un inquilino esté en pausa, cualquier intento de enviar un correo electrónico con ese inquilino fallará hasta que revises el problema y vuelvas a activar el envío manualmente. Además, puedes pausar manualmente las capacidades de envío de un inquilino cuando sea necesario y volver a pausarlas cuando estés listo para reanudar el envío.

Configurar inquilinos

Crear inquilinos

Uso de la consola:

Uso de AWS CLI:

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

Asignación de recursos a un inquilino

Tras crear un inquilino, debe asignar al menos una identidad verificada y un conjunto de configuraciones antes de que el inquilino pueda enviar correos electrónicos.

Uso de la consola:

Usando 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

Configuración de políticas de reputación

Las políticas de reputación determinan cuándo se detiene automáticamente el envío de correos electrónicos de un inquilino en función de las métricas de reputación. Al crear un inquilino, SES asigna automáticamente la política de reputación estándar. Siga los siguientes pasos si desea cambiar a otra política.

Uso de la consola:

Uso de 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 correos electrónicos a los inquilinos

Al enviar un correo electrónico a través de un arrendatario, debes especificar el arrendatario en tus llamadas a la API o en los encabezados SMTP y asegurarte de que todos los recursos utilizados estén asociados a ese arrendatario.

Uso de la SendEmail API con los inquilinos

AWS CLI Ejemplo:

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

Uso de SMTP con inquilinos

Cuando utilice SMTP para enviar correos electrónicos a través de un inquilino, incluya la información del inquilino en el encabezado del correo electrónico:

X-SES-TENANT: MyTenant

Este encabezado indica a SES qué inquilino debe usarse para la operación de envío del correo electrónico, lo que le permite aplicar la validación de recursos y el seguimiento de la reputación adecuados.

Administrar el estado del inquilino

Ver el estado y las métricas del inquilino

Uso de la consola:

Uso de: AWS CLI

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

Pausar y despausar a los inquilinos

Puede pausar manualmente las capacidades de envío de un inquilino cuando sea necesario y volver a pausarlas cuando esté listo para reanudar el envío.

Uso de la consola:

Uso de AWS CLI:

Para pausar a un 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 reanudar la pausa de un 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

Trabajando con los hallazgos de reputación

Ver los hallazgos de reputación

Uso de la consola:

Uso de AWS CLI:

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

La respuesta incluye detalles sobre todos los hallazgos activos:

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

Comprender los hallazgos sobre la reputación

Los resultados sobre la reputación proporcionan información sobre los posibles problemas relacionados con las prácticas de envío de correos electrónicos de sus inquilinos. Cada hallazgo incluye:

Los hallazgos más comunes incluyen:

Resolver problemas de reputación

Cuando recibas un informe sobre tu reputación, es importante investigar la causa raíz y tomar medidas correctivas con prontitud:

Monitoreo y análisis

Configuración de CloudWatch métricas

SES publica métricas específicas para los inquilinos en Amazon. CloudWatch Las siguientes métricas están disponibles para cada inquilino:

Configurar las notificaciones EventBridge

De forma predeterminada, SES envía los eventos al bus de eventos EventBridge predeterminado cuando se detectan datos sobre la reputación del inquilino o cuando se producen cambios en el estado del inquilino.

Puede crear reglas en el bus de eventos predeterminado para identificar eventos específicos y enviarlos EventBridge a uno o más destinos específicos.

Están disponibles los siguientes tipos de detalles:

Para los cambios de estado que envían los inquilinos:

Para determinar la reputación:

Ejemplo de patrón de EventBridge reglas para la búsqueda de reputación:

{
  "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"}
  
    }
}

Ejemplo de patrón de EventBridge reglas para enviar cambios de estado:

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

Descripciones de campos:

Puede usar estos eventos para monitorear los cambios en el estado de los inquilinos y automatizar las respuestas en sus aplicaciones. Por ejemplo, es posible que desee activar alertas cuando los inquilinos estén inhabilitados o realizar un seguimiento de las métricas de salud de los inquilinos a lo largo del tiempo.

Integración con AWS Trust & Safety

Cuando AWS Trust & Safety detecta problemas que normalmente se traducirían en una aplicación a nivel de cuenta, el sistema de inquilinos permite dar respuestas más específicas. En lugar de pausar toda tu cuenta, Trust & Safety puede pausar solo a los inquilinos problemáticos y, al mismo tiempo, permitir que los inquilinos que cumplan con las normas sigan enviando dinero.

Esta aplicación a nivel de inquilino reduce el impacto de los problemas de reputación y ayuda a mantener la continuidad empresarial del resto de sus flujos de correo electrónico.

Recibirás notificaciones cuando SES haya desactivado el envío debido a problemas graves que afecten a la reputación de los inquilinos y haya puesto tu cuenta en proceso de revisión. Se abrirá un caso para ti en el AWS Support Center para que puedas trabajar con Trust & Safety a fin de resolver los problemas y restablecer el envío para el inquilino afectado.

Prácticas recomendadas

Siga estas prácticas recomendadas para gestionar de forma eficaz la reputación de los inquilinos en Amazon SES:

Limitaciones

Cuando utilice la administración de inquilinos, tenga en cuenta estas limitaciones:

Precios

Hay un cargo adicional por inquilino y mes en función de la cantidad de correos electrónicos. Para obtener información detallada sobre los precios, consulta la página de precios de SES.

Cuando se usa CloudWatch con métricas de inquilinos, las CloudWatch métricas estándar para cada inquilino se proporcionan sin costo adicional como parte del monitoreo básico. CloudWatch Las funciones adicionales, como los paneles personalizados, las alarmas o el monitoreo detallado, pueden conllevar cargos estándar CloudWatch.