Kuyruk Meta Verilerini Ayarlama

İşlem, Set Queue Metadata belirtilen kuyrukta kullanıcı tanımlı meta verileri ayarlar. Meta veriler kuyrukla ad-değer çiftleri olarak ilişkilendirilir.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Set Queue Metadata . HTTPS kullanmanızı öneririz.

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

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

Öykünülmüş depolama hizmetinde istekte bulunmak için öykünücü ana bilgisayar adını ve Kuyruk hizmeti bağlantı noktasını olarak 127.0.0.1:10001ve ardından öykünülmüş depolama hesabı adını belirtin:

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

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

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreleri 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:string-value	İsteğe bağlı. Kuyrukla meta veri olarak ilişkilendirilecek bir ad-değer çifti. Bu işleme yapılan her çağrı, kuyruğa eklenen tüm mevcut meta verilerin yerini alır. Kuyruktan tüm meta verileri kaldırmak için, meta veri üst bilgileri olmadan bu işlemi çağırın. 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.

Örnek istek

Request Syntax:  
PUT https://myaccount.queue.core.windows.net/myqueue?comp=metadata HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Fri, 16 Sep 2011 01:47:14 GMT  
x-ms-meta-meta-sample1: sample1  
x-ms-meta-meta-sample2: sample2  
Authorization: SharedKey myaccount:u6PSIebDltGW5xHpO77epRpiUhcsTkWMvcM4GTmfqqA=  

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 204 (İçerik Yok) durum kodunu döndürür.

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

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki ü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
x-ms-request-id	Yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için kullanılabilir. Daha fazla bilgi için bkz . API işlemleriyle ilgili sorunları giderme.
x-ms-version	İsteği yürütmek için kullanılan Kuyruk hizmeti 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	Bu üst bilgi, isteklerde ve ilgili yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa ve değer 1.024'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.

Yanıt gövdesi

Yok.

Yetkilendirme

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

Açıklamalar

Kuyruk meta verilerini silmek için herhangi bir meta veri üst bilgisi belirtmeden çağrısında Set Queue Metadata bulunma.

Ayrıca bkz.

Kuyruk hizmeti hata kodları
Azure Depolama'ya yönelik istekleri yetkilendirme
Durum ve hata kodları