İletileri Temizle

İşlem, Clear Messages belirtilen kuyruktan tüm iletileri siler.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Clear Messages . HTTPS kullanmanızı öneririz. myaccount değerini depolama hesabınızın adıyla, myqueue değerini ise kuyruğunuzun adıyla değiştirin.

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

Öykünülen depolama hizmeti için URI

Öykünülen depolama hizmetine karşı 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ının adını belirtin:

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

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 Depolama işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadı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 isteklerini 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 isteklerini 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-client-request-id	İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (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.

İstek gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu ve yanıt üst bilgileri kümesi içerir.

Durum kodu

Başarılı bir işlem 204 (İçerik Yok) 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 üst bilgileri içerir. Yanıt ayrıca ek standart HTTP üst bilgileri içerir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

İstek üst bilgisi	Açıklama
x-ms-request-id	Yapılan isteği benzersiz olarak tanımlar. İstekle ilgili sorunları gidermek için bu üst bilgiyi 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 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	Hizmetin yanıtı gönderdiği saati gösteren utc tarih/saat değeri.
x-ms-client-request-id	İsteklerin ve karşılık gelen yanıtların sorunlarını gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer en fazla 1.024 görünür ASCII karakteriyse üst bilginin değerine x-ms-client-request-id eşittir. İstekte x-ms-client-request-id üst bilgi yoksa, yanıtta bu üst bilgi mevcut olmaz.

Yanıt gövdesi

Yok.

Yetkilendirme

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

Açıklamalar

Kuyrukta çok sayıda ileti varsa, Clear Messages tüm iletiler silinmeden önce zaman aşımına uğraması gerekebilir. Bu durumda Kuyruk Depolama, OperationTimedOut ek hata koduyla birlikte 500 (İç Sunucu Hatası) durum kodunu döndürür. Bu hata kodunu alırsanız, işlem sunucu tarafında başarılı olmuş veya olmayabilir ve işlemi yeniden denemeden önce sunucu durumunu sorgulamanız gerekir. İşlem zaman aşımına ularsa ve sunucu tarafında başarısız olduğu belirlenirse, istemcinin tüm iletilerin silindiğinden emin olmak için başarılı olana kadar yeniden denemeye Clear Messages devam etmesi gerekir.

Ayrıca bkz.

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