本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon SNS原始訊息交付
為了避免讓 Amazon Data Firehose 、Amazon SQS和 HTTP/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,您必須使用 SetSubscriptionAttribute
API動作,並將 RawMessageDelivery
屬性的值設定為 true
。
使用 AWS Management Console啟用原始訊息交付
登入 Amazon SNS主控台
。 -
在導覽面板上,選擇 Topics (主題)。
-
在主題頁面上,選擇訂閱 Firehose、Amazon SQS或 HTTP/S 端點的主題。
-
在 上
MyTopic
頁面,在訂閱區段中,選擇訂閱,然後選擇編輯 。 -
在編輯上
EXAMPLE1-23bc-4567-d890-ef12g3hij456
頁面,在詳細資訊區段中,選擇啟用原始訊息傳遞 。 -
選擇 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,並將它們視為用戶端錯誤。