Vytvoření fronty (Azure Storage)

  • Článek

Operace Create Queue vytvoří frontu v účtu úložiště.

Žádost

Požadavek můžete vytvořit, Create Queue jak je znázorněno tady. Doporučujeme používat protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
PUT https://myaccount.queue.core.windows.net/myqueue HTTP/1.1

Žádost o službu emulovaného úložiště

Když vytvoříte požadavek na službu emulovaného úložiště, zadejte název hostitele emulátoru a port služby Azure Queue Storage jako 127.0.0.1:10001a pak název emulovaného účtu úložiště:

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
PUT http://127.0.0.1:10001/devstoreaccount1/myqueue HTTP/1.1

Další informace najdete v tématu Použití emulátoru Azurite pro vývoj v místním úložišti Azure Storage.

Parametry identifikátoru URI

V identifikátoru URI požadavku můžete zadat další parametry, jak je znázorněno tady.

Parametr Popis
timeout Nepovinný parametr. Parametr se timeout vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace služby Fronta.

Hlavičky požadavku

Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date nebo x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
x-ms-version Nepovinný parametr. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-meta-name:value Nepovinný parametr. Pár název-hodnota, který se přidruží k frontě jako metadata.

Poznámka: Od verze 2009-09-19 musí názvy metadat splňovat pravidla pojmenování pro identifikátory jazyka C#.
x-ms-client-request-id Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování služby Azure Queue Storage.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 201 (Vytvořeno).

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje hlavičky, které jsou popsány v následující tabulce. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Description
ms-request-id Jednoznačně identifikuje požadavek, který byl proveden, a můžete ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi Azure Queue Storage, která se používá ke spuštění požadavku. Tato hlavička se vrátí pro požadavky provedené proti verzi 2009-09-19 a novější.
Date Hodnota data a času UTC, která je vygenerovaná službou a která označuje čas, kdy byla odpověď inicializována.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě hlavičky, pokud je v požadavku a hodnota obsahuje maximálně 1024 viditelných x-ms-client-request-id znaků ASCII. Pokud se hlavička x-ms-client-request-id v požadavku nenachází, v odpovědi se nezobrazí.

Ukázková odpověď

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

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Metadata definovaná uživatelem můžete ve frontě zadat jako páry název-hodnota při jejím vytváření.

Pokud už fronta se zadaným názvem existuje, Azure Queue Storage zkontroluje metadata, která jsou přidružená k existující frontě. Pokud jsou existující metadata shodná s metadaty zadanými v Create Queue požadavku, vrátí se stavový kód 204 (Bez obsahu). Pokud se stávající metadata neshoduje s metadaty poskytnutými s Create Queue požadavkem, operace selže a vrátí se stavový kód 409 (Konflikt). Klienti mohou využít tohoto chování, aby se vyhnuli dalšímu volání, které kontroluje, zda pojmenovaná fronta již existuje.

Pokyny týkající se platných názvů front najdete v tématu Názvy front a metadat. Pokud zadaný název fronty není platný, Create Queue operace vrátí stavový kód 400 (Chybný požadavek) a další informace o chybě, jak je znázorněno v následujícím příkladu:

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>

Viz také

Kódy chyb služby Azure Queue
Autorizace požadavků do Služby Azure Storage
Stavové kódy a kódy chyb