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.
Große Nachrichten mit Amazon SNS veröffentlichen
Amazon SNS unterstützt Nachrichtennutzlasten bis zu 1 MiB (1.048.576 Byte), wenn Sie das Themenattribut konfigurieren. MaximumMessageSize Standardmäßig akzeptieren Themen Nachrichten mit einer Größe von bis zu 256 KiB. Themen mit einem MaximumMessageSize Wert über 256 KiB unterstützen Amazon Data Firehose, Amazon SQS und AWS Lambda Abonnements mit insgesamt bis zu 100 Abonnements pro Thema.
So funktioniert das Veröffentlichen großer Nachrichten
Sie können das MaximumMessageSize Topic-Attribut auf einen beliebigen Ganzzahlwert zwischen 1.024 und 1.048.576 Byte setzen. Standardmäßig haben alle vorhandenen und neu erstellten Themen eine Größe MaximumMessageSize von 262.144 Byte (256 KiB).
Wenn Sie eine Nachricht veröffentlichen, überprüft Amazon SNS die kombinierte Größe des Nachrichtentexts und der Nachrichtenattribute anhand der für das Thema konfigurierten Größe. MaximumMessageSize Wenn die kombinierte Größe den Grenzwert überschreitet, gibt Amazon SNS bei der Veröffentlichung einen InvalidParameter Fehler zurück.
Unterstützte Konfiguration
Wenn Sie mehr als MaximumMessageSize 256 KiB einstellen, unterstützt Amazon SNS die folgende Konfiguration.
Abonnementbeschränkungen
Das Thema unterstützt insgesamt bis zu 100 Abonnements. Wenn Sie versuchen, zusätzliche Abonnements zu erstellen, gibt Amazon SNS einen InvalidParameter Fehler zurück.
Unterstützte Endpunkttypen
Themen mit MaximumMessageSize mehr als 256 KiB unterstützen die folgenden Endpunkttypen:
-
Amazon Data Firehose
-
Amazon SQS
-
AWS Lambda
Themen mit einer MaximumMessageSize Größe von 256 KiB oder weniger unterstützen HTTP/HTTPS auch SMS-, E-Mail-, E-Mail-JSON- und mobile Push-Endpunkte (Anwendung).
Einstellung MaximumMessageSize zu bestehenden Themen
Sie können die Anzahl der Themen MaximumMessageSize jederzeit erhöhen oder verringern. Nachdem Sie den Wert geändert haben, überprüft Amazon SNS neue Veröffentlichungsanfragen anhand des aktualisierten Limits.
Um einen MaximumMessageSize Wert über 256 KiB festzulegen, muss das Thema insgesamt 100 oder weniger Abonnements haben, die alle unterstützten Endpunkttypen sein müssen (Amazon Data Firehose, Amazon SQS oder). AWS Lambda Wenn das Thema nicht unterstützte Endpunkttypen oder mehr als 100 Abonnements enthält, gibt Amazon SNS einen Fehler zurück. InvalidParameter
Konfiguration Ihres Themas für umfangreiche Nachrichten
Verwendung der AWS Management Console
Um Ihr Thema so zu konfigurieren, dass größere Nachrichten veröffentlicht werden
-
Öffnen Sie die Amazon-SNS-Konsole unter https://console.aws.amazon.com/sns/home
. -
Wählen Sie im linken Navigationsbereich Topics (Themen).
-
Wählen Sie Ihr Thema aus und wählen Sie Bearbeiten.
-
Lege unter Maximale Nachrichtengröße das gewünschte Limit fest (bis zu 1.024 KiB).
-
Wählen Sie Änderungen speichern aus.
Verwendung der AWS CLI
Legen Sie MaximumMessageSize Folgendes fest, wenn Sie ein neues Thema erstellen:
aws sns create-topic \ --name my-large-message-topic \ --attributes MaximumMessageSize=1048576
my-large-message-topicErsetzen Sie es durch Ihren Themennamen und 1048576 durch Ihre gewünschte maximale Nachrichtengröße in Byte.
MaximumMessageSizeAuf ein vorhandenes Thema setzen:
aws sns set-topic-attributes \ --topic-arn arn:aws:sns:us-east-1:123456789012:my-topic \ --attribute-name MaximumMessageSize \ --attribute-value 1048576
arn:aws:sns:us-east-1:123456789012:my-topicErsetzen Sie es durch den ARN Ihres Themas und 1048576 durch Ihre gewünschte maximale Nachrichtengröße in Byte.
Überprüfe, ob dein Thema aktuell istMaximumMessageSize. Wenn das Attribut nicht explizit festgelegt wurde, erscheint es nicht in der Antwort, und das Thema verwendet den Standardwert von 262.144 Byte (256 KiB).
aws sns get-topic-attributes \ --topic-arn arn:aws:sns:us-east-1:123456789012:my-topic
Amazon SNS-API-Referenz für große Nachrichten
Für die Unterstützung großer Nachrichten werden bestehende Amazon SNS-APIs verwendet. Sie benötigen keine neuen API-Operationen.
| API | Änderungen |
|---|---|
CreateTopic |
Akzeptiert MaximumMessageSize im Attributes Parameter. Gültiger Bereich: 1.024—1.048.576 Byte. |
SetTopicAttributes |
MaximumMessageSizeAkzeptiert als Attributnamen. |
GetTopicAttributes |
Gibt zurückMaximumMessageSize, ob das Attribut explizit gesetzt wurde. Wenn kein Wert zurückgegeben wird, verwendet das Thema den Standardwert von 262.144 Byte (256 KiB). |
Publish |
Überprüft die kombinierte Größe des Nachrichtentexts und der Nachrichtenattribute anhand der Größe des Themas. MaximumMessageSize |
PublishBatch |
Überprüft die Gesamtgröße aller Nachrichten im Stapel (Text und Attribute jeder Nachricht) anhand der Größe des Themas. MaximumMessageSize |
Endpunkt-Kompatibilität
In der folgenden Liste wird beschrieben, wie Amazon SNS Ihre großen Nachrichten an jeden unterstützten Endpunkttyp übermittelt.
-
Amazon Data Firehose — Amazon Data Firehose lädt Streaming-Daten in Datenspeicher und Analysedienste. Es unterstützt Datensätze mit bis zu 1.000 KiB (1.024.000 Byte). Die zugestellte Nachricht muss unter diesem Limit bleiben. Das Limit beinhaltet Amazon SNS-Übermittlungsmetadaten wie die Nachrichten-ID und den Zeitstempel. Nachrichten, die das Limit überschreiten, können nicht zugestellt werden. Ein Thema
MaximumMessageSizekann auf bis zu 1.024 KiB (1.048.576 Byte) eingestellt werden. Aus diesem Grund empfehlen wir, für Themen mit Firehose-Abonnements einen niedrigeren WertMaximumMessageSizefestzulegen. Die aktuelle Größenbeschränkung für Datensätze finden Sie unter Amazon Data Firehose-Kontingente. -
Amazon SQS — Amazon SNS kann eine Nachricht bis zur maximal unterstützten Nachrichtengröße von Amazon SQS an eine abonnierte Amazon SQS-Warteschlange übermitteln. Die eigene Warteschlange gilt
MaximumMessageSizenicht für Nachrichten von Amazon SNS. Das Amazon SNS-ThemaMaximumMessageSizeist die effektive Größenbeschränkung für diese Nachrichten. -
AWS Lambda— Amazon SNS ruft AWS Lambda Funktionen asynchron auf. AWS Lambda unterstützt Nutzlasten für asynchrone Aufrufe von bis zu 1 MiB. Für Abonnements ist keine zusätzliche Konfiguration erforderlich. AWS Lambda
Bewährte Methoden
Konfigurieren Sie Warteschlangen mit unzustellbaren Briefen
Wir empfehlen, für alle Abonnements eine Warteschlange für unzustellbare Nachrichten (DLQ) zu konfigurieren, um eine fehlgeschlagene Nachrichtenzustellung zu behandeln. Ein DLQ erfasst Nachrichten, die Amazon SNS nicht erfolgreich an den abonnierten Endpunkt übermitteln kann, sodass Sie sie überprüfen und erneut verarbeiten können. Weitere Informationen finden Sie unter Amazon SNS-Warteschlangen mit unzustellbaren Briefen.
Überwachung mit Messwerten und Alarmen CloudWatch
Verwenden Sie CloudWatch Kennzahlen, um die Nachrichtenzustellung zu überwachen und Alarme für fehlgeschlagene Zustellungen einzurichten. Die NumberOfNotificationsFailed Metrik verfolgt Nachrichten, die Amazon SNS nicht an abonnierte Endpunkte übermitteln kann. Erstellen Sie einen CloudWatch Alarm für diese Metrik, um Benachrichtigungen zu erhalten, wenn es zu Zustellungsfehlern kommt. Weitere Informationen finden Sie unter Überwachung von Amazon SNS-Themen mit CloudWatch.
Veröffentlichen von Nachrichten, die größer als 1 MiB sind, mit Amazon S3
Um Nachrichten mit einer Größe von mehr als 1 MiB zu veröffentlichen, verwenden Sie die Amazon SNS Extended Client Library für Java MaximumMessageSize vor der Wahl dieser Methode finden Sie unterKonfiguration Ihres Themas für umfangreiche Nachrichten.