Delen via

Bericht ontvangen en verwijderen (destructief lezen)

  • Artikel

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

Aanvraag

Methode Aanvraag-URI HTTP-versie
DELETE 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 vereiste en optionele aanvraagheaders beschreven. Naast de vermelde eigenschappen kan de header ook aangepaste eigenschappen bevatten. Zie het voorbeeld.

Aanvraagkoptekst Description
Autorisatie Geef een van de volgende tokenwaarden op:
  • JSON-webtoken (JWT) van Azure Active Directory (Azure AD).
    Bijvoorbeeld: Authorization: Bearer <Azure AD JWT token>.
    Zie Verifiëren vanuit een toepassing voor meer informatie over het genereren van een Azure AD-token.
  • Een SAS-token.
    Bijvoorbeeld: 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 genereren voor meer informatie over het genereren van een SAS-token.

Aanvraagbody

Geen.

Antwoord

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

Antwoordcodes

Code Description
200 Het bericht is opgehaald en verwijderd.
204 Er zijn geen berichten beschikbaar binnen de opgegeven time-outperiode.
400 Ongeldige aanvraag.
401 Autorisatiefout.
410 De opgegeven wachtrij of het opgegeven abonnement bestaat niet.
500 Interne fout.

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende 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 'Prioriteit' en 'Klant':

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

Voorbeeld van Service Bus HTTP-client