Menu
Amazon Simple Notification Service
Developer Guide (API Version 2010-03-31)

Appendix: Large Payload and Raw Message Delivery

With Amazon SNS and Amazon SQS, you now have the ability to send large payload messages that are up to 256KB (262,144 bytes) in size. To send large payloads (messages between 64KB and 256KB), you must use an AWS SDK that supports AWS Signature Version 4 (SigV4) signing. To verify whether SigV4 is supported for an AWS SDK, check the SDK release notes.

In addition to sending large payloads, with Amazon SNS you can now enable raw message delivery for messages delivered to either Amazon SQS endpoints or HTTP/S endpoints. This eliminates the need for the endpoints to process JSON formatting, which is created for the Amazon SNS metadata when raw message delivery is not selected. For example when enabling raw message delivery for an Amazon SQS endpoint, the Amazon SNS metadata is not included and the published message is delivered to the subscribed Amazon SQS endpoint as is. When enabling raw message delivery for HTTP/S endpoints, the messages will contain an additional HTTP header x-amz-sns-rawdelivery with a value of true to indicate that the message is being published raw instead of with JSON formatting. This enables those endpoints to understand what is being delivered and enables easier transition for subscriptions from JSON to raw delivery.

To enable raw message delivery using one of the AWS SDKs, you must use the SetSubscriptionAttribute action and configure the RawMessageDelivery attribute with a value of true. The default value is false.

Enabling Raw Message Delivery with the AWS Management Console

You can enable raw message delivery using the AWS Management Console by setting the Raw Message Delivery subscription attribute to a value of true.

To enable raw message delivery with the AWS Management Console

  1. Sign in to the AWS Management Console and open the Amazon SNS console at https://console.aws.amazon.com/sns/v2/home.

  2. Select a topic that is subscribed to either an Amazon SQS endpoint or an HTTP/S endpoint and then click the topic ARN.

    The Topic Details page appears.

  3. Select the Subscription ID and then click the Other subscription actions drop-down box.

  4. Click Edit subscription attributes, select Raw Message Delivery, and then click Set subscription attributes.