获取队列列表信息
更新时间:2026-07-02
接口描述
查询指定队列下的节点列表,返回节点的详细信息包括基本信息、资源统计等。支持按实例ID筛选。
请求语法
Plaintext
1GET ?action=ListQueueNodes&queueId=xxxxx&instanceIds=xxxxx
2Host: aihc.bj.baidubce.com
3Authorization: authorization string
4Content-Type: application/json
请求头域
除公共头域外,无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| queueId | String | 是 | 队列ID |
| instanceIds | String | 否 | 实例ID列表,多个ID用逗号分隔,用于筛选指定实例 |
返回头域
除公共头域外,无其他特殊头域。
返回参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| count | Integer | 总数量 |
| result | List<NodeDetail> | 节点详情列表 |
NodeDetail 节点详情
| 参数名称 | 类型 | 说明 |
|---|---|---|
| createdAt | String | 创建时间 |
| updatedAt | String | 更新时间 |
| expireTime | String | 过期时间 |
| instanceId | String | 实例ID |
| instanceName | String | 实例名称 |
| flavorName | String | 规格名称 |
| chargeType | String | 计费方式,可选值:prepay(预付费)、postpay(后付费) |
| resourcePoolId | String | 资源池ID |
| resourceQueueId | String | 资源队列ID |
| regionId | String | 地域ID |
| instancePhase | String | 实例阶段,可选值:creating、running、deleting 等 |
| isRdmaCard | Integer | 是否RDMA卡,0:否,1:是 |
| eriNum | Integer | ERI数量 |
| enableMig | Boolean | 是否启用MIG |
| gpuDescriptor | String | GPU描述 |
| gpuCardType | String | GPU卡类型 |
| nodeStatus | String | 节点状态,可选值:creating、ready、ready_cordon、not_ready、deleting 等 |
| k8sNodeName | String | K8s节点名称 |
| ehcClusterId | String | 弹性高性能计算集群ID |
| zoneName | String | 可用区 |
| scaleDownDisabled | Boolean | 是否禁止缩容 |
| cpuCoresCapacity | Integer | CPU核数容量 |
| cpuCoresAllocated | Integer | CPU核数已分配 |
| cpuCoresRemaining | Integer | CPU核数剩余 |
| cpuCoresWorkloadAvailable | Integer | CPU核数工作负载可用 |
| cpuCoresWorkloadAllocated | Integer | CPU核数工作负载已分配 |
| memoryGiCapacity | Integer | 内存容量(GiB) |
| memoryGiAllocated | Integer | 内存已分配(GiB) |
| memoryGiRemaining | Integer | 内存剩余(GiB) |
| memoryGiWorkloadAvailable | Integer | 内存工作负载可用(GiB) |
| memoryGiWorkloadAllocated | Integer | 内存工作负载已分配(GiB) |
| gpuNumCapacity | Integer | GPU卡数容量 |
| gpuNumRemaining | Float | GPU卡数剩余 |
| gpuNumAllocated | Float | GPU卡数已分配 |
| cpuCoresBestEffortAllocated | Integer | 闲时任务CPU核数已分配 |
| memoryGiBestEffortAllocated | Integer | 闲时任务内存已分配(GiB) |
| gpuBestEffortAllocated | Float | 闲时任务GPU已分配 |
| taskPodList | List<TaskPod> | 任务Pod列表 |
| jobList | List<JobInfo> | 任务列表 |
| extenderResources | List<ResourceStatistic> | 扩展资源统计 |
| migResource | MigResource | MIG资源信息 |
TaskPod 任务Pod
| 参数名称 | 类型 | 说明 |
|---|---|---|
| podName | String | Pod名称 |
| namespace | String | 命名空间 |
| jobUid | String | Job UID |
返回示例
Plaintext
1{
2 "count": 2,
3 "result": [
4 {
5 "createdAt": "2024-01-15T10:30:00Z",
6 "updatedAt": "2024-01-15T10:30:00Z",
7 "expireTime": "2025-01-15T10:30:00Z",
8 "instanceId": "ins-1",
9 "instanceName": "gpu-node-01",
10 "flavorName": "bcc.gr1.c8m64.2p",
11 "chargeType": "prepay",
12 "resourcePoolId": "pool-xyz",
13 "resourceQueueId": "queue-123",
14 "regionId": "bj",
15 "instancePhase": "running",
16 "isRdmaCard": 1,
17 "eriNum": 0,
18 "enableMig": false,
19 "gpuDescriptor": "A100",
20 "gpuCardType": "A100-80G",
21 "nodeStatus": "ready",
22 "k8sNodeName": "192.168.1.10",
23 "ehcClusterId": "cluster-001",
24 "zoneName": "cn-bj-d",
25 "scaleDownDisabled": false,
26 "cpuCoresCapacity": 64,
27 "cpuCoresAllocated": 32,
28 "cpuCoresRemaining": 32,
29 "cpuCoresWorkloadAvailable": 60,
30 "cpuCoresWorkloadAllocated": 4,
31 "memoryGiCapacity": 512,
32 "memoryGiAllocated": 256,
33 "memoryGiRemaining": 256,
34 "memoryGiWorkloadAvailable": 500,
35 "memoryGiWorkloadAllocated": 12,
36 "gpuNumCapacity": 8,
37 "gpuNumRemaining": 4,
38 "gpuNumAllocated": 4,
39 "cpuCoresBestEffortAllocated": 0,
40 "memoryGiBestEffortAllocated": 0,
41 "gpuBestEffortAllocated": 0,
42 "taskPodList": [],
43 "extenderResources": [
44 {
45 "resourceType": "cds",
46 "capacity": 5,
47 "allocated": 0,
48 "idle": 5,
49 "allocationRate": 0,
50 "utilizationRate": 0
51 },
52 {
53 "resourceType": "pfsL2",
54 "capacity": 1,
55 "allocated": 0,
56 "idle": 1,
57 "allocationRate": 0,
58 "utilizationRate": 0
59 }
60 ]
61 },
62 {
63 "createdAt": "2024-01-16T08:20:00Z",
64 "updatedAt": "2024-01-16T08:20:00Z",
65 "expireTime": "2025-01-16T08:20:00Z",
66 "instanceId": "ins-2",
67 "instanceName": "gpu-node-02",
68 "flavorName": "bcc.gr1.c8m64.2p",
69 "chargeType": "postpay",
70 "resourcePoolId": "pool-xyz",
71 "resourceQueueId": "queue-123",
72 "regionId": "bj",
73 "instancePhase": "running",
74 "isRdmaCard": 0,
75 "eriNum": 0,
76 "enableMig": false,
77 "gpuDescriptor": "A100",
78 "gpuCardType": "A100-80G",
79 "nodeStatus": "ready",
80 "k8sNodeName": "192.168.1.11",
81 "ehcClusterId": "cluster-001",
82 "zoneName": "cn-bj-d",
83 "scaleDownDisabled": false,
84 "cpuCoresCapacity": 64,
85 "cpuCoresAllocated": 16,
86 "cpuCoresRemaining": 48,
87 "cpuCoresWorkloadAvailable": 60,
88 "cpuCoresWorkloadAllocated": 4,
89 "memoryGiCapacity": 512,
90 "memoryGiAllocated": 128,
91 "memoryGiRemaining": 384,
92 "memoryGiWorkloadAvailable": 500,
93 "memoryGiWorkloadAllocated": 12,
94 "gpuNumCapacity": 8,
95 "gpuNumRemaining": 6,
96 "gpuNumAllocated": 2,
97 "cpuCoresBestEffortAllocated": 0,
98 "memoryGiBestEffortAllocated": 0,
99 "gpuBestEffortAllocated": 0,
100 "taskPodList": [],
101 "extenderResources": [
102 {
103 "resourceType": "cds",
104 "capacity": 5,
105 "allocated": 0,
106 "idle": 5,
107 "allocationRate": 0,
108 "utilizationRate": 0
109 },
110 {
111 "resourceType": "pfsL2",
112 "capacity": 1,
113 "allocated": 0,
114 "idle": 1,
115 "allocationRate": 0,
116 "utilizationRate": 0
117 }
118 ]
119 }
120 ]
121}
评价此篇文章
