Üzenetsor-szolgáltatás erőforrásainak kezelése
A Queue szolgáltatás a következő erőforrásokat teszi elérhetővé a REST API-val:
fiók. A tárfiók egy egyedileg azonosított entitás a tárolórendszeren belül. A fiók a Queue szolgáltatás szülőnévtere. Minden üzenetsor egy fiókhoz van társítva.
Várólista. Az üzenetsorok olyan üzeneteket tárolnak, amelyeket egy ügyfélalkalmazás vagy szolgáltatás lekérhet.
Üzenetek. Az üzenetek olyan UTF-8 kódolású szövegek, amelyek egy XML-elem értéke lehetnek. Az üzenetek mérete 64 KiB lehet.
Erőforrás URI-szintaxisa
Minden erőforrás rendelkezik egy megfelelő alap URI-vel, amely magára az erőforrásra hivatkozik.
A tárfiók esetében az üzenetsor-műveletek alap URI-ja csak a fiók nevét tartalmazza:
https://myaccount.queue.core.windows.net
Egy üzenetsor esetében az alap URI tartalmazza a fiók nevét és az üzenetsor nevét:
https://myaccount.queue.core.windows.net/myqueue
Az üzenetsorban lévő üzenetek esetében az alap URI tartalmazza a fiók nevét, az üzenetsor nevét és az üzenetsorban lévő üzenetek készletét:
https://myaccount.queue.core.windows.net/myqueue/messages
Az egyes üzenetek az üzenetazonosítóra hivatkozva frissíthetők vagy törölhetők. Vegye figyelembe, hogy ez a szintaxis csak az Üzenet frissítése és az Üzenet törlése művelet számára érhető el, és egy paramétert igényel popreceipt
az ellenőrzéshez:
https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value
Minden erőforrás rendelkezhet összetevőkkel is, amelyek az alap URI-n található lekérdezési sztring részeként vannak kifejezve. A lekérdezési sztring szintaxisa a következő ?comp=<component_name>
: . Jelenleg az alábbi erőforrás-összetevők érhetők el a várólista-erőforrásokhoz, az URI paramétereiként.
Összetevő | Támogatott erőforrások | Description |
---|---|---|
list |
Fiók | Enumerálja az erőforrás alatt található entitásokat. A fiókban visszaadja az üzenetsorok listáját. |
metadata |
Üzenetsor | Beállítja vagy visszaadja az üzenetsor tulajdonságait, beleértve a felhasználó által definiált metaadatokat is. |
Vegye figyelembe, hogy a lekérdezési paraméterek minden értékének URL-kódolással kell rendelkeznie, mielőtt elküldené őket az Azure Storage-szolgáltatásoknak.
Támogatott HTTP-műveletek
Minden erőforrás támogatja a GET, PUT, HEAD és DELETE HTTP-parancsokon alapuló műveleteket. Az egyes műveletekhez tartozó parancsok, szintaxisok és támogatott HTTP-verziók az egyes műveletek referenciaoldalán jelennek meg. A művelet referenciaoldalainak teljes listáját lásd: Queue Service REST API.
Lásd még
Üzenetsorok és metaadatok elnevezése
Várólistákon végzett műveletek
Műveletek üzeneteken
A Queue szolgáltatás REST API-ja