Delen via

Bericht ontgrendelen

  • Artikel

Ontgrendelt een bericht voor verwerking door andere ontvangers in een opgegeven abonnement. Met deze bewerking wordt het vergrendelingsobject verwijderd, waardoor het bericht wordt ontgrendeld. Voordat de bewerking wordt aangeroepen, moet een ontvanger het bericht eerst vergrendelen.

Verzoek

Methode Aanvraag-URI HTTP-versie
ZETTEN 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 locatieheader van het gekeken 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 ontgrendeld zoals geretourneerd in BrokerProperties{MessageId} door de bewerking Bericht weergeven.
sequence-number Het volgnummer van het bericht dat moet worden ontgrendeld als geretourneerd in BrokerProperties{SequenceNumber} door de bewerking Bericht weergeven.
lockToken Het token van de vergrendeling van het bericht dat moet worden ontgrendeld als geretourneerd door de bewerking Bericht weergeven in BrokerProperties{LockToken}.

Aanvraagheaders

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader Beschrijving
Machtiging Geef een van de volgende waarden 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, een set antwoordheaders en de hoofdtekst van het antwoord.

Antwoordcodes

Code Beschrijving
200 Bericht is ontgrendeld.
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 foutcodesvoor meer informatie over statuscodes.

Antwoordheaders

Antwoordheader Beschrijving
Inhoudstype Ingesteld op application/atom+xml;type=entry; charset=utf-8.

Hoofdtekst van antwoord

Geen.

Voorbeeld

Met de volgende HTTP-aanvraag wordt een bericht ontgrendeld:

PUT 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