View a markdown version of this page

HTTP/HTTPS JSON-Format für Benachrichtigungen - Amazon Simple Notification Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

HTTP/HTTPS JSON-Format für Benachrichtigungen

Wenn Amazon SNS eine Benachrichtigung an einen abonnierten HTTP- oder HTTPS-Endpunkt sendet, enthält der Nachrichtentext der POST-Nachricht, die an den Endpunkt gesendet wurde, ein JSON-Dokument mit den folgenden Name-Wert-Paaren.

Type

Der Nachrichtentyp. Für eine Bestätigung ist der Typ Notification.

MessageId

Ein universell eindeutiger Bezeichner (UUID), der für jede veröffentlichte Benachrichtigung eindeutig ist. Für eine Benachrichtigung, die Amazon SNS während eines Wiederholversuchs sendet, wird die Nachrichten-ID der ursprünglichen Nachricht verwendet.

TopicArn

Amazon Resource Name (ARN) des Themas, in dem die Nachricht veröffentlicht wurde.

Subject

Der Parameter Subject, der bei der Veröffentlichung der Benachrichtigung im Thema angegeben wurde.

Anmerkung

Dieser Parameter ist optional. Wenn kein Subject angegeben wurde, wird dieses Name-Wert-Paar nicht in diesem JSON-Dokument angezeigt.

Message

Der Nachrichtenwert Message, der bei der Veröffentlichung der Benachrichtigung im Thema angegeben wurde.

Timestamp

Uhrzeit (GMT), zu der die Benachrichtigung veröffentlicht wurde.

SignatureVersion

Version der verwendeten Amazon-SNS-Signatur.

  • Wenn der 1 SignatureVersion ist, Signature ist dies eine Base64-encoded SHA1withRSA Signatur der TopicArn Werte MessageMessageId,, Subject (falls vorhanden) TypeTimestamp,, und.

  • Wenn der SignatureVersion gleich 2 Signature ist, ist dies eine Base64-encoded SHA256withRSA Signatur der TopicArn Werte MessageMessageId,, Subject (falls vorhanden) TypeTimestamp,, und.

Signature

Base64-encoded SHA1withRSAoder SHA256withRSA Signatur der TopicArn Werte MessageMessageId,, Subject (falls vorhanden) TypeTimestamp,, und.

SigningCertURL

Die URL, die den Zugriff auf das Zertifikat ermöglicht, das zum Signieren der Nachricht verwendet wurde.

UnsubscribeURL

Eine URL, die Sie verwenden können, um den Endpunkt aus diesem Thema abzumelden. Wenn Sie diese URL besuchen, meldet Amazon SNS den Endpunkt ab und es werden keine weiteren Benachrichtigungen an diesen Endpunkt gesendet.

MessageAttributes

Amazon SNS stellt die Nachrichtenattribute dar, die Sie als JSON-Objekt an die veröffentlichte Nachricht angehängt haben. Dieses Objekt ordnet jeden Attributnamen einem Objekt mit einem Type und einem Value zu. Weitere Hinweise zu Attributtypen finden Sie unterAmazon-SNS-Nachrichtenattribute.

Anmerkung

MessageAttributes ist optional. Wenn die veröffentlichte Nachricht keine Nachrichtenattribute hat, erscheint dieses Name-Wert-Paar nicht in diesem JSON-Dokument.

Die folgende „HTTP POST“-Nachricht ist ein Beispiel für eine Notification-Benachrichtigung, die an einen HTTP-Endpunkt gesendet wurde.

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"
  }