Udostępnij przez

Odbieranie i usuwanie komunikatu (odczyt destruktywny)

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

Prosić

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
USUNĄĆ 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) firmy Microsoft.
    Przykład: Authorization: Bearer <Azure AD JWT token>.
    Aby uzyskać informacje na temat generowania tokenu entra firmy Microsoft, zobacz Uwierzytelnianie na podstawie aplikacji.
  • Token SYGNATURY dostępu współdzielonego.
    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 SAS.

Treść żądania

Żaden.

Odpowiedź

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 stan i kody błędów.

Nagłówki odpowiedzi

Odpowiedź dla tej operacji zawiera następujące nagłówki. Odpowiedź może również zawierać bardziej 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 komunikatu.

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ż

  • Last updated on