View a markdown version of this page

Configuración de la supresión a nivel de inquilino - Amazon Simple Email Service
Requisitos previosHabilitar la supresión a nivel de inquilinoConfigurar la supresión para un nuevo inquilinoAnular con un conjunto de configuracionesDeshabilitar la supresión a nivel de inquilinoVisualización de la configuración de supresión actualResolución de problemasRecursos relacionados

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.

Configuración de la supresión a nivel de inquilino

Configura los ajustes de supresión a nivel de inquilino para controlar la forma en que Amazon Simple Email Service (Amazon SES) gestiona los rechazos y las quejas de los inquilinos individuales. De forma predeterminada, los inquilinos utilizan tu lista de supresión a nivel de cuenta. Al activar la supresión a nivel de inquilino, SES mantiene una lista de supresión independiente para cada inquilino. Esto le proporciona un control pormenorizado sobre la capacidad de entrega del correo electrónico.

En este tema se proporcionan los procedimientos para habilitar, modificar, deshabilitar y ver la configuración de supresión a nivel de inquilino mediante el. AWS CLI

importante

Al deshabilitar la supresión a nivel de inquilino, no se eliminan las entradas existentes de la lista de supresión del inquilino. Si vuelves a activar la supresión a nivel de inquilino más adelante, esas entradas seguirán activas.

Requisitos previos

Antes de configurar la supresión a nivel de inquilino, asegúrese de cumplir los siguientes requisitos:

Habilitar la supresión a nivel de inquilino para un inquilino existente

Utilice la operación de la PutTenantSuppressionAttributes API para habilitar la supresión a nivel de inquilino para un inquilino existente. Esta operación es idempotente, por lo que puede llamarla varias veces con los mismos parámetros sin efectos secundarios.

Para habilitar la supresión a nivel de inquilino

  1. En la línea de comandos, ejecute el siguiente put-tenant-suppression-attributes comando para habilitar la supresión a nivel de inquilino tanto de los rebotes como de las quejas:

    Linux, macOS, or Unix
    aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE COMPLAINT

    MyTenantSustitúyalo por el nombre de su inquilino.

  2. Compruebe que el comando no devuelva ningún resultado. Una solicitud correcta devuelve una respuesta HTTP 200 sin cuerpo.

  3. Confirme la configuración ejecutando el siguiente comando:

    aws sesv2 get-tenant --tenant-name MyTenant

El inquilino ahora usa su propia lista de supresión tanto para los rechazos como para las quejas.

También puedes configurar la supresión por un único tipo de motivo. Los siguientes ejemplos muestran cómo habilitar la supresión únicamente para los rebotes o solo para las quejas.

El siguiente comando solo suprime los rebotes:

Linux, macOS, or Unix
aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE
Windows
aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE

El siguiente comando solo suprime las quejas:

Linux, macOS, or Unix
aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope TENANT \
--suppressed-reasons COMPLAINT
Windows
aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope TENANT `
--suppressed-reasons COMPLAINT
nota

Deben proporcionar --suppression-scope y --suppressed-reasons juntos. Proporcionar uno sin el otro devuelve unInvalidParameterValueException.

Configurar la supresión al crear un nuevo inquilino

Utilice la operación de CreateTenant API con el SuppressionAttributes parámetro para crear un inquilino con la supresión a nivel de inquilino habilitada desde el principio.

Para crear un inquilino con la supresión a nivel de inquilino

  1. En la línea de comandos, ejecute el siguiente create-tenant comando:

    Linux, macOS, or Unix
    aws sesv2 create-tenant \
--tenant-name MyNewTenant \
--suppression-attributes '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE","COMPLAINT"]}'
    Windows
    aws sesv2 create-tenant `
--tenant-name MyNewTenant `
--suppression-attributes '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE","COMPLAINT"]}'

    MyNewTenantSustitúyalo por el nombre del nuevo inquilino.

  2. Compruebe que la respuesta contenga el identificador del inquilino:

    {
    "TenantId": "tn-abc123def456"
}

El inquilino se crea con la supresión a nivel de inquilino habilitada tanto para los rechazos como para las quejas.

nota

Si lo omites--suppression-attributes, el inquilino utilizará de forma predeterminada el ACCOUNT alcance y utilizará la lista de supresión a nivel de cuenta.

Anular la supresión de inquilinos con un conjunto de configuraciones

Puede anular la configuración de supresión de un inquilino agregándola SuppressionScope a la de un conjunto de configuraciones. SuppressionOptions Al enviar un correo electrónico con este conjunto de configuraciones, las opciones de supresión del conjunto de configuraciones tienen prioridad sobre las del inquilino. Puede anular solo el alcance, solo los motivos o ambos de forma independiente.

Para crear un conjunto de configuraciones con la anulación del ámbito del inquilino

  1. En la línea de comandos, ejecute el siguiente create-configuration-set comando:

    Linux, macOS, or Unix
    aws sesv2 create-configuration-set \
--configuration-set-name my-config-set \
--suppression-options '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE"]}'
    Windows
    aws sesv2 create-configuration-set `
