创建队列
更新时间：2025-05-06
描述
创建资源池队列
请求结构
Plain Text
1POST /api/v1/resourcepools/{resourcePoolId}/queue
2Host:aihc.bj.baidubce.com
3Authorization:authorization string
4ContentType: application/json请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 说明 |
|---|---|---|---|---|
| resourcePoolId | String | 是 | Path参数 | 标识资源池的唯一标识符 |
| description | String | 否 | Body参数 | 队列描述 |
| name | String | 是 | Body参数 | 队列名称 |
| queueType | String | 否 | Body参数 | 队列类型，当前支持 Regular（普通队列）、Elastic（弹性队列）和 Physical（物理队列） |
| parentQueue | String | 否 | Body参数 | 父队列，为空时默认为资源池配额 |
| deserved | Object | 否 | Body参数 | 队列可以申请的资源配额数量，包括共享型与独占型GPU资源配额。queueType 为 Regular 或 Physical 时，deserved 须与 capability 传值相同。 queueType 为 Elastic 时，deserved 非必填，如果传值，capability 也必须传值，两者值可以不同。 |
| guarantee | Object | 否 | Body参数 | 队列预留的资源配额，包含独占型GPU资源配额 queueType 为 Regular 时，guarantee 不能传值。 queueType 为 Elastic 时，guarantee 非必填，如果传值，capability 和 deserved 也必须传值。 queueType 为 Physical 时，guarantee 须与 capability 传值相同。 |
| capability | Object | 否 | Body参数 | 队列在上线时可用的资源配额，包含独占型、共享型与抢占型GPU资源配额 |
| disableOversell | Boolean | 否 | Body参数 | 超发开关，队列是否允许超发，默认为false |
| reclaimable | Boolean | 否 | Body参数 | 被抢占开关，队列资源是否可被抢占，默认为false |
| nodes | Object | 否 | Body参数 | 物理队列绑定节点的信息; 注意合法性：NodeNames 数量要小于等于 Nodecount 数量 |
| queueingStrategy | String | 否 | Body参数 | 调度策略：StrictFIFO（FIFO 策略） or BestEffortFIFO（遍历策略） |
| opend | Bool | 否 | Body参数 | true 开启队列；false 关闭队列；默认开启队列 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| requestId | String | 是 | 请求ID |
| result | QueueResult | 是 | 请求成功时的响应结果 |
请求示例
Plain Text
1{
2 "description": "This is a test queue",
3 "deserved": {
4 "cpu": 10,
5 "baidu.com/a800_80g_cgpu": 2,
6 "memory": 20
7 },
8 "name": "demo",
9 "parentQueue": "root",
10 "queueType": "Regular",
11 "disableOversell": false
12}返回示例
Plain Text
1{
2 "result": {
3 "queueName": "def1"
4 },
5 "requestID": "524eef70-c7fc-4b78-84a4-bd949a757be2"
6}