Deleting Queues
Last updated: 2019-07-05 12:22:35
1. API Description
This API (DeleteQueue) is used to delete a created queue.
Domain for public network API request:cmq-queue-region.api.qcloud.com
Domain for private network API request:cmq-queue-region.api.tencentyun.com
- region should be replaced by specific region: gz (Guangzhou), sh (Shanghai), bj (Beijing). The region value in the common parameter should be kept consistent with the one of the domain. In case of inconsistency, the domain region should prevail. The request should be sent to the region specified by the domain.
- Requests for accessing via public network domain support both HTTP and HTTPS. Requests for accessing via private network only support HTTP.
- Some of the input parameters are optional, so the default values are not required.
- All output parameters will be returned to the user when the request is successful; otherwise, at least code, message, and requestId will be returned.
2. Input Parameters
The following request parameter list only provides API request parameters. For other parameters, refer to Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
queueName | Yes | String | Queue name. This is unique under the same account in one region. The name of queue is a string with no more than 64 characters. It must start with letter, and the rest may contain letters, numbers and dashes (-). |
3. Output Parameters
Parameter Name | Type | Description |
---|---|---|
code | Int | 0: Succeed, 4440: Queue does not exist. For the meanings of other returned values, please refer to Error Codes. |
message | String | Error message. |
requestId | String | ID of the request generated by server. When there is an internal error on the server, users can submit this ID to backend to locate the problem. |
4. Example
Input:
https://domain/v2/index.php?Action=DeleteQueue &queueName=test-queue-123 &<Common request parameters>
Output:
{
"code" : 0,
"message" : "",
"requestId":"14534664555"
}