İleti Alma ve Silme (Yıkıcı Okuma)

Bu işlem bir kuyruktan veya abonelikten bir ileti alır ve iletiyi tek bir atomik işlemle bu kuyruktan veya abonelikten kaldırır.

İstek

Yöntem	İstek URI'si	HTTP Sürümü
DELETE	http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/head veya http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head|HTTP/1.1

İ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 Başlığı

Description

Yetkilendirme

Aşağıdaki belirteç değerlerinden birini belirtin: Azure Active Directory (Azure AD) JSON Web Belirteci (JWT) belirteci. Örnek: Authorization: Bearer <Azure AD JWT token>. Azure AD belirteci oluşturma hakkında bilgi için bkz. Uygulamadan kimlik doğrulaması yapma. SAS belirteci. Örnek: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>. SAS belirteci oluşturma hakkında bilgi için bkz. Paylaşılan Erişim İmzası belirteci oluşturma ve SAS belirteci oluşturma.

İstek Gövdesi

Yok.

Yanıt

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

Yanıt Kodları

Kod	Description
200	İleti başarıyla alındı ve silindi.
204	Belirtilen zaman aşımı süresi içinde kullanılabilir ileti yok.
400	Hatalı istek.
401	Yetkilendirme hatası.
410	Belirtilen kuyruk veya abonelik yok.
500	İç hata.

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, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Gövdesi

Yanıt gövdesi, alınan iletinin ileti gövdesidir.

Örnek

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

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/head?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace&sig=Fg8yUyR4MOmXfHfj55f5hY4jGb8x2Yc%2b3%2fULKZYxKZk%3d&se=1404256819&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0  

Service Bus aşağıdaki yanıtı döndürür. İleti , "Priority" ve "Customer" özel özelliklerini içerir:

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
BrokerProperties: {"DeliveryCount":1,"EnqueuedSequenceNumber":0,"EnqueuedTimeUtc":"Tue, 01 Jul 2014 23:00:23 GMT","Label":"M1","MessageId":"3a146f76afee41648677887ffced72d8","SequenceNumber":1,"State":"Active","TimeToLive":10}  
Priority: "High"  
Customer: "12345,ABC"  
Date: Tue, 01 Jul 2014 23:00:23 GMT  
  
12  
This is a message.  
0  

Ayrıca Bkz.

Service Bus HTTP İstemcisi örneği