View a markdown version of this page

HTTP/HTTPS 通知 JSON 格式 - Amazon Simple Notification Service

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

HTTP/HTTPS 通知 JSON 格式

當 Amazon SNS 傳送通知至已訂閱之 HTTP 或 HTTPS 端點時，已傳送至端點的 POST 訊息具有包含 JSON 文件及以下名稱值組的訊息內文。

Type

訊息的類型。若是通知，類型為 Notification。

MessageId

全域唯一識別符 (UUID)，對於每個發布的訊息均為唯一。若是 Amazon SNS 在重試期間重送的通知，會使用原始訊息的訊息 ID。

TopicArn

發佈此訊息之主題的 Amazon 資源名稱 (ARN)。

Subject

發布通知至主題時指定的 Subject 參數。

注意

這是選擇性的參數。如果未指定 Subject，則此名稱值組不會顯示在 JSON 文件中。

Message

發布通知至主題時指定的 Message 值。

Timestamp

發佈通知的時間 (GMT)。

SignatureVersion

Amazon SNS 簽章所使用的版本。

  • 如果 SignatureVersion 為 1，則 Signature 為 Message、MessageId、Subject (如果存在)、Type、Timestamp 和 TopicArn 值的 Base-64 編碼 SHA1withRSA 簽章。

  • 如果 SignatureVersion 為 2，則 Signature 為 Message、MessageId、Subject (如果存在)、Type、Timestamp 和 TopicArn 值的 Base-64 編碼 SHA256withRSA 簽章。

Signature

以 Base64 編碼 SHA1withRSA 或 Message、MessageId、Subject (如果存在)、Type、Timestamp 和 TopicArn 值的 SHA256withRSA 簽章。

SigningCertURL

用於簽署訊息的憑證的 URL。

UnsubscribeURL

您可以用來從此主題取消訂閱端點的 URL。如果您造訪此 URL，Amazon SNS 會取消訂閱端點，並停止傳送通知至此端點。

MessageAttributes

Amazon SNS 代表您附加至已發佈訊息的訊息屬性，做為 JSON 物件。此物件會將每個屬性名稱映射至具有 Type和 的物件Value。如需屬性類型的詳細資訊，請參閱 Amazon SNS 訊息屬性。

注意

MessageAttributes 是選用的。如果發佈的訊息沒有訊息屬性，此名稱/值對不會顯示在此 JSON 文件中。

以下 HTTP POST 訊息是發至 HTTP 端點的 Notification 訊息的範例。

POST / HTTP/1.1
x-amz-sns-message-type: Notification
x-amz-sns-message-id: 22b80b92-fdea-4c2c-8f9d-bdfb0c7bf324
x-amz-sns-topic-arn: arn:aws:sns:us-west-2:123456789012:MyTopic
x-amz-sns-subscription-arn: arn:aws:sns:us-west-2:123456789012:MyTopic:c9135db0-26c4-47ec-8998-413945fb5a96
Content-Length: 773
Content-Type: text/plain; charset=UTF-8
Host: myhost.example.com
Connection: Keep-Alive
User-Agent: Amazon Simple Notification Service Agent

{
  "Type" : "Notification",
  "MessageId" : "22b80b92-fdea-4c2c-8f9d-bdfb0c7bf324",
  "TopicArn" : "arn:aws:sns:us-west-2:123456789012:MyTopic",
  "Subject" : "My First Message",
  "Message" : "Hello world!",
  "Timestamp" : "2012-05-02T00:54:06.655Z",
  "SignatureVersion" : "1",
  "Signature" : "EXAMPLEw6JRN...",
  "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-f3ecfb7224c7233fe7bb5f59f96de52f.pem",
  "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:123456789012:MyTopic:c9135db0-26c4-47ec-8998-413945fb5a96"
  }