Vytvoření fronty (Azure Storage)

Článek
08/05/2023

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

Sdílet prostřednictvím