View a markdown version of this page

Remise des messages bruts Amazon SNS - Amazon Simple Notification Service
Activation de la livraison de messages bruts à l'aide du Console de gestion AWSExemples de format des messagesAttributs des messages et distribution de messages bruts pour les abonnements Amazon SQS

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 qu'Streams de diffusion de Fanout to FirehoseAmazon SQS et les HTTP/S points de terminaison ne traitent le formatage JSON des messages, Amazon SNS autorise la distribution de messages bruts :

  • Lorsque vous activez la distribution de messages bruts pour nos points de terminaison 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 livraison de messages bruts pour les HTTP/S terminaux, l'en-tête HTTP x-amz-sns-rawdelivery dont la valeur est définie sur true est ajouté au message, indiquant que le message a été publié sans format JSON.

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

  • Lorsque vous activez la livraison de messages bruts pour les terminaux Firehose, le corps du message est transmis. 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 d'SetSubscriptionAttributeAPI et définir la valeur de l'RawMessageDeliveryattribut sur. true

Activation de la livraison de messages bruts à l'aide du Console de gestion AWS

  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 Firehose, à Amazon SQS ou HTTP/S à un point de terminaison.

  4. Sur la MyTopic page, dans la section Abonnement, choisissez un abonnement et choisissez Modifier.

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

  6. Cliquez sur 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 distribution de messages bruts pour les abonnements Amazon SQS

Amazon SNS prend en charge la diffusion 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 pour lesquels la livraison de messages bruts est 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. Amazon SNS supprime toutefois les messages contenant plus de 10 attributs de message destinés aux abonnements Amazon SQS lorsque la livraison de messages bruts est activée, les traitant comme des erreurs côté client.