Wachtrij maken (Azure Storage)

Artikel
08/05/2023

Met de Create Queue bewerking wordt een wachtrij gemaakt in een opslagaccount.

Aanvraag

U kunt de Create Queue aanvraag samenstellen zoals hier wordt weergegeven. U wordt aangeraden HTTPS te gebruiken. Vervang myaccount door de naam van uw opslagaccount.

Methode	Aanvraag-URI	HTTP-versie
`PUT`	`https://myaccount.queue.core.windows.net/myqueue`	HTTP/1.1

Aanvraag voor geëmuleerde opslagservice

Wanneer u een aanvraag doet voor de geëmuleerde opslagservice, 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
`PUT`	`http://127.0.0.1:10001/devstoreaccount1/myqueue`	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

U kunt aanvullende parameters opgeven voor de aanvraag-URI, zoals hier wordt weergegeven.

Parameter	Beschrijving
`timeout`	Optioneel. De `timeout` parameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor wachtrijservicebewerkingen 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. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie.
`Date` of `x-ms-date`	Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie.
`x-ms-version`	Optioneel. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor Azure Storage-services voor meer informatie.
`x-ms-meta-name:value`	Optioneel. Een naam-waardepaar dat als metagegevens aan de wachtrij moet worden gekoppeld. Opmerking: vanaf versie 2009-09-19 moeten metagegevensnamen voldoen aan de naamgevingsregels voor C#-id's.
`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 201 (gemaakt).

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de headers die in de volgende tabel worden beschreven. Het antwoord kan ook extra standaard-HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Antwoordheader	Beschrijving
`ms-request-id`	Identificeert op unieke wijze de aanvraag die is gedaan en u kunt deze gebruiken 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 wordt gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen die zijn gedaan op basis van versie 2009-09-19 en hoger.
`Date`	Een UTC-datum/tijd-waarde die wordt gegenereerd door de service en die de tijd aangeeft waarop het antwoord is gestart.
`x-ms-client-request-id`	Kan worden gebruikt om problemen met aanvragen en 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.

Voorbeeldantwoord

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: Fri, 16 Sep 2011 01:20:22 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0

Autorisatie

Alleen de accounteigenaar kan deze bewerking aanroepen.

Opmerkingen

U kunt door de gebruiker gedefinieerde metagegevens opgeven als naam-waardeparen in de wachtrij wanneer u deze maakt.

Als er al een wachtrij met de opgegeven naam bestaat, controleert Azure Queue Storage de metagegevens die zijn gekoppeld aan de bestaande wachtrij. Als de bestaande metagegevens identiek zijn aan de metagegevens die zijn opgegeven in de Create Queue aanvraag, wordt statuscode 204 (Geen inhoud) geretourneerd. Als de bestaande metagegevens niet overeenkomen met de metagegevens die bij de Create Queue aanvraag zijn opgegeven, mislukt de bewerking en wordt statuscode 409 (Conflict) geretourneerd. Clients kunnen profiteren van dit gedrag om een extra aanroep te voorkomen om te controleren of er al een benoemde wachtrij bestaat.

Zie Naamwachtrijen en metagegevens voor hulp bij geldige wachtrijnamen. Als de opgegeven wachtrijnaam geen geldige naam is, retourneert de Create Queue bewerking statuscode 400 (Ongeldige aanvraag), samen met aanvullende foutinformatie, zoals wordt weergegeven in het volgende voorbeeld:

HTTP/1.1 400 One of the request inputs is out of range.  
Connection: Keep-Alive  
Content-Length: 226  
Via: 1.1 TK5-PRXY-22  
Date: Wed, 02 May 2012 17:47:54 GMT  
Content-Type: application/xml  
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f  
x-ms-version: 2011-08-18  
  
<?xml version="1.0" encoding="utf-8"?>  
<Error>  
   <Code>OutOfRangeInput</Code>  
   <Message>One of the request inputs is out of range.  
   RequestId:fda2babe-ffbb-4f0e-a11b-2bfbd871ba9f  
   Time:2012-05-02T17:47:55.4334169Z</Message>  
</Error>

Zie ook

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

Delen via