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.

Analysieren von SNS Amazon-Nachrichtenformaten

Amazon SNS verwendet die folgenden Formate.

HTTP/HTTPSÜberschriften

Wenn Amazon eine Abonnementbestätigungs-, Benachrichtigungs- oder Abmeldebestätigungsnachricht an HTTP HTTPS /endpoints SNS sendet, sendet es eine POST Nachricht mit einer Reihe von SNS Amazon-spezifischen Header-Werten. Sie können Header-Werte für Aufgaben wie die Identifizierung des Nachrichtentyps verwenden, ohne den Nachrichtentext analysieren zu müssen, um den JSON Wert zu lesen. Type Standardmäßig SNS sendet Amazon alle Benachrichtigungen an HTTP /S-Endpunkte mit der Content-Type Einstellung auftext/plain; charset=UTF-8. Informationen zur Auswahl eines Content-Type, der nicht text/plain (Standard) ist, finden Sie unter headerContentType in Eine /S-Lieferrichtlinie HTTP erstellen.

Der folgende HTTP POST Header ist ein Beispiel für einen Header für eine Notification Nachricht an einen HTTP Endpunkt.

POST / HTTP/1.1
x-amz-sns-message-type: Notification
x-amz-sns-message-id: 165545c9-2a5c-472c-8df2-7ff2be2b3b1b
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:2bcfbf39-05c3-41de-beaa-fcfcc21c8f55
Content-Length: 1336
Content-Type: text/plain; charset=UTF-8
Host: myhost.example.com
Connection: Keep-Alive
User-Agent: Amazon Simple Notification Service Agent

HTTP/JSONFormat zur Bestätigung des HTTPS Abonnements

Nachdem Sie einen HTTP/HTTPS endpoint, Amazon SNS sends a subscription confirmation message to the HTTP/HTTPS Endpunkt abonniert haben. Diese Nachricht enthält einen SubscribeURL-Wert, den Sie besuchen müssen, um das Abonnement zu bestätigen (alternativ können Sie den Token-Wert mit der Aktion ConfirmSubscription verwenden).

Die Bestätigungsnachricht für das Abonnement ist eine POST Nachricht mit einem Nachrichtentext, der ein JSON Dokument mit den folgenden Name-Wert-Paaren enthält.

Die folgende HTTP POST Nachricht ist ein Beispiel für eine SubscriptionConfirmation Nachricht an einen HTTP Endpunkt.

POST / HTTP/1.1
x-amz-sns-message-type: SubscriptionConfirmation
x-amz-sns-message-id: 165545c9-2a5c-472c-8df2-7ff2be2b3b1b
x-amz-sns-topic-arn: arn:aws:sns:us-west-2:123456789012:MyTopic
Content-Length: 1336
Content-Type: text/plain; charset=UTF-8
Host: myhost.example.com
Connection: Keep-Alive
User-Agent: Amazon Simple Notification Service Agent

{
  "Type" : "SubscriptionConfirmation",
  "MessageId" : "165545c9-2a5c-472c-8df2-7ff2be2b3b1b",
  "Token" : "2336412f37...",
  "TopicArn" : "arn:aws:sns:us-west-2:123456789012:MyTopic",
  "Message" : "You have chosen to subscribe to the topic arn:aws:sns:us-west-2:123456789012:MyTopic.\nTo confirm the subscription, visit the SubscribeURL included in this message.",
  "SubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=ConfirmSubscription&TopicArn=arn:aws:sns:us-west-2:123456789012:MyTopic&Token=2336412f37...",
  "Timestamp" : "2012-04-26T20:45:04.751Z",
  "SignatureVersion" : "1",
  "Signature" : "EXAMPLEpH+DcEwjAPg8O9mY8dReBSwksfg2S7WKQcikcNKWLQjwu6A4VbeS0QHVCkhRS7fUQvi2egU3N858fiTDN6bkkOxYDVrY0Ad8L10Hs3zH81mtnPk5uvvolIC1CXGu43obcgFxeL3khZl8IKvO61GWB6jI9b5+gLPoBc1Q=",
  "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-f3ecfb7224c7233fe7bb5f59f96de52f.pem"
}

HTTP/HTTPSJSONBenachrichtigungsformat

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

Die folgende HTTP POST Nachricht ist ein Beispiel für eine Notification Nachricht an einen HTTP Endpunkt.

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

HTTP/JSONFormat zur Bestätigung der HTTPS Abmeldung

Nachdem einHTTP/HTTPS-Endpunkt von einem Thema abgemeldet wurde, SNS sendet Amazon eine Bestätigungsnachricht an den Endpunkt.

Die Bestätigungsnachricht zum Abbestellen ist eine POST Nachricht mit einem Nachrichtentext, der ein JSON Dokument mit den folgenden Name-Wert-Paaren enthält.

Die folgende HTTP POST Nachricht ist ein Beispiel für eine UnsubscribeConfirmation Nachricht an einen HTTP Endpunkt.

