创建队列
更新时间: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}