View a markdown version of this page

Publicación de mensajes de gran tamaño con Amazon SNS - Amazon Simple Notification Service

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.

Publicación de mensajes de gran tamaño con Amazon SNS

Amazon SNS admite cargas útiles de mensajes de hasta 1 MiB (1 048.576 bytes) al configurar el atributo de tema. MaximumMessageSize De forma predeterminada, los temas aceptan mensajes de hasta 256 KB. Los temas con MaximumMessageSize valores superiores a 256 KB son compatibles con Amazon Data Firehose, Amazon SQS y AWS Lambda las suscripciones, con un total de hasta 100 suscripciones por tema.

Cómo funciona la publicación de mensajes de gran tamaño

Puede establecer el atributo de MaximumMessageSize tema en cualquier valor entero comprendido entre 1.024 y 1.048.576 bytes. De forma predeterminada, todos los temas existentes y recién creados tienen 262.144 bytes MaximumMessageSize (256 KB).

Cuando publica un mensaje, Amazon SNS valida el tamaño combinado del cuerpo del mensaje y los atributos del mensaje comparándolo con el tema configurado. MaximumMessageSize Si el tamaño combinado supera el límite, Amazon SNS devuelve un InvalidParameter error al publicarlo.

Configuración admitida

Si lo establece MaximumMessageSize por encima de 256 KiB, Amazon SNS admite la siguiente configuración.

Límites de suscripción

El tema admite hasta 100 suscripciones en total. Si intenta crear suscripciones adicionales, Amazon SNS devolverá un InvalidParameter error.

Tipos de terminales compatibles

Los temas con MaximumMessageSize más de 256 KB admiten los siguientes tipos de terminales:

  • Amazon Data Firehose

  • Amazon SQS

  • AWS Lambda

Los temas de MaximumMessageSize 256 KB o menos también admiten terminales de SMS HTTP/HTTPS, correo electrónico, email-json y dispositivos push móviles (aplicaciones).

Centrarse en los temas existentes MaximumMessageSize

Puedes aumentar o reducir el número de temas MaximumMessageSize en cualquier momento. Tras cambiar el valor, Amazon SNS valida las nuevas solicitudes de publicación comparándolas con el límite actualizado.

Para establecer valores MaximumMessageSize superiores a 256 KB, el tema debe tener un total de 100 o menos suscripciones, todas las cuales deben ser de tipos de punto final compatibles (Amazon Data Firehose, Amazon SQS o). AWS Lambda Si el tema tiene tipos de punto final no compatibles o más de 100 suscripciones, Amazon SNS devuelve un error. InvalidParameter

Configurar el tema para mensajes de gran tamaño

Uso de AWS Consola de administración

Para configurar el tema para publicar mensajes más grandes
  1. Abra la consola de Amazon SNS en https://console.aws.amazon.com/sns/home.

  2. En el panel de navegación izquierdo, elija Topics (Temas).

  3. Selecciona tu tema y elige Editar.

  4. En Tamaño máximo de mensaje, establece el límite deseado (hasta 1024 KB).

  5. Seleccione Save changes (Guardar cambios).

Uso de AWS CLI

MaximumMessageSizeConfigúralo al crear un tema nuevo:

aws sns create-topic \ --name my-large-message-topic \ --attributes MaximumMessageSize=1048576

my-large-message-topicSustitúyalo por el nombre del tema y 1048576 por el tamaño máximo de mensaje deseado en bytes.

MaximumMessageSizeDefinir sobre un tema existente:

aws sns set-topic-attributes \ --topic-arn arn:aws:sns:us-east-1:123456789012:my-topic \ --attribute-name MaximumMessageSize \ --attribute-value 1048576

arn:aws:sns:us-east-1:123456789012:my-topicSustitúyalo por el ARN de su tema y 1048576 por el tamaño máximo de mensaje deseado en bytes.

Verifica que el tema sea actualMaximumMessageSize. Si el atributo no se ha establecido de forma explícita, no aparece en la respuesta y el tema utiliza el valor predeterminado de 262.144 bytes (256 KB).

