İ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:10001
ve 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ı