POST / HTTP/1.1
x-amz-sns-message-type: UnsubscribeConfirmation
x-amz-sns-message-id: 47138184-6831-46b8-8f7c-afc488602d7d
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:2bcfbf39-05c3-41de-beaa-fcfcc21c8f55
Content-Length: 1399
Content-Type: text/plain; charset=UTF-8
Host: myhost.example.com
Connection: Keep-Alive
User-Agent: Amazon Simple Notification Service Agent

{
  "Type" : "UnsubscribeConfirmation",
  "MessageId" : "47138184-6831-46b8-8f7c-afc488602d7d",
  "Token" : "2336412f37...",
  "TopicArn" : "arn:aws:sns:us-west-2:123456789012:MyTopic",
  "Message" : "You have chosen to deactivate subscription arn:aws:sns:us-west-2:123456789012:MyTopic:2bcfbf39-05c3-41de-beaa-fcfcc21c8f55.\nTo cancel this operation and restore the subscription, visit the SubscribeURL included in this message.",
  "SubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=ConfirmSubscription&TopicArn=arn:aws:sns:us-west-2:123456789012:MyTopic&Token=2336412f37fb6...",
  "Timestamp" : "2012-04-26T20:06:41.581Z",
  "SignatureVersion" : "1",
  "Signature" : "EXAMPLEHXgJm...",
  "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-f3ecfb7224c7233fe7bb5f59f96de52f.pem"
}

SetSubscriptionAttributesJSONFormat der Zustellungsrichtlinie

Wenn Sie eine Anforderung an die SetSubscriptionAttributes Aktion senden und den AttributeName Parameter auf den Wert von setzenDeliveryPolicy, muss der Wert des AttributeValue Parameters ein gültiges JSON Objekt sein. Im folgenden Beispiel wird die Zustellungsrichtlinie auf insgesamt 5 Wiederholversuche festgelegt.

http://sns.us-east-2.amazonaws.com/
?Action=SetSubscriptionAttributes
&SubscriptionArn=arn%3Aaws%3Asns%3Aus-east-2%3A123456789012%3AMy-Topic%3A80289ba6-0fd4-4079-afb4-ce8c8260f0ca
&AttributeName=DeliveryPolicy
&AttributeValue={"healthyRetryPolicy":{"numRetries":5}}
...

Verwenden Sie das folgende JSON Format für den Wert des AttributeValue Parameters.

{
    "healthyRetryPolicy" : {
        "minDelayTarget" :  int,
        "maxDelayTarget" : int,
        "numRetries" : int,
        "numMaxDelayRetries" : int,
        "backoffFunction" : "linear|arithmetic|geometric|exponential"
    },
    "throttlePolicy" : {
        "maxReceivesPerSecond" : int
    },
    "requestPolicy" : {
        "headerContentType" : "text/plain | application/json | application/xml"
    }
}

Weitere Informationen zu dieser SetSubscriptionAttribute Aktion finden Sie SetSubscriptionAttributesin der Amazon Simple Notification Service API Reference. Weitere Informationen zu den unterstützten HTTP Inhaltstyp-Headern finden Sie unter. Eine /S-Lieferrichtlinie HTTP erstellen

SetTopicAttributes Format der Lieferrichtlinie JSON

Wenn Sie eine Anforderung an die SetTopicAttributes Aktion senden und den AttributeName Parameter auf den Wert von setzenDeliveryPolicy, muss der Wert des AttributeValue Parameters ein gültiges JSON Objekt sein. Im folgenden Beispiel wird die Zustellungsrichtlinie auf insgesamt 5 Wiederholversuche festgelegt.

http://sns.us-east-2.amazonaws.com/
?Action=SetTopicAttributes
&TopicArn=arn%3Aaws%3Asns%3Aus-east-2%3A123456789012%3AMy-Topic
&AttributeName=DeliveryPolicy
&AttributeValue={"http":{"defaultHealthyRetryPolicy":{"numRetries":5}}}
...

Verwenden Sie das folgende JSON Format für den Wert des AttributeValue Parameters.

{
    "http" : {
        "defaultHealthyRetryPolicy" : {
            "minDelayTarget":  int,
            "maxDelayTarget": int,
            "numRetries": int,
            "numMaxDelayRetries": int,
            "backoffFunction": "linear|arithmetic|geometric|exponential"
        },
        "disableSubscriptionOverrides" : Boolean,
        "defaultThrottlePolicy" : {
            "maxReceivesPerSecond" : int
        },
        "defaultRequestPolicy" : {
            "headerContentType" : "text/plain | application/json | application/xml"
        }
    }
}

Weitere Informationen zu dieser SetTopicAttribute Aktion finden Sie SetTopicAttributesin der Amazon Simple Notification Service API Reference. Weitere Informationen zu den unterstützten HTTP Inhaltstyp-Headern finden Sie unter. Eine /S-Lieferrichtlinie HTTP erstellen