調用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 錯誤碼
本操作無特有的錯誤,主要是許可權驗證類和參數設定類錯誤。更多資訊,請參見錯誤碼。