Dela via


Hantera kötjänstresurser

Queue-tjänsten exponerar följande resurser via REST-API:et:

  • Konto. Lagringskontot är en unikt identifierad entitet i lagringssystemet. Kontot är det överordnade namnområdet för kötjänsten. Alla köer är associerade med ett konto.

  • Kö. En kö lagrar meddelanden som kan hämtas av ett klientprogram eller en tjänst.

  • Meddelanden. Meddelanden är UTF-8-kodad text som kan vara värdet för ett XML-element. Ett meddelande kan vara 64 KiB i storlek.

Resurs-URI-syntax

Varje resurs har en motsvarande bas-URI, som refererar till själva resursen.

För lagringskontot innehåller bas-URI:n för köåtgärder endast namnet på kontot:

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

För en kö innehåller bas-URI:n namnet på kontot och namnet på kön:

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

För meddelanden i en kö innehåller bas-URI:n namnet på kontot, namnet på kön och uppsättningen meddelanden i kön:

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

Ett enskilt meddelande kan uppdateras eller tas bort med hjälp av meddelande-ID:t. Observera att den här syntaxen endast är tillgänglig för åtgärden Uppdatera meddelande och Ta bort meddelande och kräver en popreceipt parameter för verifiering:

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

Varje resurs kan också ha komponenter som uttrycks som en del av frågesträngen på bas-URI:n. Syntaxen för frågesträngen är ?comp=<component_name>. För närvarande är följande resurskomponenter tillgängliga för köresurser som parametrar på URI:n.

Komponent Resurser som stöds Description
list Konto Räknar upp entiteterna under den här resursen. På kontot returnerar listan över köer.
metadata Anger eller returnerar köegenskaper, inklusive användardefinierade metadata.

Observera att alla värden för frågeparametrar måste vara URL-kodade innan de skickas till Azure Storage-tjänsterna.

HTTP-åtgärder som stöds

Varje resurs stöder åtgärder baserat på HTTP-verben GET, PUT, HEAD och DELETE. Verbet, syntaxen och HTTP-versionerna som stöds för varje åtgärd visas på referenssidan för varje åtgärd. En fullständig lista över åtgärdsreferenssidor finns i Rest-API:et för kötjänsten.

Se även

Namnge köer och metadata
Åtgärder i köer
Åtgärder för meddelanden
Kö-tjänstens REST-API