查询服务详情
更新时间:2026-01-28
接口描述
查询服务详情信息。
请求结构
Bash
1GET ?action=DescribeService&serviceId=serviceId
2HTTP/1.1
3Host:aihc.bj.baidubce.com
4version: v2
5Authorization:authorization string
请求头域
除公共头域外,无其它特殊头域。
请求参数
| 参数名 | 参数类型 | 是否必须 | 参数位置 | 参数说明 |
|---|---|---|---|---|
| serviceId | String | 必选 | Query参数 | 服务ID |
返回头域
除公共头域,无其它特殊头域。
返回参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| service | ServiceConf | 服务的详细配置信息 |
| status | ServiceStatus | 服务网络状态信息 |
| instances | List<InsInfo> | 实例信息 |
| creator | String | 创建人 |
| createdAt | Integer | 创建时间 |
| updatedAt | Integer | 更新时间 |
| requestId | String | 请求Id |
请求示例
Bash
1GET ?action=DescribeService&serviceId=s-r7d45dcffa0a
2HTTP/1.1
3Host:aihc.bj.baidubce.com
4version: v2
5Authorization:authorization string
返回示例
返回server:Service
Bash
1HTTP/1.1 200 OK
2x-bce-request-id: 63df3394-3edd-4977-a5d4-0d0fd021a42d
3Date:Wed,
423 Apr 2025 13: 08: 46 GMT
5Content-Type: application/json;charset=UTF-8
6Server: Service
7{
8 "createdAt": 1745411842,
9 "creator": "openapi",
10 "instances": [
11 {
12 "containers": [
13 {
14 "container": {
15 "command": [
16 "/bin/sh",
17 "-c",
18 "sleep inf"
19 ],
20 "cpus": 1,
21 "image": {
22 "imageUrl": "registry.baidubce.com/inference/vllm-openai:v0.8.3"
23 },
24 "memory": 2,
25 "name": "custom-container",
26 "ports": [
27 {
28 "name": "HTTP",
29 "port": 10088
30 }
31 ],
32 "volumeMounts": [
33 {
34 "volumnName": "bosv2vu04u433", #bos类型挂载
35 "mountPath": "/mnt/aihc_model_dir",
36 "readOnly": false
37 },
38 {
39 "volumnName": "pfse471xhc4", #pfs类型挂载
40 "mountPath": "/vllm-works/models",
41 "readOnly": false
42 }
43 ]
44 },
45 "status": {
46 "containerStatus": "Running",
47 "createdAt": 1745411851
48 }
49 }
50 ],
51 "instanceId": "s-r7d45dcffa0a-7ddffdd8db-sbrhh",
52 "status": {
53 "availableContainers": 1,
54 "createdAt": 1745411849,
55 "nodeIP": "10.0.7.38",
56 "podIP": "10.0.50.96",
57 "status": "Running",
58 "totalContainers": 1
59 }
60 }
61 ],
62 "requestId": "63df3394-3edd-4977-a5d4-0d0fd021a42d",
63 "service": {
64 "access": {
65 "aiGateway": {
66 "enableAuth": true
67 },
68 "networkType": "aiGateway"
69 },
70 "containers": [
71 {
72 "command": [
73 "/bin/sh",
74 "-c",
75 "sleep inf"
76 ],
77 "cpus": 1,
78 "image": {
79 "imageUrl": "registry.baidubce.com/inference/vllm-openai:v0.8.3"
80 },
81 "memory": 2,
82 "name": "custom-container",
83 "ports": [
84 {
85 "name": "HTTP",
86 "port": 10088
87 }
88 ],
89 "volumeMounts": [
90 {
91 "volumnName": "bosv2vu04u433", #bos类型挂载
92 "mountPath": "/mnt/aihc_model_dir",
93 "readOnly": false
94 },
95 {
96 "volumnName": "pfse471xhc4", #pfs类型挂载
97 "mountPath": "/vllm-works/models",
98 "readOnly": false
99 }
100 ]
101 }
102 ],
103 "deploy": {
104 "canaryStrategy": {
105 "maxSurge": 25,
106 "maxUnavailable": 25
107 },
108 "schedule": {
109 "priority": "high"
110 }
111 },
112 "hpa": {},
113 "instanceCount": 1,
114 "log": {},
115 "misc": {
116 "gracePeriodSec": 30,
117 "podAnnotations": {
118 "prometheus.io/scrape": "false"
119 },
120 "podLabels": {
121 "scheduling.volcano.sh/group-min-member": "1"
122 }
123 },
124 "name": "openapi-test-4",
125 "resourcePool": {
126 "queueName": "default",
127 "resourcePoolId": "cce-7t7mqjci",
128 "resourcePoolName": "aihc-pom"
129 },
130 "storage": { // 存储挂载
131 "shmSize": 7,
132 "volumns": [
133 {
134 "volumeType": "bos", #bos类型挂载
135 "volumnName": "bosv2vu04u433",
136 "pfs": null,
137 "hostpath": {
138 "sourcePath": ""
139 },
140 "dataset": {},
141 "bos": {
142 "secret": {
143 "name": "",
144 "namespace": "aihc-pom"
145 },
146 "sourcePath": "aihc-models-bj/Qwen/Qwen3-0.6B-FP8" #bos的源路径
147 }
148 },
149 {
150 "volumeType": "pfs", #pfs类型挂载
151 "volumnName": "pfse471xhc4",
152 "pfs": {
153 "instanceId": "pfs-DjKrQp",
154 "instanceType": "",
155 "hostMountPath": "",
156 "mountTargetId": null,
157 "clusterIP": "",
158 "clientID": "pfs-DjKrQp",
159 "clusterPort": "",
160 "sourcePath": "/mnt/model" #pfs的源路径
161 },
162 "hostpath": {
163 "sourcePath": ""
164 },
165 "dataset": {}
166 }
167 ]
168 }
169 },
170 "status": {
171 "accessIPs": {
172 "internal": "10.0.7.54"
173 },
174 "accessPorts": [
175 {
176 "containerPort": 10088,
177 "name": "HTTP",
178 "servicePort": 10088
179 }
180 ],
181 "briefStat": {
182 "availableIns": 1,
183 "status": 2,
184 "totalIns": 1
185 }
186 },
187 "updatedAt": 1745411842
188}
