Skapa kö (Azure Storage)

  • Artikel

Åtgärden Create Queue skapar en kö i ett lagringskonto.

Förfrågan

Du kan skapa Create Queue begäran enligt nedan. Vi rekommenderar att du använder HTTPS. Ersätt myaccount med namnet på ditt lagringskonto.

Metod URI för förfrågan HTTP-version
PUT https://myaccount.queue.core.windows.net/myqueue HTTP/1.1

Emulerad lagringstjänstbegäran

När du gör en begäran mot den emulerade lagringstjänsten anger du emulatorns värdnamn och Azure Queue Storage-porten som 127.0.0.1:10001, följt av namnet på det emulerade lagringskontot:

Metod URI för förfrågan HTTP-version
PUT http://127.0.0.1:10001/devstoreaccount1/myqueue HTTP/1.1

Mer information finns i Använda Azurite-emulatorn för lokal Azure Storage-utveckling.

URI-parametrar

Du kan ange ytterligare parametrar för begärande-URI:n, som du ser här.

Parameter Beskrivning
timeout Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för kötjänståtgärder.

Begärandehuvuden

De obligatoriska och valfria begäranderubrikerna beskrivs i följande tabell:

Begärandehuvud Beskrivning
Authorization Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
Date eller x-ms-date Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage.
x-ms-version Valfritt. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänster.
x-ms-meta-name:value Valfritt. Ett namn/värde-par som ska associeras med kön som metadata.

Obs! Från och med version 2009-09-19 måste metadatanamn följa namngivningsreglerna för C#-identifierare.
x-ms-client-request-id Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Queue Storage.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Statuskod

En lyckad åtgärd returnerar statuskoden 201 (skapad).

Information om statuskoder finns i Status och felkoder.

Svarshuvuden

Svaret för den här åtgärden innehåller rubrikerna som beskrivs i följande tabell. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Svarsrubrik Description
ms-request-id Identifierar begäran som gjordes unikt och du kan använda den för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
x-ms-version Anger den Azure Queue Storage-version som används för att köra begäran. Det här huvudet returneras för begäranden mot version 2009-09-19 och senare.
Date Ett UTC-datum/tid-värde som genereras av tjänsten och som anger den tid då svaret initierades.
x-ms-client-request-id Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. x-ms-client-request-id Om rubriken inte finns i begäran visas den inte i svaret.

Exempelsvar

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

Auktorisering

Endast kontoägaren kan anropa den här åtgärden.

Kommentarer

Du kan ange användardefinierade metadata som namn/värde-par i kön när du skapar den.

Om det redan finns en kö med det angivna namnet kontrollerar Azure Queue Storage de metadata som är associerade med den befintliga kön. Om befintliga metadata är identiska med de metadata som anges i Create Queue begäran returneras statuskod 204 (inget innehåll). Om befintliga metadata inte matchar de metadata som tillhandahålls med Create Queue begäran misslyckas åtgärden och statuskoden 409 (konflikt) returneras. Klienter kan dra nytta av det här beteendet för att undvika ytterligare ett anrop för att kontrollera om det redan finns en namngiven kö.

Vägledning om giltiga könamn finns i Namnköer och metadata. Om det angivna könamnet inte är ett giltigt namn Create Queue returnerar åtgärden statuskoden 400 (felaktig begäran) tillsammans med ytterligare felinformation, enligt följande exempel:

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>

Se även

Azure Queue-felkoder
Auktorisera begäranden till Azure Storage
Status- och felkoder