Delen via

Bericht verwijderen

  • Artikel

Met deze bewerking wordt de verwerking van een vergrendeld bericht voltooid en wordt het uit de wachtrij of het abonnement verwijderd. Deze bewerking mag alleen worden aangeroepen nadat een eerder vergrendeld bericht is verwerkt om At-Least-Once-bezorgingsgaranties te behouden.

Aanvraag

Methode Aanvraag-URI HTTP-versie
DELETE http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId|sequenceNumber}/{lockToken}

of

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

URI-parameters

De URI wordt opgegeven in de koptekst Locatie van het bekeken bericht of u kunt deze samenstellen op basis van de onderdelen die in de volgende tabel worden beschreven.

Parameter Beschrijving
messageId De id van het bericht dat moet worden verwijderd zoals geretourneerd door BrokerProperties{MessageId} de bewerking Kort weergeven Bericht.
sequence-number Het volgnummer van het bericht dat moet worden verwijderd zoals geretourneerd door BrokerProperties{SequenceNumber} de bewerking Kort weergeven Bericht.
lockToken Het token van de vergrendeling van het bericht dat moet worden verwijderd zoals geretourneerd door de bewerking Kort weergeven Bericht in BrokerProperties{LockToken}.

Aanvraagheaders

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

Aanvraagkoptekst Description
Autorisatie Geef een van de volgende tokenwaarden op:
  • Microsoft Entra ID JWT-token (JSON Web Token).
    Bijvoorbeeld: Authorization: Bearer <Azure AD JWT token>.
    Zie Een Microsoft Entra token ophalen voor meer informatie over het genereren van een Microsoft Entra 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, een set antwoordheaders en de hoofdtekst van het antwoord.

Antwoordcodes

Code Description
200 Het bericht is verwijderd.
401 Autorisatiefout.
404 Er is geen bericht gevonden met de opgegeven MessageId of LockToken.
410 De opgegeven wachtrij of het opgegeven abonnement bestaat niet.
500 Interne fout.

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Reactieheader Description
Content-Type Instellen op application/atom+xml;type=entry; charset=utf-8.

Hoofdtekst van antwoord

Geen.

Voorbeeld

Met de volgende HTTP-aanvraag wordt een bericht uit een wachtrij verwijderd:

DELETE https://your-namespace.servicebus.windows.net/HttpClientSampleQueue/messages/31907572-1647-43c3-8741-631acd554d6f/7da9cfd5-40d5-4bb1-8d64-ec5a52e1c547?timeout=60 HTTP/1.1  
Authorization: SharedAccessSignature sr=rukochbay&sig=rg9iGsK0ZyYlvhIqyH5IS5tqmeb08h8FstjHLPj3%2f8g%3d&se=1404265946&skn=RootManageSharedAccessKey  
Host: your-namespace.servicebus.windows.net  
Content-Length: 0

Service Bus retourneert het volgende antwoord:

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/xml; charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 01 Jul 2014 23:00:35 GMT  
  
0

Zie ook

Voorbeeld van Service Bus HTTP-client