你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

解锁消息

项目
08/05/2023

解锁指定订阅中的消息以供其他接收方处理。此操作将删除锁对象，以便能够解锁消息。调用此操作之前，消息必须已事先被某个接收方锁定。

请求

方法	请求 URI	HTTP 版本
PUT	`http{s}://{serviceNamespace}.servicebus.windows.net/{queuePath}/messages/{messageId\|sequenceNumber}/{lockToken}` 或 `http{s}://{serviceNamespace}.servicebus.windows.net/{topicPath}/subscriptions/{subscriptionName}/messages/{messageId\|sequenceNumber}/{lockToken}\|HTTP/1.1`

URI 参数

URI 在所扫视消息的 Location 标头中提供，也可以通过下表所述部件进行构造。

参数	说明
`messageId`	要解锁的消息的 ID，如“速览消息”操作在中`BrokerProperties{MessageId}`返回的那样。
`sequence-number`	要解锁的消息的序列号，如“速览消息”操作在中`BrokerProperties{SequenceNumber}`返回的那样。
`lockToken`	要解锁的消息的锁标记，由中的`BrokerProperties{LockToken}`“速览消息”操作返回。

请求标头

下表介绍必需的和可选的请求标头。

请求标头说明

授权

请求标头	说明
授权	指定以下值之一： Azure Active Directory (Azure AD) JSON Web 令牌 (JWT) 令牌。示例：`Authorization: Bearer <Azure AD JWT token>`。有关生成 Azure AD 令牌的信息，请参阅从应用程序进行身份验证。 SAS 标记。示例：`Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>`。有关生成 SAS 令牌的信息，请参阅生成共享访问签名令牌和生成 SAS 令牌。

指定以下值之一：

Azure Active Directory (Azure AD) JSON Web 令牌 (JWT) 令牌。
示例：Authorization: Bearer <Azure AD JWT token>。
有关生成 Azure AD 令牌的信息，请参阅从应用程序进行身份验证。
SAS 标记。
示例：Authorization: SharedAccessSignature sr=<NAMESPACE NAME>.servicebus.windows.net&sig=<SHARED ACCESS KEY>&se=<TOKEN EXPIRY INSTANT>&skn=<SHARED KEY NAME>。
有关生成 SAS 令牌的信息，请参阅生成共享访问签名令牌和生成 SAS 令牌。

请求正文

无。

响应

响应包含 HTTP 状态代码、一组响应标头以及响应正文。

响应代码

代码	说明
200	消息已成功解锁。
401	授权失败。
404	未找到具有指定 `MessageId` 或 `LockToken`的消息。
410	指定的队列或订阅不存在。
500	内部错误。

有关状态代码的信息，请参阅状态和错误代码。

响应标头

响应标头	说明
Content-Type	设置为 application/atom+xml;type=entry;charset=utf-8。

响应正文

无。

示例

以下 HTTP 请求将解锁消息：

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

服务总线返回以下响应：

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

另请参阅

Service Bus HTTP 客户端示例

通过