Kuyruk Oluşturma (Azure Depolama)

İşlem, Create Queue bir depolama hesabında kuyruk oluşturur.

İstek

İsteği burada gösterildiği gibi oluşturabilirsiniz Create Queue . HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla değiştirin.

Yöntem	İstek URI'si	HTTP sürümü
PUT	https://myaccount.queue.core.windows.net/myqueue	HTTP/1.1

Öykünülmüş depolama hizmeti isteği

Öykünülmüş depolama hizmetine yönelik bir istekte bulunulduğunda öykünücü ana bilgisayar adını ve Azure Kuyruk Depolama bağlantı noktasını olarak 127.0.0.1:10001ve ardından öykünülen depolama hesabı adını belirtin:

Yöntem	İstek URI'si	HTTP sürümü
PUT	http://127.0.0.1:10001/devstoreaccount1/myqueue	HTTP/1.1

Daha fazla bilgi için bkz. Yerel Azure Depolama geliştirmesi için Azurite öykünücüsü kullanma.

URI parametreleri

Burada gösterildiği gibi istek URI'sinde ek parametreler belirtebilirsiniz.

Parametre	Açıklama
timeout	İsteğe bağlı. timeout parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz . Kuyruk hizmeti işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:

İstek üst bilgisi	Açıklama
Authorization	Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme.
Date veya x-ms-date	Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama'ya istekleri yetkilendirme.
x-ms-version	İsteğe bağlı. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
x-ms-meta-name:value	İsteğe bağlı. Kuyrukla meta veri olarak ilişkilendirilecek bir ad-değer çifti. Not: 2009-09-19 sürümünden itibaren meta veri adları C# tanımlayıcıları için adlandırma kurallarına uymalıdır.
x-ms-client-request-id	İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. Azure Kuyruk Depolama'yı izleme.

İstek Gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi içerir.

Durum kodu

Başarılı bir işlem 201 (Oluşturuldu) durum kodunu döndürür.

Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı, aşağıdaki tabloda açıklanan üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi	Description
ms-request-id	Yapılan isteği benzersiz olarak tanımlar ve istekle ilgili sorunları gidermek için bunu kullanabilirsiniz. Daha fazla bilgi için bkz . API işlemleriyle ilgili sorunları giderme.
x-ms-version	İsteği yürütmek için kullanılan Azure Kuyruk Depolama sürümünü gösterir. Bu üst bilgi, 2009-09-19 ve sonraki sürümlerde yapılan istekler için döndürülür.
Date	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
x-ms-client-request-id	İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa ve değer 1024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir. İstekte x-ms-client-request-id üst bilgi yoksa yanıtta bulunmaz.

Örnek yanıt

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  

Yetkilendirme

Bu işlemi yalnızca hesap sahibi çağırabilir.

Açıklamalar

Kullanıcı tanımlı meta verileri oluştururken kuyrukta ad-değer çiftleri olarak belirtebilirsiniz.

Belirtilen ada sahip bir kuyruk zaten varsa, Azure Kuyruk Depolama mevcut kuyrukla ilişkili meta verileri denetler. Mevcut meta veriler istekte Create Queue belirtilen meta verilerle aynıysa, durum kodu 204 (İçerik Yok) döndürülür. Mevcut meta veriler istekle sağlanan meta verilerle Create Queue eşleşmiyorsa işlem başarısız olur ve durum kodu 409 (Çakışma) döndürülür. İstemciler, adlandırılmış bir kuyruğun zaten var olup olmadığını denetlemek üzere ek bir çağrı yapmaktan kaçınmak için bu davranıştan yararlanabilir.

Geçerli kuyruk adları hakkında yönergeler için bkz . Kuyrukları ve meta verileri adlandırma. Belirtilen kuyruk adı geçerli bir ad değilse, Create Queue işlem aşağıdaki örnekte gösterildiği gibi ek hata bilgileriyle birlikte 400 (Hatalı İstek) durum kodunu döndürür:

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>  

Ayrıca bkz.

Azure Kuyruğu hata kodları
Azure Depolama'ya yönelik istekleri yetkilendirme
Durum ve hata kodları