查询多角色服务访问信息
更新时间：2026-10-21
接口描述
查询多角色服务（服务组）的访问信息，包括访问 IP、端口、网关路径前缀、鉴权 token 和鉴权开关状态。调用服务所需的信息都在这个接口里，「查询详情」不返回这些内容。
返回里包含鉴权 token，请妥善保管，不要写进日志或提交到代码库。
请求结构
Plain Text
1GET /?action=DescribeGroupServiceAccess&serviceGroupId={serviceGroupId}
2HTTP/1.1
3Host:aihc.bj.baidubce.com
4version: v2
5Authorization:authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 参数类型 | 是否必须 | 参数位置 | 参数说明 |
|---|---|---|---|---|
| serviceGroupId | String | 是 | query | 服务组 ID |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 说明 |
|---|---|---|
| requestId | String | 唯一标识请求，用于日志排查 |
| enableAuth | Bool | 是否开启鉴权 |
| accessIPs | AccessIPConf | 访问 IP：external（外网）、internal（内网） |
| accessPorts | Array of AccessPortConf | 访问端口 |
| aiGateway | AIGateWay | 网关访问信息 |
请求示例
Plain Text
1GET /?action=DescribeGroupServiceAccess&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": "ad2b801e-e2c6-4bbe-bafd-f897a38cdc95",
5 "enableAuth": true,
6 "accessIPs": {
7 "external": "x.x.x.x",
8 "internal": "10.x.x.x"
9 },
10 "accessPorts": [
11 { "name": "llm-scheduler", "containerPort": 8000, "servicePort": 8000 }
12 ],
13 "aiGateway": {
14 "basePath": "/g-xxxxxxxxxxxx/",
15 "tokens": {
16 "serveless": "Bearer xxxxxxxx-xxxxxxxxxxxx-xxxxxxxxxxxx",
17 "servelessId": "cs-xxxxxxxxxxxx"
18 }
19 },
20 "domains": null
21}评价此篇文章