更新队列
更新时间:2025-05-23
描述
更新队列资源配额、超发、抢占配置
请求结构
Bash
1PUT /api/v1/resourcepools/{resourcePoolId}/queue/{queueName}
2Host:aihc.bj.baidubce.com
3Authorization:authorization string
4ContentType: application/json
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必须 | 参数位置 | 说明 |
---|---|---|---|---|
resourcePoolId | String | 是 | Path 参数 | 标识资源池的唯一标识符 |
queueName | String | 是 | Path 参数 | 特定队列设置的名称 |
description | String | 否 | Body 参数 | 队列描述 |
queueType | String | 否 | Body 参数 | 队列类型,当前支持regular |
deserved | Object | 否 | Body 参数 | 队列可以申请的资源配额数量,包括共享型与独占型GPU资源配额 |
guarantee | Object | 否 | Body 参数 | 队列预留的资源配额,包含独占型GPU资源配额 |
capability | Object | 否 | Body 参数 | 队列在上线时可用的资源配额,包含独占型、共享型与抢占型GPU资源配额 |
disableOversell | Boolean | 否 | Body 参数 | 超发开关,队列是否允许超发,默认为false |
reclaimable | Boolean | 否 | Body 参数 | 被抢占开关,队列资源是否可被抢占,默认为false |
nodes | Object | 否 | Body 参数 | 物理队列绑定节点的信息,合法性同队列创建 |
guarantee | Object | 否 | Body 参数 | 队列预留独占型GPU资源配额 |
queueingStrategy | String | 否 | Body 参数 | 调度策略:StrictFIFO(FIFO 策略) or BestEffortFIFO(遍历策略) |
opend | Bool | 否 | Body 参数 | true 开启队列;false 关闭队列;默认开启队列 |
返回头域
除公共头域外,无其它特殊头域。
返回参数
参数名称 | 类型 | 是否必须 | 说明 |
---|---|---|---|
requestId | String | 是 | 请求ID |
result | QueueResult | 是 | 请求成功时的响应结果 |
请求示例
JSON
1{
2 "description": "This is a test",
3 "disableOversell": true,
4 "guarantee": {
5 "cpu": 3,
6 "memory": 6
7 },
8 "deserved": {
9 "cpu": 5,
10 "memory": 10
11 },
12 "capability": {
13 "cpu": 5,
14 "memory": 10
15 }
16}
返回示例
JSON
1{
2 "result": {
3 "queueName": "demo"
4 },
5 "requestID": "cf293451-89e0-43e2-a673-dd2d2aa8433a"
6}