Delen via

Renew-Lock voor een bericht

  • Artikel

Hiermee vernieuwt u de vergrendeling voor een bericht dat al is vergrendeld.

Aanvraag

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

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

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, een set antwoordheaders en de hoofdtekst van het antwoord.

Antwoordcodes

Code Description
200 De berichtenvergrendeling is vernieuwd.
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

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

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

Hoofdtekst van antwoord

Geen.

Voorbeeld

Met de volgende HTTP-aanvraag wordt de vergrendeling voor een vergrendeld bericht vernieuwd:

POST 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

Service Bus HTTP-clientvoorbeeld