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, monitorizar 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), a las empresas y a 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 administración de inquilinos?

La administración de inquilinos es una característica que le permite crear contenedores aislados denominados “inquilinos” en la 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 distintos clientes o unidades de negocio.

La administración de inquilinos soluciona el problema de que las malas prácticas de correo electrónico de un cliente puedan poner en pausa una cuenta de SES completa 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 monitorización y un control centralizados.

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

La administración de inquilinos es especialmente útil para lo siguiente:

Cómo funciona la administración de inquilinos

La administración de la reputación de inquilinos funciona mediante la creación de un contenedor lógico para los recursos de envío de correo electrónico. Usted asigna recursos específicos a cada inquilino, incluidas identidades verificadas (dominios y direcciones de correo electrónico), conjuntos de configuraciones y plantillas. Al enviar un correo electrónico en nombre de un inquilino, usted especifica el inquilino en la llamada a la API o el encabezado de 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 formas:

Cuando asocia un recurso a un inquilino, este obtiene permiso para usar ese recurso en el envío de correo electrónico. 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 en la solicitud. Si los recursos no están asociados correctamente, la solicitud de envío se deniega.

Monitorización de la reputación y aplicación de políticas reputacionales

SES monitoriza continuamente las principales métricas de reputación de cada inquilino, incluidas las tasas de rebote, las tasas de reclamaciones (también las que proceden del sistema de bucle de retroalimentación (FBL) del proveedor de bandeja de correo) y las señales proporcionadas por terceros. Cuando estas métricas superan los umbrales definidos, SES crea “resultados de reputación” categorizados de este modo:

En función de estos resultados, SES puede poner automáticamente en pausa a los inquilinos problemáticos mediante las políticas de reputación que usted configure. Hay tres niveles de aplicación de políticas:

Cuando las métricas de un inquilino desencadenan un resultado de reputación que alcanza el umbral de aplicación de la política seleccionada, el sistema actualiza automáticamente el estado de envío del inquilino a “En pausa”, sin que se vea afectada la capacidad de envío de los demás inquilinos. Mientras un inquilino esté en pausa, cualquier intento de enviar un correo electrónico a través de ese inquilino fallará hasta que se revise el problema y se vuelva a habilitar manualmente el envío. Además, puede pausar manualmente las capacidades de envío de un inquilino cuando sea necesario y reanudarlas cuando esté listo.

Configuración de inquilinos

Creación de inquilinos

Uso de la consola:

Mediante AWS CLI:

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

Asignación de recursos a un inquilino

Después de crear un inquilino, debe asignar al menos una identidad verificada y un conjunto de configuraciones antes de que el inquilino pueda enviar correo electrónico.

Uso de la consola:

Uso de 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 pone automáticamente en pausa 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 le asigna automáticamente la política de reputación Estándar. Siga estos 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"

Envío de correo electrónico con inquilinos

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

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 correo electrónico 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 de correo electrónico, lo que permite a SES aplicar la validación de recursos y el seguimiento de la reputación adecuados.

Administración del estado del inquilino

Visualización del estado y las métricas de inquilinos

Uso de la consola:

Uso de AWS CLI:

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

Pausa y reanudación de inquilinos

Puede poner manualmente en pausa las capacidades de envío de un inquilino cuando sea necesario y reanudarlas cuando esté listo para continuar con el envío.

Uso de la consola:

Uso de AWS CLI:

Cómo poner un inquilino en pausa:

# 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

Cómo reanudar 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

Uso de los resultados de reputación

Visualización de resultados 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 resultados 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"
        }
    ]
}

Comprensión de los resultados de reputación

Los resultados de reputación proporcionan información sobre posibles problemas relacionados con las prácticas de envío de correo electrónico de sus inquilinos. Cada resultado incluye:

Entre los resultados más frecuentes se incluyen:

Resolución de problemas de reputación

Cuando reciba un resultado de reputación, es importante que investigue la causa raíz y tome medidas correctoras con celeridad:

Monitoreo y análisis

Configuración de métricas CloudWatch

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 detecta la reputación de los inquilinos o cuando se producen cambios en el estado de los inquilinos.

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 cambios de estado de envío de los inquilinos:

Para resultados de 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]
                }
            }
        }
    }

Descripción de campos:

Puede utilizar estos eventos para monitorizar los cambios de estado en los inquilinos y automatizar las respuestas en sus aplicaciones. Por ejemplo, quizá convenga desencadenar alertas cuando los inquilinos estén deshabilitados o realizar un seguimiento de las métricas del estado 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 ofrece respuestas más específicas. En lugar de poner toda la cuenta en pausa, Trust & Safety puede poner en pausa solo a los inquilinos problemáticos y, al mismo tiempo, permitir que sigan realizando envíos los inquilinos que mantengan el cumplimiento.

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

Recibirá notificaciones cuando SES haya deshabilitado el envío debido a problemas graves que afecten a la reputación de los inquilinos y haya puesto su cuenta en 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 administrar de forma eficaz la reputación de los inquilinos en Amazon SES:

Limitaciones

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

Precios

Se cobra un cargo adicional por inquilino y mes en función de la cantidad de correos electrónicos. Para obtener información detallada sobre precios, consulte la página 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.