查询多角色服务详情
更新时间：2026-10-21
接口描述
查询单个多角色服务（服务组）的详情，包括服务组配置、各角色的状态概要，以及 LLM 调度器的实例信息。
详情里不包含调用信息（访问地址、端口、鉴权 token）。调用信息请用「查询多角色服务访问信息」接口获取。
请求结构
Plain Text
1GET /?action=DescribeGroupService&serviceGroupId={serviceGroupId}
2HTTP/1.1
3Host:aihc.bj.baidubce.com
4version: v2
5Authorization:authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 参数类型 | 是否必须 | 参数位置 | 参数说明 |
|---|---|---|---|---|
| serviceGroupId | String | 是 | query | 服务组 ID |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| requestId | String | 唯一标识请求，用于日志排查 |
| serviceGroup | ServiceGroupDetail | 服务组详情 |
请求示例
Plain Text
1GET /?action=DescribeGroupService&serviceGroupId=g-xxxxxxxxxxxx
2HTTP/1.1
3Host:aihc.bj.baidubce.com
4version: v2
5Authorization:authorization string返回示例
Plain Text
1HTTP/1.1 200 OK
2
3{
4 "requestId": "...",
5 "serviceGroup": {
6 "serviceGroupId": "g-xxxxxxxxxxxx",
7 "groupName": "qwen3-32b-pd",
8 "creator": "liushuai37",
9 "createdAt": 1792410249,
10 "updatedAt": 1792410249,
11 "resourcePool": {
12 "resourcePoolId": "aihc-xxxxxxxxxxxx",
13 "resourcePoolType": "serverless",
14 "resourcePoolName": "",
15 "queueName": ""
16 },
17 "aiGateway": {
18 "aigwId": "aigw-xxxxxxxx",
19 "aigwName": "infer-model",
20 "enableAuth": true,
21 "protocol": "http",
22 "strategy": "round-robin",
23 "version": "v2"
24 },
25 "llmScheduler": {
26 "enable": true,
27 "inferEngine": "sglang",
28 "policy": "pd_split",
29 "pdPolicy": { "prefillPolicy": "prefix_aware", "decodePolicy": "random" },
30 "replicas": 1,
31 "resourceSpec": { "cpus": 2, "memory": 8 }
32 },
33 "roles": [
34 {
35 "id": "s-xxxxxxxxxxxx",
36 "roleName": "prefill",
37 "resourceSpec": { "cpus": 16, "memory": 128, "acceleratorCount": 1, "acceleratorType": "baidu.com/a800_80g_cgpu" },
38 "briefStat": { "status": 2, "availableIns": 1, "totalIns": 1, "reason": "" },
39 "createdAt": 1792410249,
40 "updatedAt": 1792410607
41 },
42 { "id": "s-yyyyyyyyyyyy", "roleName": "decode", "...": "..." }
43 ],
44 "llmSchedulerInstances": [ { "instanceId": "...", "status": { "...": "..." }, "containers": [ "..." ] } ],
45 "publicModel": { "enable": false, "engine": "", "modelId": "", "scenario": "" }
46 }
47}评价此篇文章