Freigeben über


Warteschlangenspeicher-REST-API

Azure Queue Storage speichert Nachrichten, die von jedem Client gelesen werden können, der Zugriff auf das Speicherkonto hat.

Eine Warteschlange kann eine unbegrenzte Anzahl von Nachrichten enthalten. Jede Nachricht kann für Version 2011-08-18 oder höher bis zu 64 KB groß sein. In früheren Versionen beträgt die maximale Größe einer Nachricht 8 KB. Nachrichten werden im Allgemeinen am Ende der Warteschlange hinzugefügt und am Anfang der Warteschlange abgerufen, jedoch ist FIFO (First In, First Out)-Verhalten nicht garantiert.

Wenn Sie Nachrichten mit einer Größe von mehr als 64 KB speichern müssen, können Sie Nachrichtendaten als Blob oder in einer Tabelle speichern. Anschließend können Sie einen Verweis auf die Daten als Nachricht in einer Warteschlange speichern.

Die REST-API für Warteschlangenspeicher umfasst die folgenden Vorgänge:

Vorgang BESCHREIBUNG
Festlegen von Warteschlangendiensteigenschaften Legt die Eigenschaften von Warteschlangenspeicher fest.
Abrufen von Warteschlangendiensteigenschaften Ruft die Eigenschaften von Warteschlangenspeicher ab.
Warteschlangen auflisten Listet alle Warteschlangen unter einem Konto auf.
Preflight-Anforderung für den Warteschlangendienst Fragt die CORS-Regeln (Cross-Origin Resource Sharing) für Warteschlangenspeicher ab, bevor die Anforderung gesendet wird.
Statistiken zum Warteschlangendienst abrufen Ruft Statistiken im Zusammenhang mit der Replikation für Warteschlangenspeicher ab. Dieser Vorgang ist nur auf dem sekundären Standortendpunkt verfügbar, wenn die georedundante Replikation mit Lesezugriff für das Speicherkonto aktiviert ist.
Warteschlange erstellen Erstellt eine neue Warteschlange unter einem Konto.
Löschen einer Warteschlange Löscht eine Warteschlange.
Get Queue Metadata Gibt Warteschlangeneigenschaften, einschließlich benutzerdefinierter Metadaten, zurück.
Festlegen von Warteschlangenmetadaten Legt benutzerdefinierte Metadaten für die Warteschlange fest.
Abrufen einer Warteschlangen-ACL Gibt Details über alle gespeicherten Zugriffsrichtlinien zurück, die für die Warteschlange angegeben sind.
Set Queue ACL Legt gespeicherte Zugriffsrichtlinien für die Warteschlange fest, die mit Freigegebenen Zugriffssignaturen verwendet werden kann.
Put Message Fügt der Warteschlange eine Nachricht hinzu und legt optional ein Sichtbarkeitstimeout für die Nachricht fest.
Get Messages Ruft eine Nachricht aus der Warteschlange ab und macht sie für andere Consumer nicht sichtbar.
Peek Messages Ruft eine Nachricht vom Anfang der Warteschlange ab, ohne die Sichtbarkeit der Nachricht zu ändern.
Nachricht löschen Löscht eine angegebene Nachricht aus der Warteschlange.
Nachrichten löschen Löscht alle Nachrichten aus der Warteschlange.
Nachricht aktualisieren Updates das Sichtbarkeitstimeout einer Nachricht und/oder des Nachrichteninhalts.

In diesem Abschnitt

Queue Storage-Konzepte
Vorgänge in Warteschlangen
Vorgänge für Nachrichten

Weitere Informationen

Referenz zur REST-API von Azure Storage