Remise des messages bruts Amazon SNS - Amazon Simple Notification Service

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Remise des messages bruts Amazon SNS

Pour éviter que les points de terminaison Amazon Data Firehose, Amazon SQS et HTTP/S ne traitent le formatage JSON des messages, Amazon SNS autorise la livraison de messages bruts :

  • Lorsque vous activez la livraison de messages bruts pour les points de terminaison Amazon Data Firehose ou Amazon SQS, toutes les métadonnées Amazon SNS sont supprimées du message publié et le message est envoyé tel quel.

  • Lorsque vous activez la remise de messages bruts pour les points de terminaison HTTP/S, l'en-tête HTTP x-amz-sns-rawdelivery avec sa valeur définie sur true est ajouté au message, indiquant que le message a été publié sans formatage JSON.

  • Lorsque vous activez la remise de messages bruts pour les points de terminaison HTTP/S, le corps du message, l'adresse IP du client et les en-têtes requis sont fournis. Lorsque vous spécifiez des attributs de message, ils ne seront pas envoyés.

  • Lorsque vous activez la livraison de messages bruts pour les points de terminaison Firehose, le corps du message est délivré. Lorsque vous spécifiez des attributs de message, ils ne seront pas envoyés.

Pour activer la livraison de messages bruts à l'aide d'un AWS SDK, vous devez utiliser l'action SetSubscriptionAttribute API et définir la valeur de l'RawMessageDeliveryattribut sur. true

Activation de la remise des messages bruts avec AWS Management Console

  1. Connectez-vous à la console Amazon SNS.

  2. Dans le panneau de navigation, choisissez Rubriques.

  3. Sur la page Rubriques, choisissez une rubrique abonnée à un point de terminaison Firehose, Amazon SQS ou HTTP/S.

  4. Sur la MyTopicpage, dans la section Abonnement, choisissez un abonnement, puis sélectionnez Modifier.

  5. Sur la page Modifier EXAMPLE1-23bc-4567-d890-ef12g3hij456, dans la section Détails, choisissez Activer la remise des messages bruts.

  6. Sélectionnez Enregistrer les modifications.

Exemples de format des messages

Dans les exemples suivants, le même message est envoyé deux fois à la même file d'attente Amazon SQS. La seule différence est que la remise des messages bruts est désactivée pour le premier message et activée pour le second.

  • La remise des messages bruts est désactivée

    { "Type": "Notification", "MessageId": "dc1e94d9-56c5-5e96-808d-cc7f68faa162", "TopicArn": "arn:aws:sns:us-east-2:111122223333:ExampleTopic1", "Subject": "TestSubject", "Message": "This is a test message.", "Timestamp": "2021-02-16T21:41:19.978Z", "SignatureVersion": "1", "Signature": "FMG5tlZhJNHLHUXvZgtZzlk24FzVa7oX0T4P03neeXw8ZEXZx6z35j2FOTuNYShn2h0bKNC/zLTnMyIxEzmi2X1shOBWsJHkrW2xkR58ABZF+4uWHEE73yDVR4SyYAikP9jstZzDRm+bcVs8+T0yaLiEGLrIIIL4esi1llhIkgErCuy5btPcWXBdio2fpCRD5x9oR6gmE/rd5O7lX1c1uvnv4r1Lkk4pqP2/iUfxFZva1xLSRvgyfm6D9hNklVyPfy+7TalMD0lzmJuOrExtnSIbZew3foxgx8GT+lbZkLd0ZdtdRJlIyPRP44eyq78sU0Eo/LsDr0Iak4ZDpg8dXg==", "SigningCertURL": "https://sns.us-east-2.amazonaws.com/SimpleNotificationService-010a507c1833636cd94bdb98bd93083a.pem", "UnsubscribeURL": "https://sns.us-east-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-east-2:111122223333:ExampleTopic1:e1039402-24e7-40a3-a0d4-797da162b297" }
  • La remise des messages bruts est activée

    This is a test message.

Attributs des messages et envoi de messages bruts pour les abonnements Amazon SQS

Amazon SNS prend en charge la livraison d'attributs de message, qui vous permettent de fournir des éléments de métadonnées structurés, tels que des horodatages, des données géospatiales, des signatures et des identifiants, concernant le message. Pour les abonnements Amazon SQS avec la livraison de messages bruts activée, un maximum de 10 attributs de message peuvent être envoyés. Pour envoyer plus de 10 attributs de message, vous devez désactiver la livraison de messages bruts. Cependant, Amazon SNS rejette les messages contenant plus de 10 attributs de message destinés aux abonnements Amazon SQS avec l'option Raw Message Delivery activée, les traitant comme des erreurs côté client.