aws sns get-topic-attributes \ --topic-arn arn:aws:sns:us-east-1:123456789012:my-topic

Referencia de la API de Amazon SNS para mensajes de gran tamaño

La compatibilidad con mensajes de gran tamaño utiliza las API de Amazon SNS existentes. No necesita nuevas operaciones de API.

API Cambio
CreateTopic Acepta MaximumMessageSize en el Attributes parámetro. Intervalo válido: 1.024 — 1.048.576 bytes.
SetTopicAttributes Acepta como nombre de atributo. MaximumMessageSize
GetTopicAttributes Devuelve MaximumMessageSize si el atributo se ha establecido explícitamente. Si no se devuelve, el tema utiliza el valor predeterminado de 262.144 bytes (256 KB).
Publish Valida el tamaño combinado del cuerpo del mensaje y los atributos del mensaje comparándolos con los del tema. MaximumMessageSize
PublishBatch Valida el tamaño combinado de todos los mensajes del lote (el cuerpo y los atributos de cada mensaje) comparándolo con el tamaño del tema. MaximumMessageSize

Compatibilidad con terminales

La siguiente lista describe cómo Amazon SNS envía los mensajes de gran tamaño a cada tipo de punto final compatible.

  • Amazon Data Firehose: Amazon Data Firehose carga los datos de streaming en almacenes de datos y servicios de análisis. Admite registros de hasta 1000 KiB (1 024 000 bytes). El mensaje entregado debe permanecer por debajo de este límite. El límite incluye los metadatos de entrega de Amazon SNS, como el identificador del mensaje y la marca de hora. Los mensajes que superan el límite no se entregan. Un tema MaximumMessageSize puede configurarse en un máximo de 1.024 KB (1.048.576 bytes). Por este motivo, te recomendamos que definas un valor inferior MaximumMessageSize para los temas con suscripciones a Firehose. Para conocer el límite actual de tamaño de los registros, consulte las cuotas de Amazon Data Firehose.

  • Amazon SQS: Amazon SNS puede entregar un mensaje a una cola de Amazon SQS suscrita hasta el tamaño máximo de mensaje admitido por Amazon SQS. La propia cola no se aplica a los mensajes de Amazon MaximumMessageSize SNS. El tema de Amazon SNS MaximumMessageSize es el límite de tamaño efectivo para estos mensajes.

  • AWS Lambda— Amazon SNS invoca AWS Lambda funciones de forma asincrónica. AWS Lambda admite cargas útiles de invocación asincrónica de hasta 1 MiB. No se requiere ninguna configuración adicional para las suscripciones. AWS Lambda

Prácticas recomendadas

Configure las colas de correo muerto

Se recomienda configurar una cola de espera (DLQ) en todas las suscripciones para evitar los errores en la entrega de los mensajes. Un DLQ captura los mensajes que Amazon SNS no puede entregar correctamente al punto final suscrito, lo que le permite inspeccionarlos y volver a procesarlos. Para obtener más información, consulte Colas de mensajes fallidos de Amazon SNS.

Supervise con métricas y alarmas CloudWatch

Utilice CloudWatch las métricas para supervisar la entrega de los mensajes y configurar alarmas para los envíos fallidos. La NumberOfNotificationsFailed métrica hace un seguimiento de los mensajes que Amazon SNS no puede entregar a los terminales suscritos. Cree una CloudWatch alarma en esta métrica para recibir alertas cuando se produzcan errores en la entrega. Para obtener más información, consulte Supervisar los temas de Amazon SNS mediante CloudWatch.

Publicar mensajes de más de 1 MiB con Amazon S3

Para publicar mensajes de más de 1 MiB, utilice la biblioteca de clientes ampliada de Amazon SNS para Java o la biblioteca de clientes ampliada de Amazon SNS para Python a fin de almacenar las cargas útiles en Amazon S3 y publicar una referencia a través de Amazon SNS. Estas bibliotecas admiten mensajes de hasta 2 GB y son compatibles con los temas estándar y FIFO. Para obtener instrucciones sobre cómo aumentar MaximumMessageSize antes de elegir este enfoque, consulteConfigurar el tema para mensajes de gran tamaño.