Odbieranie i usuwanie komunikatu (odczyt destrukcyjny)

Ta operacja odbiera komunikat z kolejki lub subskrypcji i usuwa komunikat z tej kolejki lub subskrypcji w jednej operacji niepodzielnej.

Żądanie

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
DELETE	http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/head lub http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/head|HTTP/1.1

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań. Oprócz wymienionych właściwości nagłówek może zawierać właściwości niestandardowe. Zobacz przykład.

Nagłówek żądania

Opis

Autoryzacja

Określ jedną z następujących wartości tokenu: Token tokenu internetowego JSON (JWT) usługi Azure Active Directory (Azure AD). Przykład: Authorization: Bearer <Azure AD JWT token>. Aby uzyskać informacje na temat generowania tokenu Azure AD, zobacz Uwierzytelnianie z aplikacji. Token SAS. Przykład: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>. Aby uzyskać informacje na temat generowania tokenu SAS, zobacz Generowanie tokenu sygnatury dostępu współdzielonego i Generowanie tokenu SYGNATURy dostępu współdzielonego.

Treść żądania

Brak.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kody odpowiedzi

Kod	Opis
200	Komunikat został pomyślnie pobrany i usunięty.
204	Brak dostępnych komunikatów w określonym przedziale czasu.
400	Nieprawidłowe żądanie.
401	Niepowodzenie autoryzacji.
410	Określona kolejka lub subskrypcja nie istnieje.
500	Błąd wewnętrzny.

Aby uzyskać informacje o kodach stanu, zobacz Status and Error Codes (Kody stanu i błędów).

Nagłówki odpowiedzi

Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.

Treść odpowiedzi

Treść odpowiedzi to treść komunikatu pobranego.

Przykład

Następujące żądanie HTTP odbiera i usuwa komunikat z kolejki:

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  

Usługa Service Bus zwraca następującą odpowiedź. Komunikat zawiera właściwości niestandardowe "Priority" i "Customer":

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  

Zobacz też

Przykład klienta HTTP usługi Service Bus