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

删除队列

重要

2021 年 11 月 1 日起,此 API 已过时并停用,不应再使用。

删除现有队列。 此操作删除所有关联的状态,包括队列中的消息。

请求

方法 请求 URI HTTP 版本
DELETE https://management.core.windows.net/{subscription ID}/services/ServiceBus/Namespaces/{Namespace}/Queues/{Queue Path} HTTP/1.1

请求标头

下表介绍必需的和可选的请求标头。

请求标头 说明
命名空间 管理终结点 URL
x-ms-version 2012-03-01

请注意,此请求还需要一个客户端证书。 此证书必须与你为特定订阅上载的证书匹配。

请求正文

无。

响应

响应包括 HTTP 状态代码和一组响应标头。

响应代码

注意

如果创建名称包含特殊或编码字符的队列 (,例如,该队列将编码为test%3FName%3Dvalue%26) ,test?Name=value&则会生成 (401) 未经授权的异常。

代码 说明
200 队列已成功删除。 这并不意味着在 API 调用返回时已完全删除队列。 这意味着它已标记为删除。
401 授权失败。
404 指定的队列不存在。
500 内部错误。

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

响应标头

无。

响应正文

无。