Adresování prostředků frontové služby

  • Článek

Služba Queue zpřístupňuje následující prostředky prostřednictvím rozhraní REST API:

  • Obchodní vztah. Účet úložiště je jednoznačně identifikovaná entita v rámci systému úložiště. Účet je nadřazený obor názvů pro službu Queue. Všechny fronty jsou přidružené k účtu.

  • Fronty. Fronta ukládá zprávy, které mohou být načteny klientskou aplikací nebo službou.

  • Zprávy. Zprávy jsou text s kódováním UTF-8, který může být hodnotou elementu XML. Zpráva může mít velikost 64 KiB.

Syntaxe identifikátoru URI prostředku

Každý prostředek má odpovídající základní identifikátor URI, který odkazuje na samotný prostředek.

Základní identifikátor URI pro operace fronty pro účet úložiště obsahuje pouze název účtu:

https://myaccount.queue.core.windows.net

U fronty obsahuje základní identifikátor URI název účtu a název fronty:

https://myaccount.queue.core.windows.net/myqueue

U zpráv ve frontě obsahuje základní identifikátor URI název účtu, název fronty a sadu zpráv v této frontě:

https://myaccount.queue.core.windows.net/myqueue/messages

Jednotlivá zpráva může být aktualizována nebo odstraněna odkazem na ID zprávy. Všimněte si, že tato syntaxe je k dispozici pouze pro operace Aktualizovat zprávu a Odstranit zprávu a vyžaduje popreceipt parametr pro ověření:

https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value

Každý prostředek může mít také komponenty, které jsou vyjádřeny jako součást řetězce dotazu na základní identifikátor URI. Syntaxe pro řetězec dotazu je ?comp=<component_name>. V současné době jsou pro prostředky fronty dostupné následující komponenty prostředků jako parametry identifikátoru URI.

Součást Podporované prostředky Description
list Účet Vytvoří výčet entit pod tímto prostředkem. Na účtu vrátí seznam front.
metadata Fronta Nastaví nebo vrátí vlastnosti fronty, včetně metadat definovaných uživatelem.

Mějte na paměti, že všechny hodnoty parametrů dotazu musí být před odesláním do služeb Azure Storage zakódované v adrese URL.

Podporované operace HTTP

Každý prostředek podporuje operace založené na příkazech HTTP GET, PUT, HEAD a DELETE. Příkaz, syntaxe a podporované verze HTTP pro každou operaci se zobrazí na stránce s referenčními informacemi pro každou operaci. Úplný seznam stránek s referenčními informacemi o operacích najdete v tématu Rozhraní REST API služby front.

Viz také

Pojmenování front a metadat
Operace s frontami
Operace se zprávami
Rozhraní REST API služby Queue Service