View a markdown version of this page

Große Nachrichten mit Amazon SNS veröffentlichen - 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.

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
  1. Öffnen Sie die Amazon-SNS-Konsole unter https://console.aws.amazon.com/sns/home.

  2. Wählen Sie im linken Navigationsbereich Topics (Themen).

  3. Wählen Sie Ihr Thema aus und wählen Sie Bearbeiten.

  4. Lege unter Maximale Nachrichtengröße das gewünschte Limit fest (bis zu 1.024 KiB).

  5. 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 MaximumMessageSize kann 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 Wert MaximumMessageSize festzulegen. 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 MaximumMessageSize nicht für Nachrichten von Amazon SNS. Das Amazon SNS-Thema MaximumMessageSize ist 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 oder die Amazon SNS Extended Client Library für Python, um Payloads in Amazon S3 zu speichern und eine Referenz über Amazon SNS zu veröffentlichen. Diese Bibliotheken unterstützen Nachrichten bis zu 2 GB und sind sowohl mit Standard- als auch mit FIFO-Themen kompatibel. Anweisungen zur Erhöhung MaximumMessageSize vor der Wahl dieser Methode finden Sie unterKonfiguration Ihres Themas für umfangreiche Nachrichten.