Amazon SNS原始訊息交付 - Amazon Simple Notification Service

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Amazon SNS原始訊息交付

為了避免讓 Amazon Data Firehose Amazon SQSHTTP/S 端點處理訊息JSON格式,Amazon 允許SNS原始訊息交付:

  • 當您啟用 Amazon Data Firehose 或 Amazon SQS端點的原始訊息傳遞時,任何 Amazon SNS中繼資料都會從已發佈的訊息中分割,並按原樣傳送訊息。

  • 當您為 HTTP/S 端點啟用原始訊息交付時,x-amz-sns-rawdelivery其值設為 的HTTP標頭true會新增至訊息,表示訊息已發佈,無需JSON格式化。

  • 當您為 HTTP/S 端點啟用原始訊息傳遞時,訊息內文、用戶端 IP 和所需的標頭都會傳遞。當您指定訊息屬性時,系統不會傳送該訊息。

  • 當您為 Firehose 端點啟用原始訊息傳遞時,訊息內文就會傳遞。當您指定訊息屬性時,系統不會傳送該訊息。

若要使用 啟用原始訊息傳遞 AWS SDK,您必須使用 SetSubscriptionAttributeAPI動作,並將 RawMessageDelivery 屬性的值設定為 true

使用 AWS Management Console啟用原始訊息交付

  1. 登入 Amazon SNS主控台

  2. 在導覽面板上,選擇 Topics (主題)

  3. 主題頁面上,選擇訂閱 Firehose、Amazon SQS或 HTTP/S 端點的主題。

  4. 在 上 MyTopic 頁面,在訂閱區段中,選擇訂閱,然後選擇編輯

  5. 編輯上 EXAMPLE1-23bc-4567-d890-ef12g3hij456 頁面,在詳細資訊區段中,選擇啟用原始訊息傳遞

  6. 選擇 Save changes (儲存變更)。

訊息格式範例

在下列範例中,相同的訊息會傳送至相同的 Amazon SQS佇列兩次。唯一的差異是第一封郵件的原始訊息交付會停用,第二封郵件則會啟用。

  • 原始訊息交付停用

    { "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" }
  • 原始訊息交付啟用

    This is a test message.

Amazon SQS訂閱的訊息屬性和原始訊息交付

Amazon SNS支援訊息屬性的傳遞,可讓您提供有關訊息的結構化中繼資料項目,例如時間戳記、地理空間資料、簽章和識別符。對於啟用原始訊息傳遞的 Amazon SQS訂閱,最多可以傳送 10 個訊息屬性。若要傳送超過 10 個訊息屬性,您必須停用原始訊息傳遞。不過,Amazon 會在啟用原始訊息交付的情況下捨SNS棄具有超過 10 個訊息屬性的訊息SQS,並將它們視為用戶端錯誤。