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.
Administrar las entradas de la lista de supresión de inquilinos
Las entradas de la lista de supresión de un inquilino se gestionan mediante las mismas operaciones de API de Amazon Simple Email Service (SES) que se utilizan para la lista de supresión a nivel de cuenta. Para segmentar la lista de un inquilino específico, incluye el --tenant-name parámetro en cada solicitud. Si omite este parámetro, las operaciones se dirigen a la lista a nivel de cuenta. Úselo AWS CLI para agregar, comprobar, eliminar y enumerar las direcciones suprimidas de un inquilino específico.
importante
Las direcciones de correo electrónico de la lista de supresión se guardan con mayúsculas y minúsculas. Si bien la funcionalidad de envío de correo electrónico trata las direcciones con mayúsculas y minúsculas diferentes como idénticas, las llamadas a la API para gestionar las listas de supresión requieren que coincidan exactamente entre mayúsculas y minúsculas. Asegúrese de utilizar las mismas mayúsculas y minúsculas de la dirección de correo electrónico que aparece en la lista de supresión cuando añada, compruebe o elimine entradas.
Requisitos previos
Antes de gestionar las entradas en la lista de inquilinos suprimidos, asegúrate de cumplir los siguientes requisitos:
-
Tenant-level la supresión está habilitada para el inquilino. Para obtener más información, consulte Configuración de la supresión a nivel de inquilino.
-
AWS CLI la versión 2 está instalada y configurada con los permisos adecuados. Para obtener más información, consulte la Guía del usuario de AWS Command Line Interface.
-
El inquilino existe en su cuenta de SES.
Añadir una dirección a la lista de personas excluidas de un inquilino
Utilice la operación de PutSuppressedDestination API con el --tenant-name parámetro para añadir una dirección de correo electrónico a la lista de supresión de un inquilino.
Para añadir una dirección a la lista de supresión de un inquilino mediante el AWS CLI
-
En la línea de comandos, introduzca el comando siguiente:
En el ejemplo anterior,
recipient@example.comsustitúyala por la dirección de correo electrónico queBOUNCEdeseas añadir, por el motivo de la supresión (los valores aceptables sonBOUNCEyCOMPLAINTMyTenant) y por el nombre del inquilino.
El comando no produce ningún resultado en caso de éxito (HTTP 200). La dirección está ahora en la lista de supresión del inquilino.
nota
El --reason parámetro acepta BOUNCE oCOMPLAINT. Puede añadir la misma dirección por diferentes motivos.
Comprobar si una dirección está en la lista de exclusión de un inquilino
Utilice la operación de GetSuppressedDestination API con el --tenant-name parámetro para comprobar si una dirección de correo electrónico está en la lista de supresión de un inquilino.
Para comprobar si una dirección está en la lista de supresión de un inquilino, utilice la AWS CLI
-
En la línea de comandos, introduzca el comando siguiente:
En el ejemplo anterior,
recipient@example.comsustitúyala por la dirección de correo electrónico que deseas comprobar yMyTenantpor el nombre del inquilino.
Si la dirección está en la lista de supresión del inquilino, el comando devuelve un resultado parecido al siguiente ejemplo:
{ "SuppressedDestination": { "EmailAddress": "recipient@example.com", "Reason": "BOUNCE", "LastUpdateTime": "2026-03-15T10:30:00.000Z", "Attributes": { "MessageId": "0100018e1234abcd-12345678-abcd-1234-abcd-123456789012-000000", "FeedbackId": "0100018e1234abce-12345678-abcd-1234-abcd-123456789012-000000" } } }
La respuesta incluye los siguientes campos:
-
EmailAddress— La dirección de correo electrónico suprimida. -
Reason— Por qué se suprimió la dirección (BOUNCEoCOMPLAINT). -
LastUpdateTime— Cuándo se actualizó la entrada por última vez. -
Attributes— ContieneMessageIdyFeedbackIdproviene del evento que provocó la supresión. Estos campos están presentes para las direcciones suprimidas automáticamente y ausentes para las entradas añadidas manualmente.
nota
Si la dirección no está en la lista de supresión del inquilino, la API devuelve unNotFoundException.
Eliminar una dirección de la lista de supresión de un inquilino
Utilice la operación de DeleteSuppressedDestination API con el --tenant-name parámetro para eliminar una dirección de correo electrónico de la lista de supresión de un inquilino.
Para eliminar una dirección de la lista de supresión de un inquilino mediante el AWS CLI
-
En la línea de comandos, introduzca el comando siguiente:
En el ejemplo anterior,
recipient@example.comsustitúyala por la dirección de correo electrónico que deseas eliminar yMyTenantpor el nombre del inquilino.
El comando no produce ningún resultado en caso de éxito (HTTP 200). La dirección se elimina de la lista de supresión del inquilino.
importante
Eliminar una dirección de la lista de supresión de un inquilino no la elimina de la lista de supresión global ni de la lista de supresión a nivel de cuenta. Cada lista se gestiona de forma independiente.
Incluir direcciones en una lista de exclusión de inquilinos
Utilice la operación de ListSuppressedDestinations API con el --tenant-name parámetro para recuperar todas las direcciones suprimidas de un inquilino específico.
Para enumerar todas las direcciones de la lista de supresión de un inquilino, utilice la AWS CLI
-
En la línea de comandos, introduzca el comando siguiente:
En el ejemplo anterior,
MyTenantsustitúyalo por el nombre del inquilino.
El siguiente ejemplo de salida muestra dos direcciones suprimidas:
{ "SuppressedDestinationSummaries": [ { "EmailAddress": "bounce@example.com", "Reason": "BOUNCE", "LastUpdateTime": "2026-03-10T08:15:00.000Z" }, { "EmailAddress": "complaint@example.com", "Reason": "COMPLAINT", "LastUpdateTime": "2026-03-12T14:30:00.000Z" } ] }
Filtrar los resultados
Puede filtrar los resultados por motivo, intervalo de fechas o ambos.
El siguiente comando filtra por motivo:
El siguiente comando filtra por intervalo de fechas:
Si la respuesta incluye un NextToken valor, utilícelo en una solicitud posterior para recuperar más resultados. Utilice el --page-size parámetro para controlar el número de resultados por página.
nota
La operación de lista devuelve únicamente información resumida. Para obtener todos los detallesAttributes, incluso, GetSuppressedDestination utilícela para direcciones individuales.
Entradas de supresión automática
SES gestiona automáticamente las entradas de supresión en función de la configuración de supresión del inquilino. No es necesario realizar ninguna acción para las entradas automáticas. Aparecen en la lista de inhabilitados por los inquilinos junto con las entradas añadidas manualmente.
SES añade automáticamente las entradas en los siguientes casos:
-
Se produce un rebote fuerte si el inquilino ha activado la supresión del rebote.
-
Se recibe una queja si el inquilino tiene habilitada la supresión de quejas.
SES elimina automáticamente las entradas en los siguientes casos:
-
Se recibe un informe que no es spam en el caso de una dirección cuya queja ha sido suprimida.
