Lås upp meddelande

Artikel
08/05/2023

Låser upp ett meddelande för bearbetning av andra mottagare i en angiven prenumeration. Den här åtgärden tar bort låsobjektet, vilket gör att meddelandet låses upp. Innan åtgärden anropas måste en mottagare först låsa meddelandet.

Förfrågan

Metod	URI för förfrågan	HTTP-version
PUT	`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 markerade meddelandet, eller så kan du konstruera den från de delar som beskrivs i följande tabell.

Parameter	Beskrivning
`messageId`	ID:t för meddelandet som ska låsas upp som returneras av `BrokerProperties{MessageId}` åtgärden Granska meddelande .
`sequence-number`	Sekvensnumret för meddelandet som ska låsas upp som returneras av `BrokerProperties{SequenceNumber}` åtgärden Granska meddelande .
`lockToken`	Token för låset för meddelandet som ska låsas upp som returneras av åtgärden Granska meddelande i `BrokerProperties{LockToken}`.

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 alternativ: 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 signatur för delad åtkomst och Generera SAS-token.

Ange något av följande alternativ:

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 signatur 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	Meddelandet har låsts upp.
401	Auktoriseringsfel.
404	Inget meddelande hittades med angiven `MessageId` eller `LockToken`.
410	Den angivna kön eller prenumerationen finns inte.
500	Internt fel.

Information om statuskoder finns i Status och Felkoder.

Svarsrubriker

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

Svarstext

Inga.

Exempel

Följande HTTP-begäran låser upp ett meddelande:

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 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

Http-klientexempel för Service Bus

Dela via