İletiyi Silme (Azure Depolama)

İşlem, Delete Message belirtilen iletiyi kuyruktan siler.

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz Delete Message . HTTPS önerilir.

Yöntem	İstek URI'si	HTTP sürümü
DELETE	https://myaccount.queue.core.windows.net/myqueue/messages/messageid?popreceipt=string-value	HTTP/1.1

değerini depolama hesabınızın adıyla, myqueue kuyruğunuzun adıyla ve string-value iletinin silinmesi için elde edilen pop alındı bilgisinin değeriyle değiştirinmyaccount.

Öykünmüş depolama hizmeti URI'si

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

Yöntem	İstek URI'si	HTTP sürümü
DELETE	http://127.0.0.1:10001/devstoreaccount1/myqueue/messages/messageid?popreceipt=string-value	HTTP/1.1

URI parametreleri

İstek URI'si aşağıdaki parametreleri destekler.

Parametre	Açıklama
popreceipt	Gereklidir. İleti Al veya İletiyi Güncelleştir işlemine önceki bir çağrıdan döndürülen geçerli bir pop alındı bilgisi değeri.
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. Daha fazla bilgi için bkz. Azure Kuyruk Depolama'yı izleme.

İ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 Başlığı	Description
x-ms-request-id	Bu üst bilgi, 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 çalıştırmak 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	Yanıtın başlatıldığı saati gösteren utc tarih/saat değeri. Hizmet bu değeri oluşturur.
x-ms-client-request-id	Bu üst bilgi, istekler ve karşılık gelen yanıtlarla ilgili sorunları gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa üst bilginin değerine x-ms-client-request-id eşittir. Değer en fazla 1.024 görünür ASCII karakterdir. x-ms-client-request-id Üst bilgi istekte yoksa, yanıtta bu üst bilgi bulunmaz.

Yanıt gövdesi

Yok.

Yetkilendirme

Hesap sahibi bu işlemi gerçekleştirebilir. Ayrıca, paylaşılan erişim imzasına sahip olan ve bu işlemi gerçekleştirme izni olan herkes bunu gerçekleştirebilir.

Açıklamalar

Bir iletiyi başarıyla sildiğinizde, ileti silinmek üzere hemen işaretlenir ve artık erişilebilir olmaz.

İstemci İletileri Al işlemiyle bir iletiyi aldıktan sonra, istemcinin iletiyi işlemesi ve silmesi beklenir. İletiyi silmek için işlemin yanıt gövdesinde Get Messages döndürülen iki veri öğeniz olmalıdır:

• İleti kimliği, kuyruktaki iletiyi tanımlayan opak bir GUID değeridir.

• geçerli bir açılır makbuz, iletinin alındığını belirten opak bir değer.

İleti kimliği önceki Get Messages işlemden döndürülür. Pop alındı bilgisi en son Get Messages veya Update Message işlemden döndürülür. İşlemin Delete Message başarılı olması için istekte belirtilen pop alındı bilgisi veya Update Message işleminden döndürülen pop alındı bilgisi ile Get Messages eşleşmelidir.

Pop alındı bilgileri, aşağıdaki olaylardan biri gerçekleşene kadar geçerli kalır:

• İletinin süresi dolar.

• İleti, veya Update Message'den Get Messages alınan son açılır makbuz kullanılarak silinir.

• Görünmezlik zaman aşımı süresi dolar ve ileti bir Get Messages istek tarafından sıralanır. Görünmezlik zaman aşımı sona erdiğinde ileti yeniden görünür hale gelir. Başka bir Get Messages istek tarafından alınırsa, döndürülen pop alındı bilgisi iletiyi silmek veya güncelleştirmek için kullanılabilir.

• İleti yeni bir görünürlük zaman aşımı ile güncelleştirilir. İleti güncelleştirildiğinde yeni bir açılır makbuz döndürülür.

Eşleşen pop alındı bilgisi içeren bir ileti bulunamazsa, hizmet 404 (Bulunamadı) hata kodunu döndürür. Bu hata, pop alındı bilgisinin artık geçerli olmadığı daha önce listelenen durumlarda oluşur.

Ayrıca bkz.

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