你当前正在访问 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} 作返回的消息锁定的标记。 |
请求标头
下表描述了必需和可选的请求标头。
请求标头 | 描述 |
---|---|
授权 | 指定以下值之一:
|
请求正文
没有。
响应
响应包括 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