删除队列
更新时间：2024-09-25
接口描述
- 删除指定集群的一个指定队列。
- 默认队列不可删除。
- 使用调度器的集群，队列中存在节点时不可删除
请求结构
DELETE /v{version}/cluster/{clusterId}/queue/{queueName} HTTP/1.1
Host: chpc.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号。 |
| clusterId | String | 是 | URL参数 | 队列所属的集群id |
| queueName | String | 是 | URL参数 | 队列名 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串。 |
响应头域
除公共头域，无其他特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 请求ID |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| BadRequest | The default queue does not allow deletion | 400 | 修改的集群描述应该与当前集群描述不一样 |
| BadRequest | The queue which is not active does not allow deletion | 400 | 只有处于active状态的队列允许删除 |
| BadRequest | he queue which is not empty does not allow deletion | 400 | 对列中存在节点，无法删除。 |
请求示例
DELETE /v1/cluster/c-arPHgRIb/queue/queue1
Host: chpc.bj.baidubce.com
Authorization: bce-auth-v1/ALTAKfdDegfDEgedgyhted54dg/2023-08-22T11:35:34Z/1800/host/99a18198dfd91ecaf821207a93ba04176b19afab948c001a5c11beffc7a5ff6b响应示例
{
"requestId": "4ea842e2-2285-4f67-8b40-ddff746c6e49",
"queueName": "queue1"
}