İletiyi Sil

Bu işlem, kilitli bir iletinin işlenmesini tamamlar ve kuyruktan veya abonelikten siler. Bu işlem, En Az Bir Kez teslim güvencelerini korumak için yalnızca daha önce kilitlenmiş bir ileti başarıyla işlendikten sonra çağrılmalıdır.

İstek

Yöntem İstek URI'si HTTP Sürümü
SİLMEK http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}

veya

http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId|sequenceNumber}/{lockToken}|HTTP/1.1

URI Parametreleri

URI, göz atılan iletinin Konum üst bilgisinde sağlanır veya aşağıdaki tabloda açıklanan bölümlerden oluşturabilirsiniz.

Parametre Açıklama
messageId BrokerProperties{MessageId} işlemi tarafından döndürülerek silinecek iletinin kimliği.
sequence-number BrokerProperties{SequenceNumber} işlemi tarafından döndürüldükçe silinecek iletinin sıra numarası.
lockToken BrokerProperties{LockToken} işlemi tarafından döndürülen silinecek ileti kilidinin belirteci.

İstek Üst Bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır. Listelenen özelliklere ek olarak, üst bilgi özel özellikler içerebilir. Örne bakın.

İstek Üst Bilgisi Açıklama
İzin Aşağıdaki belirteç değerlerinden birini belirtin:

İstek Gövdesi

Hiç kimse.

Yanıt

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

Yanıt Kodları

Kod Açıklama
200 İleti başarıyla silindi.
401 Yetkilendirme hatası.
404 Belirtilen MessageId veya LockTokenile hiçbir ileti bulunamadı.
410 Belirtilen kuyruk veya abonelik yok.
500 İç hata.

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

Yanıt Üst Bilgileri

Yanıt Üst Bilgisi Açıklama
İçerik Türü application/atom+xml;type=entry olarak ayarlayın; charset=utf-8.

Yanıt Gövdesi

Hiç kimse.

Örnek

Aşağıdaki HTTP isteği kuyruktan bir iletiyi siler:

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/31907572-1647-43c3-8741-631acd554d6f/7da9cfd5-40d5-4bb1-8d64-ec5a52e1c547?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=rukochbay&sig=rg9iGsK0ZyYlvhIqyH5IS5tqmeb08h8FstjHLPj3%2f8g%3d&se=1404265946&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0  

Service Bus aşağıdaki yanıtı döndürür:

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:35 GMT  
  
0  

Ayrıca Bkz.