Renew-Lock för ett meddelande

Artikel
08/05/2023

Förnyar låset på ett redan låst meddelande.

Förfrågan

Metod	URI för förfrågan	HTTP-version
POST	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId\|sequenceNumber}/{lockToken}` eller `http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId\|sequenceNumber}/{lockToken}\|HTTP/1.1`

URI-parametrar

URI:n finns i platsrubriken för det kikade meddelandet, eller så kan du konstruera det från de delar som beskrivs i följande tabell.

Parameter	Beskrivning
`messageId`	ID:t för meddelandet, som returneras av `BrokerProperties{MessageId}` åtgärden Peek Message , som låset ska förnyas för.
`sequence-number`	Sekvensnumret för meddelandet, som returneras av `BrokerProperties{SequenceNumber}` åtgärden Peek Message , som låset ska förnyas för.
`lockToken`	Token för meddelandets lås, som returneras av åtgärden Peek Message i `BrokerProperties{LockToken}`, som låset ska förnyas för.

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud Description

Auktorisering

Begärandehuvud	Description
Auktorisering	Ange något av följande tokenvärden: Azure Active Directory-token (Azure AD) JSON-webbtoken (JWT). Exempel: `Authorization: Bearer <Azure AD JWT token>`. Information om hur du genererar en Azure AD-token finns i Autentisera från ett program. En SAS-token. Exempel: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Information om hur du genererar en SAS-token finns i Generera en signaturtoken för delad åtkomst och Generera SAS-token.

Ange något av följande tokenvärden:

Azure Active Directory-token (Azure AD) JSON-webbtoken (JWT).
Exempel: Authorization: Bearer <Azure AD JWT token>.
Information om hur du genererar en Azure AD-token finns i Autentisera från ett program.
En SAS-token.
Exempel: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
Information om hur du genererar en SAS-token finns i Generera en signaturtoken för delad åtkomst och Generera SAS-token.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och svarstexten.

Svarskoder

Kod	Description
200	Meddelandelåset har förnyats.
401	Auktoriseringsfel.
404	Inget meddelande hittades med angivet `MessageId` eller `LockToken`.
410	Den angivna kön eller prenumerationen finns inte.
500	Internt fel.

Information om statuskoder finns i Status och Felkoder.

Svarsrubriker

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Svarshuvud	Description
Content-Type	Ange till `application/atom+xml;type=entry;charset=utf-8`.

Svarstext

Inga.

Exempel

Följande HTTP-begäran förnyar låset för ett låst meddelande:

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 returnerar följande svar:

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

Se även

Service Bus HTTP-klientexempel

Dela via