你当前正在访问 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 未找到指定 MessageIdLockToken的消息。
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  

另请参阅