创建队列
更新时间：2024-09-25
接口描述
指定集群创建一个队列。
请求结构
POST /v{version}/cluster/{clusterId}/queue HTTP/1.1
Host: chpc.bj.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其他特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号。 |
| clusterId | String | 是 | URL参数 | 创建队列所属的集群id |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，生效时长为24小时。 |
| queueName | String | 是 | RequestBody参数 | 队列名，集群内唯一，长度为2~15个字符。队列名称只能包含英文大小写字母、数字、和_ 。必须以英文字母开头，英文或数字结尾 |
响应头域
除公共头域，无其他特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| requestId | String | 请求ID |
错误码
| 错误码 | 错误描述 | HTTP状态码 | 中文解释 |
|---|---|---|---|
| BadRequest | cluster c-xxxxxxxx is in xxx status, cannot add queue, only active status allowed. | 400 | 只有处于active状态的虚机可以创建队列 |
| The default queue does not allow deletion | queue already exists | 400 | 对列已存在 |
请求示例
POST /v1/cluster/c-arPHgRIb/queue
Host: chpc.bj.baidubce.com
Authorization: bce-auth-v1/ALTAKfdDegfDEgedgyhted54dg/2023-08-22T11:30:08Z/1800/host/c3eec4e0e6ccb0b11c7ca4e8fe02e35ad519e02c72968dba70a44e7901cd85d8
Content-Type:
{
"queueName": "queue1"
}响应示例
{
"requestId": "633e6471-ea6b-4a05-89ef-5f51a3338454"
}