调用DeleteQueue接口删除已创建的队列。

注意 请谨慎使用此接口,一旦删除队列成功,队列内所有消息也一并删除,且不可恢复。

授权信息

默认仅限阿里云账号使用本接口,RAM用户只有在被授予了相关API操作权限后方可使用。本接口的授权信息如下表所示。更多信息,请参见授权策略和示例

Name Value
API DeleteQueue
RAM授权操作 mns:DeleteQueue
资源 acs:mns:$region:$accountid:/queues/$queueName

请求消息

请求消息由请求行、HTTP头和消息体三部分组成:

  • 请求行

    DELETE /queues/$queueName HTTP/1.1

  • 特有Request Header

    无。

  • Request Body

    无。

返回消息

返回消息由返回状态行、HTTP头和消息体三部分组成:

  • HTTP Status Code

    HTTP/1.1 204 No Content

  • 特有Response Header

    无。

  • Response Body

    无。

示例

请求示例:

DELETE /queues/$queueName  HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Wed, 08 Mar 2012 12:00:00 GMT
x-mns-version: 2015-06-06
Authorization: MNS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAM****

返回示例:

HTTP/1.1 204 No Content
x-mns-request-id: 512B2A634403E52B1956****
x-mns-version: 2015-06-06          

错误码

本操作无特有的错误,主要是权限验证类和参数设置类错误。更多信息,请参见错误码