SNSAmazon-Nachrichtenattribute - Amazon Simple Notification Service
Nachrichtenattributelemente und ValidierungDatentypenReservierte Nachrichtenattribute für mobile Push-Benachrichtigungen

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.

SNSAmazon-Nachrichtenattribute

Amazon SNS unterstützt die Übermittlung von Nachrichtenattributen, mit denen Sie strukturierte Metadatenelemente (wie Zeitstempel, Geodaten, Signaturen und Kennungen) zur Nachricht bereitstellen können. Bei SQS Abonnements können maximal 10 Nachrichtenattribute gesendet werden, wenn Raw Message Delivery aktiviert ist. Wenn mehr als 10 Nachrichtenattribute gesendet werden sollen, muss die Übermittlung unformatierter Nachrichten deaktiviert sein. Nachrichten mit mehr als 10 Nachrichtenattributen, die auf SQS Amazon-Abonnements mit Raw Message Delivery gerichtet sind, werden als clientseitige Fehler verworfen.

Nachrichtenattribute sind optional und separat vom Nachrichtentext, werden aber mit diesem versendet. Der Receiver kann diese Informationen verwenden, um zu entscheiden, wie die Nachricht behandelt wird, ohne vorher den Nachrichtentext verarbeiten zu müssen.

Informationen zum Senden von Nachrichten mit Attributen mithilfe von AWS Management Console oder finden Sie im AWS SDK for JavaUm Nachrichten zu SNS Amazon-Themen zu veröffentlichen, verwenden Sie den AWS Management Console Tutorial.

Anmerkung

Nachrichtenattribute werden nur gesendet, wenn die Nachrichtenstruktur Zeichenfolge ist, nichtJSON.

Sie können die Nachrichtenattribute auch zur Strukturierung der Push-Benachrichtigung für mobile Endpunkte verwenden. In diesem Fall werden die Nachrichtenattribute nur verwendet, um Ihnen bei der Gliederung der Push-Benachrichtigung zu helfen. Die Attribute werden nicht an den Endpunkt übermittelt, wie dies beim Senden von Nachrichten mit Nachrichtenattributen an SQS Amazon-Endpunkte der Fall ist.

Sie können Nachrichtenattribute auch verwenden, um Ihre Nachrichten filterbar für Abonnement-Filterrichtlinien zu machen. Sie können Richtlinien auf Themen-Abonnements anwenden. Wenn eine Filterrichtlinie angewendet wird, bei der der Geltungsbereich der Filterrichtlinie auf MessageAttributes (Standard) festgelegt ist, erhält ein Abonnement nur diejenigen Nachrichten mit Attributen, die die Richtlinie akzeptiert. Weitere Informationen finden Sie unter SNSAmazon-Nachrichtenfilterung.

Anmerkung

Wenn Nachrichtenattribute zum Filtern verwendet werden, muss der Wert eine gültige JSON Zeichenfolge sein. Dadurch wird sichergestellt, dass die Nachricht an ein Abonnement mit aktivierter Filterung von Nachrichtenattributen zugestellt wird.

Nachrichtenattributelemente und Validierung

Jedes Nachrichtenattribut besteht aus den folgenden Elementen:

  • Name – Der Name des Nachrichtenattributs kann folgende Zeichen enthalten: A-Z, a-z, 0-9, Unterstrich (_), Bindestrich (-) und Punkt (.). Der Name darf nicht mit einem Punkt beginnen oder enden und darf nicht mehrere aufeinanderfolgende Punkte enthalten. Es wird zwischen Groß- und Kleinschreibung unterschieden. Der Name muss innerhalb der Attributnamen für die Nachricht eindeutig sein. Er kann eine Länge von bis zu 256 Zeichen umfassen. Er darf nicht mit AWS. oder Amazon. (oder eine Variante bei der Groß-/Kleinschreibung) beginnen, da diese Präfixe für die Verwendung durch Amazon Web Services reserviert sind.

  • Typ – Die unterstützten Attributdatentypen für Nachrichten sind String, String.Array, Number und Binary. Der Datentyp unterliegt denselben Beschränkungen bezüglich des Inhalts wie der Nachrichtentext. Weitere Informationen finden Sie im Abschnitt Datentypen für Nachrichtenattribute und Validierung.

  • Wert – Der benutzerdefinierte Wert des Nachrichtenattributs. Für den Datentyp Zeichenfolge unterliegt das Wertattribut denselben Beschränkungen bezüglich des Inhalts wie der Nachrichtentext. Weitere Informationen finden Sie unter der Aktion „Veröffentlichen“ in der Amazon Simple Notification Service API Reference.

Name, Typ und Wert dürfen nicht leer oder null sein. Dasselbe gilt für den Nachrichtentext. Alle Teile des Nachrichtenattributs einschließlich Name, Typ und Wert zählen zur Größenbeschränkung der Nachricht, die bei 256 KB liegt.

Datentypen für Nachrichtenattribute und Validierung