--configuration-set-name my-config-set `
--suppression-options '{"SuppressionScope":"TENANT","SuppressedReasons":["BOUNCE"]}'

    my-config-setSustitúyalo por el nombre del conjunto de configuraciones.

  2. Compruebe que el comando no devuelva ningún resultado. Una solicitud correcta devuelve una respuesta HTTP 200.

Para actualizar un conjunto de configuraciones existente con opciones de supresión

  1. En la línea de comandos, ejecute el siguiente put-configuration-set-suppression-options comando:

    Linux, macOS, or Unix
    aws sesv2 put-configuration-set-suppression-options \
--configuration-set-name my-config-set \
--suppression-scope TENANT \
--suppressed-reasons BOUNCE
    Windows
    aws sesv2 put-configuration-set-suppression-options `
--configuration-set-name my-config-set `
--suppression-scope TENANT `
--suppressed-reasons BOUNCE

    my-config-setSustitúyalo por el nombre del conjunto de configuraciones.

  2. Compruebe que el comando no devuelva ningún resultado. Una solicitud correcta devuelve una respuesta HTTP 200.

Deshabilitar la supresión a nivel de inquilino

Para que un inquilino vuelva a realizar la supresión a nivel de cuenta, puedes configurar el alcance ACCOUNT o borrar todas las opciones de supresión.

Para configurar el inquilino para que suprima el nivel de la cuenta

  1. En la línea de comandos, ejecuta el siguiente comando para establecer el alcance de forma explícita en: ACCOUNT

    Linux, macOS, or Unix
    aws sesv2 put-tenant-suppression-attributes \
--tenant-name MyTenant \
--suppression-scope ACCOUNT \
--suppressed-reasons BOUNCE COMPLAINT
    Windows
    aws sesv2 put-tenant-suppression-attributes `
--tenant-name MyTenant `
--suppression-scope ACCOUNT `
--suppressed-reasons BOUNCE COMPLAINT

    MyTenantSustitúyalo por el nombre de su inquilino.

  2. Compruebe que el comando no devuelva ningún resultado.

Para borrar todos los ajustes de supresión

  1. En la línea de comandos, ejecute el siguiente comando sin especificar el alcance ni los motivos:

    aws sesv2 put-tenant-suppression-attributes --tenant-name MyTenant

    MyTenantSustitúyalo por el nombre de su inquilino.

  2. Compruebe que el comando no devuelva ningún resultado.

nota

Si omite ambas --suppression-scope y--suppressed-reasons, SES borra la configuración de supresión del inquilino. El inquilino recurre a un comportamiento de supresión a nivel de cuenta.

importante

Al deshabilitar la supresión a nivel de inquilino, no se eliminan las entradas existentes de la lista de supresión del inquilino. Si vuelves a activar la supresión a nivel de inquilino más adelante, esas entradas seguirán activas.

Visualización de la configuración de supresión actual

Utilice la operación de la GetTenant API para comprobar la configuración de supresión actual de un inquilino.

Para ver la configuración de supresión de un inquilino

  1. En la línea de comandos, ejecute el siguiente get-tenant comando:

    aws sesv2 get-tenant --tenant-name MyTenant

    MyTenantSustitúyalo por el nombre de su inquilino.

  2. Revise la respuesta. El siguiente ejemplo muestra a un inquilino con la supresión a nivel de inquilino habilitada:

    {
    "Tenant": {
        "TenantName": "MyTenant",
        "TenantId": "tn-abc123def456",
        "TenantArn": "arn:aws:ses:us-east-1:123456789012:tenant/MyTenant/tn-abc123def456",
        "SendingStatus": "ENABLED",
        "CreatedTimestamp": 1705312800,
        "UpdateTimestamp": 1705762800,
        "SuppressionAttributes": {
            "SuppressionScope": "TENANT",
            "SuppressedReasons": ["BOUNCE", "COMPLAINT"]
        }
    }
}

En la siguiente tabla se describen los campos clave del SuppressionAttributes objeto.

Campo Description (Descripción)
SuppressionScope El ámbito de supresión para el inquilino. Un valor de TENANT significa que el inquilino usa su propia lista de supresión. Un valor de ACCOUNT significa que el inquilino usa la lista de supresión a nivel de cuenta.
SuppressedReasons Los motivos de supresión que están activos para el inquilino. Los valores posibles son BOUNCECOMPLAINT, o ambos.

Si la respuesta no aparece o SuppressionAttributes es nula, el inquilino utiliza la supresión a nivel de cuenta.

Resolución de problemas

Los siguientes son errores comunes que se pueden encontrar al configurar la supresión a nivel de inquilino.

InvalidParameterValueException: SuppressedReasons cannot be null when SuppressionScope is provided

  • Causa: especificó --suppression-scope sin ella. --suppressed-reasons

  • Solución: proporciona ambos parámetros juntos u omítelos para borrar los ajustes.

InvalidParameterValueException: SuppressionScope is required when SuppressedReasons are provided

  • Causa: especificó --suppressed-reasons sin --suppression-scope ellos.

  • Corrección: proporciona ambos parámetros juntos.

NotFoundException

  • Causa: el nombre del inquilino que especificó no existe.

  • Solución: compruebe el nombre del inquilino ejecutando el siguiente comando:

    aws sesv2 list-tenants