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

删除消息

项目
02/03/2024

此操作用于完成对已锁定消息的处理并将其从队列或订阅中删除。只有在成功处理以前锁定的消息后才应调用此操作，以维持至少一次 传送保证。

请求

方法	请求 URI	HTTP 版本
DELETE	`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`	速览 Message 操作返回`BrokerProperties{MessageId}`的要删除的消息的 ID。
`sequence-number`	速览 Message 操作返回`BrokerProperties{SequenceNumber}`的要删除的消息的序列号。
`lockToken`	要删除的消息的锁标记，由中的 `BrokerProperties{LockToken}`速览 Message 操作返回。

请求标头

下表介绍必需的和可选的请求标头。除了所列出的属性外，标头还可以包含自定义属性。请参阅示例。

请求标头说明

授权

请求标头	说明
授权	指定以下令牌值之一： Microsoft Entra ID JSON Web 令牌 (JWT) 令牌。示例：`Authorization: Bearer <Azure AD JWT token>`。有关生成Microsoft Entra令牌的信息，请参阅获取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 令牌。

指定以下令牌值之一：

Microsoft Entra ID JSON Web 令牌 (JWT) 令牌。
示例：Authorization: Bearer <Azure AD JWT token>。
有关生成Microsoft Entra令牌的信息，请参阅获取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 请求将从队列中删除某条消息：

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

通过