Datentypen von Nachrichtenattributen geben an, wie die Nachrichtenattributwerte von Amazon behandelt werdenSNS. Wenn es sich bei dem Typ beispielsweise um eine Zahl handelt, SNS überprüft Amazon, ob es sich um eine Zahl handelt.

Amazon SNS unterstützt die folgenden logischen Datentypen für alle Endgeräte, sofern nicht anders angegeben:

  • Zeichenfolge — Zeichenketten sind Unicode-Zeichen mit einer Binärcodierung von UTF -8. Eine Liste der Codewerte finden Sie unter http://en.wikipedia. org/wiki/ASCII# ASCII _printable_characters.

    Anmerkung

    Ersatzwerte werden in den Nachrichtenattributen nicht unterstützt. Wenn Sie beispielsweise einen Ersatzwert zur Darstellung eines Emojis verwenden, erhalten Sie den folgenden Fehler: Invalid attribute value was passed in for message attribute.

  • String.Array – Ein Array, formatiert als Zeichenfolge, das mehrere Werte enthalten kann. Die Werte können Zeichenfolgen, Zahlen oder die Schlüsselwörter true, false und null sein. Für ein String.Array vom Typ „number“ oder „boolean“ sind keine Preise erforderlich. Mehrere String.Array-Werte werden durch Komma getrennt.

    Dieser Datentyp wird für Abonnements nicht unterstützt. AWS Lambda Wenn Sie diesen Datentyp für Lambda-Endpunkte angeben, wird er als String Datentyp in der JSON Payload übergeben, die Amazon an Lambda SNS liefert.

  • Zahl – Zahlen sind positive oder negative Ganzzahlen oder Gleitkommazahlen. Der Umfang und die Genauigkeit von Zahlen reichen aus, um die meisten möglichen Werte zu umfassen, die von den Zahlentypen Integer, Float und Double normalerweise unterstützt werden. Eine Zahl kann einen Wert von -109 bis 109 haben, mit 5 Stellen Genauigkeit nach dem Komma. Nullen am Anfang und am Ende werden abgeschnitten.

    Dieser Datentyp wird für Abonnements nicht unterstützt. AWS Lambda Wenn Sie diesen Datentyp für Lambda-Endpunkte angeben, wird er als String Datentyp in der JSON Payload übergeben, die Amazon an Lambda SNS liefert.

  • Binär – Mit den Binärtypattributen können Sie alle binären Daten speichern, z. B. komprimierte oder verschlüsselte Daten und Bilder.

Reservierte Nachrichtenattribute für mobile Push-Benachrichtigungen

Die folgende Tabelle enthält die reservierten Nachrichtenattribute für mobile Push-Benachrichtigungsservices, mit denen Sie Ihre Push-Benachrichtigung strukturieren können:

Push-Benachrichtigungsservice Reserviertes Nachrichtenattribut
ADM AWS.SNS.MOBILE.ADM.TTL
APNs1 AWS.SNS.MOBILE.APNS_MDM.TTL
AWS.SNS.MOBILE.APNS_MDM_SANDBOX.TTL
AWS.SNS.MOBILE.APNS_PASSBOOK.TTL
AWS.SNS.MOBILE.APNS_PASSBOOK_SANDBOX.TTL
AWS.SNS.MOBILE.APNS_SANDBOX.TTL
AWS.SNS.MOBILE.APNS_VOIP.TTL
AWS.SNS.MOBILE.APNS_VOIP_SANDBOX.TTL
AWS.SNS.MOBILE.APNS.COLLAPSE_ID
AWS.SNS.MOBILE.APNS.PRIORITY
AWS.SNS.MOBILE.APNS.PUSH_TYPE
AWS.SNS.MOBILE.APNS.TOPIC
AWS.SNS.MOBILE.APNS.TTL

Baidu

 AWS.SNS.MOBILE.BAIDU.DeployStatus
AWS.SNS.MOBILE.BAIDU.MessageKey
AWS.SNS.MOBILE.BAIDU.MessageType
AWS.SNS.MOBILE.BAIDU.TTL
FCM AWS.SNS.MOBILE.FCM.TTL
AWS.SNS.MOBILE.GCM.TTL
macOS AWS.SNS.MOBILE.MACOS_SANDBOX.TTL
AWS.SNS.MOBILE.MACOS.TTL

MPNS

 AWS.SNS.MOBILE.MPNS.NotificationClass
AWS.SNS.MOBILE.MPNS.TTL

AWS.SNS.MOBILE.MPNS.Type
WNS AWS.SNS.MOBILE.WNS.CachePolicy
AWS.SNS.MOBILE.WNS.Group
AWS.SNS.MOBILE.WNS.Match
AWS.SNS.MOBILE.WNS.SuppressPopup
AWS.SNS.MOBILE.WNS.Tag
AWS.SNS.MOBILE.WNS.TTL
AWS.SNS.MOBILE.WNS.Type

1 Apple lehnt SNS Amazon-Benachrichtigungen ab, wenn die Nachrichtenattribute nicht ihren Anforderungen entsprechen. Weitere Informationen finden Sie unter Senden von Benachrichtigungsanfragen an APNs auf der Apple-Entwickler-Website.