Metagegevens van wachtrij ophalen

De Get Queue Metadata bewerking haalt door de gebruiker gedefinieerde metagegevens en wachtrijeigenschappen op voor de opgegeven wachtrij. Metagegevens zijn gekoppeld aan de wachtrij als naam-waardeparen.

Aanvraag

De Get Queue Metadata aanvraag kan als volgt worden samengesteld. U wordt aangeraden HTTPS te gebruiken.

Methode	Aanvraag-URI	HTTP-versie
GET/HEAD	https://myaccount.queue.core.windows.net/myqueue?comp=metadata	HTTP/1.1

Aanvraag voor geëmuleerde opslagservice

Wanneer u een aanvraag voor de geëmuleerde opslagservice indient, geeft u de hostnaam van de emulator en de Azure Queue Storage-poort op als 127.0.0.1:10001, gevolgd door de naam van het geëmuleerde opslagaccount:

Methode	Aanvraag-URI	HTTP-versie
GET/HEAD	http://127.0.0.1:10001/devstoreaccount1/myqueue?comp=metadata	HTTP/1.1

Zie Use the Azurite emulator for local Azure Storage development (De Azurite-emulator gebruiken voor lokale Azure Storage-ontwikkeling) voor meer informatie.

URI-parameters

De volgende aanvullende parameters kunnen worden opgegeven voor de aanvraag-URI:

Parameter	Beschrijving
timeout	Optioneel. De timeout parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor Azure Queue Storage-bewerkingen voor meer informatie.

Aanvraagheaders

De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:

Aanvraagheader	Beschrijving
Authorization	Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
Date of x-ms-date	Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen autoriseren voor Azure Storage voor meer informatie.
x-ms-version	Optioneel. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie.
x-ms-client-request-id	Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie Azure Queue Storage bewaken voor meer informatie.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK).

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader	Beschrijving
x-ms-approximate-messages-count:int-value	Het geschatte aantal berichten in de wachtrij. Dit aantal is niet lager dan het werkelijke aantal berichten in de wachtrij, maar kan hoger zijn.
x-ms-meta-name:string-value	Een door de gebruiker gedefinieerd naam/waarde-paar.
x-ms-request-id	Identificeert op unieke wijze de aanvraag die is gedaan en kan worden gebruikt om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie.
x-ms-version	Geeft de Azure Queue Storage-versie aan die is gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen die zijn gedaan op basis van versie 2009-09-19 of hoger.
Date	Een UTC-datum/tijd-waarde die wordt gegenereerd door de service, die de tijd aangeeft waarop het antwoord is geïnitieerd.
x-ms-client-request-id	Kan worden gebruikt om problemen met aanvragen en de bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord.

Hoofdtekst van de reactie

Geen.

Voorbeeldantwoord

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
x-ms-approximate-messages-count: 0  
Date: Fri, 16 Sep 2011 01:27:38 GMT  
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0  

Autorisatie

Deze bewerking kan worden uitgevoerd door de accounteigenaar en door iedereen met een Shared Access Signature met machtigingen om deze bewerking uit te voeren.

Opmerkingen

Geen.

Zie ook

Queue Storage-foutcodes
Aanvragen autoriseren voor Azure Storage
Status en foutcodes