Wachtrijserviceresources adresseren

  • Artikel

De Queue-service maakt de volgende resources beschikbaar via de REST API:

  • Account. Het opslagaccount is een uniek geïdentificeerde entiteit binnen het opslagsysteem. Het account is de bovenliggende naamruimte voor de Queue-service. Alle wachtrijen zijn gekoppeld aan een account.

  • Wachtrij. In een wachtrij worden berichten opgeslagen die kunnen worden opgehaald door een clienttoepassing of -service.

  • Berichten. Berichten zijn UTF-8 gecodeerde tekst die de waarde van een XML-element kan zijn. Een bericht kan 64 KiB groot zijn.

Syntaxis van resource-URI

Elke resource heeft een bijbehorende basis-URI, die verwijst naar de resource zelf.

Voor het opslagaccount bevat de basis-URI voor wachtrijbewerkingen alleen de naam van het account:

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

Voor een wachtrij bevat de basis-URI de naam van het account en de naam van de wachtrij:

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

Voor berichten in een wachtrij bevat de basis-URI de naam van het account, de naam van de wachtrij en de set berichten in die wachtrij:

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

Een afzonderlijk bericht kan worden bijgewerkt of verwijderd door te verwijzen naar de bericht-id. Houd er rekening mee dat deze syntaxis alleen beschikbaar is voor de bewerking Bericht bijwerken en Bericht verwijderen en een popreceipt parameter vereist voor verificatie:

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

Elke resource kan ook onderdelen hebben, die worden uitgedrukt als onderdeel van de queryreeks op de basis-URI. De syntaxis voor de querytekenreeks is ?comp=<component_name>. Momenteel zijn de volgende resourceonderdelen beschikbaar voor wachtrijresources, als parameters op de URI.

Onderdeel Ondersteunde resources Beschrijving
list Account Inventariseert de entiteiten onder deze resource. Retourneert de lijst met wachtrijen in het account.
metadata Wachtrij Hiermee worden wachtrijeigenschappen ingesteld of geretourneerd, inclusief door de gebruiker gedefinieerde metagegevens.

Houd er rekening mee dat alle waarden voor queryparameters URL-codering moeten hebben voordat ze naar de Azure-opslagservices worden verzonden.

Ondersteunde HTTP-bewerkingen

Elke resource ondersteunt bewerkingen op basis van de HTTP-woorden GET, PUT, HEAD en DELETE. De werkwoorden, syntaxis en ondersteunde HTTP-versie(s) voor elke bewerking worden weergegeven op de verwijzingspagina voor elke bewerking. Zie Queue Service REST API voor een volledige lijst met bewerkingsreferentiepagina's.

Zie ook

Naamgeving van wachtrijen en metagegevens
Bewerkingen in wachtrijen
Bewerkingen voor berichten
Wachtrijservice REST API