Odemknout zprávu

Článek
07/19/2023

Odemkne zprávu pro zpracování jinými příjemci v zadaném předplatném. Tato operace odstraní objekt zámku, což způsobí odemknutí zprávy. Před zavolání operace musí příjemce zprávu nejprve uzamknout.

Žádost

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
PUT	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId\|sequenceNumber}/{lockToken}` nebo `http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId\|sequenceNumber}/{lockToken}\|HTTP/1.1`

Parametry identifikátoru URI

Identifikátor URI je k dispozici v hlavičce Location náhledu zprávy nebo ho můžete vytvořit z částí popsaných v následující tabulce.

Parametr	Popis
`messageId`	ID zprávy, která má být odemknuta vrácena v `BrokerProperties{MessageId}` operaci Náhled zprávy .
`sequence-number`	Pořadové číslo zprávy, která se má odemknout, vracená operací `BrokerProperties{SequenceNumber}`Náhled zprávy .
`lockToken`	Token zámku zprávy, která má být odemknutá vrácená operací Náhled zprávy v `BrokerProperties{LockToken}`.

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Description

Autorizace

Hlavička požadavku	Description
Autorizace	Určete jednu z následujících možností: Token AZURE Active Directory (Azure AD) JSON Web Token (JWT). Příklad: `Authorization: Bearer <Azure AD JWT token>`. Informace o vygenerování tokenu Azure AD najdete v tématu Ověřování z aplikace. Token SAS. Příklad: `Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`. Informace o vygenerování tokenu SAS najdete v tématech Generování tokenu sdíleného přístupového podpisu a Generování tokenu SAS.

Určete jednu z následujících možností:

Token AZURE Active Directory (Azure AD) JSON Web Token (JWT).
Příklad: Authorization: Bearer <Azure AD JWT token>.
Informace o vygenerování tokenu Azure AD najdete v tématu Ověřování z aplikace.
Token SAS.
Příklad: Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>.
Informace o vygenerování tokenu SAS najdete v tématech Generování tokenu sdíleného přístupového podpisu a Generování tokenu SAS.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Kódy odpovědí

Kód	Description
200	Zpráva byla úspěšně odemčena.
401	Autorizace se nezdařila.
404	Nebyla nalezena žádná zpráva se zadaným `MessageId` parametrem nebo `LockToken`.
410	Zadaná fronta nebo předplatné neexistuje.
500	Vnitřní chyba.

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Hlavička odpovědi	Description
Typ obsahu	Nastavte na application/atom+xml;type=entry;charset=utf-8.

Text odpovědi

Žádné

Příklad

Následující požadavek HTTP odemkne zprávu:

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 vrátí následující odpověď:

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

Viz také

Ukázka klienta HTTP služby Service Bus

Sdílet prostřednictvím