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.
Amazon-SNS-Nachrichtenattribute
Amazon SNS unterstützt die Übermittlung von Nachrichtenattributen, die Ihnen die Bereitstellung strukturierter Metadatenelemente (Zeitstempel, Geodaten, Signaturen, IDs usw.) zur Nachricht ermöglichen. Für SQS-Abonnements können maximal 10 Nachrichtenattribute gesendet werden, wenn die Übermittlung unformatierter Nachrichten aktiviert ist. Wenn mehr als 10 Nachrichtenattribute gesendet werden sollen, muss die Übermittlung unformatierter Nachrichten deaktiviert sein. Nachrichten werden mit mehr als 10 Nachrichtenattributen, die an Amazon-SQS-Abonnements mit aktiviertem Raw Message Delivery gerichtet sind, 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.
Weitere Informationen über das Senden von Nachrichten mit Attributen mithilfe der AWS Management Console oder AWS SDK for Java finden Sie im Tutorial Um Nachrichten in Amazon-SNS-Themen mithilfe von AWS Management Console zu veröffentlichen.
Anmerkung
Nachrichtenattribute werden nur bei der Nachrichtenstruktur "Zeichenfolge" und nicht bei "JSON" gesendet werden.
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 beim Senden von Nachrichten mit Nachrichtenattributen an Amazon SQS-Endpunkte.
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 Amazon SNS Nachrichtenfilterung.
Anmerkung
Wenn Nachrichtenattribute für die Filterung 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.
oderAmazon.
(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
undBinary
. Der Datentyp unterliegt denselben Beschränkungen bezüglich des Inhalts wie der Nachrichtentext. Die Groß- und Kleinschreibung wird berücksichtigt und er kann eine Gesamtlänge von bis zu 256 Bytes haben. 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-Referenz.
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
Über den Datentyp des Nachrichtenattributs wird festgelegt, wie die Nachrichtenattributwerte von Amazon SNS verarbeitet werden. Wenn Sie beispielsweise den Datentyp Zahl wählen, wertet Amazon SNS den Wert als Zahl aus.
Amazon SNS unterstützt die folgenden logischen Datentypen für alle Endpunkte, außer wie erwähnt:
-
Zeichenfolge – Die Zeichenfolgen sind Unicode mit binärer UTF-8-Kodierung. Eine Liste von Codewerten 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
undnull
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 nicht unterstützt für AWS Lambda-Abonnements. Wenn Sie diesen Datentypen für Lambda-Endpunkte festlegen, wird er als der
String
-Datentyp in der JSON-Nutzlast angesehen, den Amazon SNS an Lambda 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 nicht unterstützt für AWS Lambda-Abonnements. Wenn Sie diesen Datentypen für Lambda-Endpunkte festlegen, wird er als der
String
-Datentyp in der JSON-Nutzlast angesehen, den Amazon SNS an Lambda 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 |
|
|
|
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 Amazon-SNS-Benachrichtigungen ab, wenn die Nachrichtenattribute nicht ihren Anforderungen entsprechen. Weitere Informationen finden Sie unter Senden von Benachrichtigungsanfragen an APNs