Bericht ontvangen en verwijderen (destructief lezen)

Deze bewerking ontvangt een bericht uit een wachtrij of abonnement en verwijdert het bericht uit die wachtrij of het abonnement in één atomische bewerking.

Verzoek

Methode Aanvraag-URI HTTP-versie
VERWIJDEREN http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/head

of

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

Aanvraagheaders

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven. Naast de vermelde eigenschappen kan de header aangepaste eigenschappen bevatten. Zie het voorbeeld.

Aanvraagheader Beschrijving
Machtiging Geef een van de volgende tokenwaarden op:
  • Microsoft Entra JSON Web Token (JWT)-token.
    Voorbeeld: Authorization: Bearer <Azure AD JWT token>.
    Zie Verifiëren vanuit een toepassingvoor meer informatie over het genereren van een Microsoft Entra-token.
  • Een SAS-token.
    Voorbeeld: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
    Zie Een Shared Access Signature-token genereren en SAS-token genererenvoor meer informatie over het genereren van een SAS-token.

Hoofdtekst van aanvraag

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Antwoordcodes

Code Beschrijving
200 Bericht is opgehaald en verwijderd.
204 Er zijn geen berichten beschikbaar binnen de opgegeven time-outperiode.
400 Ongeldig verzoek.
401 Autorisatiefout.
410 De opgegeven wachtrij of het opgegeven abonnement bestaat niet.
500 Interne fout.

Zie status- en foutcodesvoor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook meer standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Hoofdtekst van antwoord

De hoofdtekst van het antwoord is de berichttekst van het opgehaalde bericht.

Voorbeeld

De volgende HTTP-aanvraag ontvangt en verwijdert een bericht uit een wachtrij:

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 retourneert het volgende antwoord. Het bericht bevat de aangepaste eigenschappen Priority en 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

Zie ook

  • Last updated on