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. # Uso de listas de supresión a nivel de inquilinos en Amazon SES Si utilizas el servicio multiusuario Amazon Simple Email Service (SES) para enviar correos electrónicos en nombre de varios inquilinos, puedes asignar a cada inquilino su propia lista de supresión. Tenant-level La supresión aísla los rechazos y las quejas para que solo afecten al inquilino que envió el correo electrónico. Sin esta función, todos los inquilinos comparten la lista de supresión a nivel de cuenta. Cuando un destinatario rechaza o se queja del correo electrónico de un inquilino, esa dirección se suprime para todos los inquilinos de la cuenta. Tenant-level La supresión evita esta contaminación entre inquilinos al mantener una lista separada de direcciones suprimidas para cada inquilino. ## Cómo funciona la supresión a nivel de inquilino Hay dos ajustes que controlan el comportamiento de supresión de cada inquilino: el *alcance de la supresión* y los motivos de la *supresión*. Los dos ajustes se configuran juntos mediante la operación de `PutTenantSuppressionAttributes` API o especificando `SuppressionAttributes` cuándo se crea un inquilino con la operación de `CreateTenant` API. El **alcance** de la supresión determina qué lista de supresión usa SES para el inquilino: + `TENANT`— Utilice la propia lista de supresión del inquilino. + `ACCOUNT`— Usa la lista de supresión a nivel de cuenta. Esta es la opción predeterminada tanto para los inquilinos actuales como para los nuevos. Los **motivos de supresión** determinan qué eventos hacen que SES añada direcciones a la lista de supresión: + `BOUNCE`— Agregue direcciones que produzcan rebotes bruscos. + `COMPLAINT`— Agregue direcciones que generen quejas. + `BOUNCE`y `COMPLAINT` — Agregue las direcciones que generen cualquiera de los dos eventos. + Vacío: no compruébelo ni registre en ninguna lista de supresión. **nota** Debe proporcionar `SuppressionScope` y `SuppressedReasons` juntos, o establecer ambos como nulos. Al establecer ambos valores como nulos, se borran los ajustes de supresión del arrendatario y se devuelve al comportamiento de `ACCOUNT` ámbito predeterminado. ### Comportamiento de supresión por configuración En la siguiente tabla se describe el tiempo de envío y el comportamiento de grabación para cada combinación del alcance de la supresión y los motivos de la supresión. | Alcance | Motivos | Send-time comportamiento | Grabar el comportamiento | | --- | --- | --- | --- | | TENANT | BOUNCE, COMPLAINT | Revisa la lista de inquilinos para ver si hay quejas o rechazos | Registra ambos en la lista de inquilinos | | TENANT | BOUNCE | Comprueba solo los rebotes en la lista de inquilinos | Los registros se transfieren únicamente a la lista de inquilinos | | TENANT | COMPLAINT | Comprueba la lista de inquilinos únicamente para ver si hay quejas | Registra las quejas presentadas únicamente a la lista de inquilinos | | TENANT | Vacío | Sin control de supresión | Sin grabación | | ACCOUNT | BOUNCE, COMPLAINT | Comprueba la lista de cuentas para ver si hay devoluciones y quejas | Registra ambos en la lista de cuentas | | ACCOUNT | BOUNCE | Comprueba solo los rebotes en la lista de cuentas | Los registros se transfieren únicamente a la lista de cuentas | | ACCOUNT | COMPLAINT | Comprueba la lista de cuentas solo para ver si hay quejas | Registra las quejas únicamente en la lista de cuentas | | ACCOUNT | Vacío | Sin control de supresión | Sin grabación | ## Prioridad de supresión y comportamiento en el momento del envío SES resuelve la configuración de supresión en el siguiente orden de prioridad, de mayor a menor: 1. **Conjunto de configuraciones**: si el conjunto de configuraciones especifica los ajustes de supresión, SES los usa. 1. **Inquilino**: si no existe una anulación del conjunto de configuraciones, SES usa la configuración de supresión del arrendatario. 1. **Cuenta**: si ni el conjunto de configuraciones ni el inquilino especifican los ajustes, SES usa los valores predeterminados a nivel de cuenta. **importante** El alcance de la supresión determina qué lista de supresión comprueba SES en el momento del envío. Cuando el alcance es válido`TENANT`, SES comprueba únicamente la lista de supresión del arrendatario y omite la lista de supresión a nivel de cuenta. No se suprime una dirección que esté en la lista de supresión a nivel de cuenta pero que no esté en la lista de supresión del inquilino. Cuando el alcance es válido`ACCOUNT`, SES comprueba únicamente la lista de supresión a nivel de cuenta. El ámbito también controla dónde se registran los rechazos y las quejas. ### El conjunto de configuraciones se anula El campo `SuppressionOptions` para un conjunto de configuraciones ahora incluye un `SuppressionScope` campo. Puede usar un conjunto de configuraciones para anular solo el ámbito, solo los motivos o ambos de forma independiente. Esto le proporciona un control detallado sobre el comportamiento de supresión para flujos de trabajo de envío específicos. No es necesario que cambies la configuración predeterminada del inquilino. ## Grabación de supresión automática Cuando el alcance de la supresión es`TENANT`, SES registra automáticamente las entradas de supresión de la siguiente manera: + **Retiros forzosos**: SES añade la dirección a la lista de supresión del inquilino y a la lista de supresión global. SES *no* añade la dirección a la lista de personas suprimidas a nivel de cuenta. + **Quejas**: SES agrega la dirección únicamente a la lista de personas excluidas del inquilino. + **Not-spam comentarios**: cuando un destinatario marca un mensaje denunciado anteriormente como correo no deseado, SES elimina automáticamente las entradas con el argumento «`COMPLAINT`motivo» de la lista de supresión del inquilino. ## Identificar los errores de supresión de inquilinos Cuando SES suprime un mensaje porque la dirección figura en la lista de personas excluidas de un inquilino, usted puede identificar el evento mediante los siguientes indicadores: + **Notificación de rebote**: el tipo de rebote tiene un subtipo `Permanent` de. `OnTenantSuppressionList` + **Administrador de entregabilidad virtual (VDM)**: el motivo del rebote es. `ON_TENANT_SUPPRESSION_LIST` + **Código de diagnóstico:** `"Amazon SES did not send the message to this address because it is on the suppression list for your tenant."` + **Etiqueta de evento**: SES agrega una `ses:tenant-name` etiqueta a las notificaciones de rebote y queja para que puedas identificar a qué inquilino pertenece el evento. ## Administrar las entradas de la lista de supresión de inquilinos Las entradas de la lista de supresión de inquilinos se gestionan mediante las mismas operaciones de API que se utilizan para las entradas a nivel de cuenta. Para segmentar la lista de supresión de un inquilino, incluye el `TenantName` parámetro en tu solicitud: + `PutSuppressedDestination`— Añade una dirección a la lista de exclusión de un inquilino. + `GetSuppressedDestination`— Recuperar los detalles sobre la dirección suprimida de un inquilino. + `DeleteSuppressedDestination`— Eliminar una dirección de la lista de direcciones suprimidas de un inquilino. + `ListSuppressedDestinations`— Listar todas las direcciones suprimidas de un inquilino. Si omite el `TenantName` parámetro, estas operaciones se dirigen a la lista de supresión a nivel de cuenta. Esto mantiene la compatibilidad con versiones anteriores de las integraciones existentes. ## Consideraciones y limitaciones Tenga en cuenta lo siguiente cuando utilice listas de supresión a nivel de inquilino: + **Multi-tenancy obligatorio**: debe tener la opción multiusuario de SES configurada con al menos un inquilino para poder utilizar esta función. + **Una lista por inquilino**: cada inquilino tiene exactamente una lista de supresión. Hay un mapeo individual entre los inquilinos y las listas de exclusión. + **Region-specific**— Las listas de supresión de inquilinos son específicas del Región de AWS lugar en el que se configuran. + **Las direcciones permanecen**: las direcciones suprimidas permanecen en la lista de inquilinos hasta que las elimines de forma explícita o hasta que SES las elimine automáticamente (por ejemplo, cuando un destinatario denuncia un evento que no es spam por una `COMPLAINT` razón determinada). + **Case-sensitive almacenamiento**: las direcciones de correo electrónico de la lista de supresión se guardan conservando mayúsculas y minúsculas. Las llamadas a la API para gestionar las listas de supresión requieren una coincidencia exacta de mayúsculas y minúsculas. + **Impacto en la cuota de envío**: los mensajes suprimidos por una lista de usuarios suprimidos se descontarán de tu cuota de envío diaria. + **Datos de quejas de** Gmail: Gmail no envía los datos de las quejas a SES. Las direcciones alojadas por Gmail no se añaden automáticamente a la lista de supresión de quejas. + **Restricciones aisladas**: no puedes llamar `PutSuppressedDestination` hasta que tu cuenta tenga acceso a la versión de producción. + **Borrar la configuración**: para borrar la configuración de supresión de un inquilino, llama `PutTenantSuppressionAttributes` con valores nulos tanto por su alcance como por sus motivos. + **Eliminar un inquilino**: al eliminar un inquilino, SES también elimina todas las entradas de la lista de supresión correspondientes a ese inquilino. ## Recursos relacionados Los siguientes recursos pueden ayudarle a obtener más información sobre las listas de supresión en SES. + [Uso de la lista de supresión de nivel de cuenta de Amazon SES](sending-email-suppression-list.md) + [Lista de supresión global de Amazon SES](sending-email-global-suppression-list.md)