通过

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

解锁消息

解锁消息以供指定订阅上的其他接收方处理。 此作将删除锁定对象，导致消息解锁。 在调用作之前，接收方必须先锁定消息。

请求

方法 请求 URI HTTP 版本
放 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 标头中提供，也可以从下表中所述的部分构造 URI。

参数 描述
messageId BrokerProperties{MessageId}作在 中返回的消息的 ID。
sequence-number BrokerProperties{SequenceNumber}作在 中返回的消息的序列号。
lockToken 中 BrokerProperties{LockToken}作返回的消息锁定的标记。

请求标头

下表描述了必需和可选的请求标头。

请求标头 描述
授权 指定以下值之一：
  • Microsoft Entra JSON Web 令牌 （JWT） 令牌。
    示例：Authorization: Bearer <Azure AD JWT token>。
    有关生成Microsoft Entra 令牌的信息，请参阅 从应用程序进行身份验证。
  • 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

另请参阅