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

续订消息的锁

项目
08/05/2023

续订已锁定消息上的锁。

请求

方法	请求 URI	HTTP 版本
POST	`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`	“速览消息”操作在中`BrokerProperties{MessageId}`返回的消息 ID，该消息的锁将为其续订。
`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	内部错误。

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

响应标头

此操作的响应包括以下标头。该响应还可能包括其他标准 HTTP 标头。所有标准标头都符合 HTTP/1.1 协议规范。

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

响应正文

无。

示例

以下 HTTP 请求将续订某个已锁定消息的锁：

POST 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 客户端示例

通过