获取BEC服务列表
更新时间：2025-08-05
接口描述
本接口用于获取BEC容器服务列表。
请求结构
Plain Text
1GET /v1/service?pageNo={pageNo}&pageSize={pageSize}&keywordType={keywordType} HTTP/1.1
2Host: bec.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| pageNo | Integer | 否 | RequestParam参数 | 页数，缺省值为1 |
| pageSize | Integer | 否 | RequestParam参数 | 每页容器服务个数，取值范围为1～100，缺省值为100。 |
| keywordType | String | 否 | RequestParam参数 | 查询部署的关键字类型。取值分别为： 缺省为serviceName。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| result | List<ServiceBriefVo> | 列表数据 |
| orderBy | String | 排序字段 |
| order | String | 排序顺序。取值为DESC、ASC，分别对应降序、升序。 |
| pageNo | Integer | 页码 |
| pageSize | Integer | 单页结果数 |
| totalCount | Integer | 结果总数 |
错误码
请参照错误返回章节的内容。
请求示例
Plain Text
1GET /v1/service?pageNo=1&pageSize=10&keyword=&keywordType=serviceId HTTP/1.1
2Host: bec.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2015 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6
7{
8"result":{
9 "order":null,
10 "orderBy":null,
11 "orders":null,
12 "pageNo":1,
13 "pageSize":10,
14 "result":[
15 {
16 "createTime":"2019-12-11T16:06:44Z",
17 "deployInstances":[
18 {
19 "region":"EAST_CHINA",
20 "replicas":1,
21 "serviceProvider":"CHINA_MOBILE"
22 }
23 ],
24 "lastUpdateTime":null,
25 "level":null,
26 "regions":1,
27 "serviceId":"s-af3oavto",
28 "serviceName":"niumingliang-gputest-3",
29 "status":"RUNNING",
30 "tagsMap":[
31 {
32 "tagKey":"a",
33 "tagValue":"1"
34 }
35 ],
36 "totalCpu":2,
37 "totalDisk":8,
38 "totalMem":4,
39 "totalPods":1
40 }
41 ],
42 "totalCount":1
43},
44"success":true
45}Model对象定义
ServiceBriefVo
| 参数名称 | 类型 | 描述 |
|---|---|---|
| serviceId | String | BEC服务ID |
| serviceName | String | BEC服务名称 |
| level | String | 预留参数，默认null |
| status | String | 资源状态(STOP，RUNNING，PENDING，TERMINATING，FAILED，SUCCEEDED，UNKNOWN，TERMINATED，WAITING) |
| totalCpu | float | cpu总量 |
| totalMem | float | 内存总量 |
| totalDisk | Integer | 磁盘总量 |
| regions | Integer | 地域数量 |
| totalPods | Integer | pod总量 |
| tagsMap | List<Tag> | 标签列表 |
| deployInstances | List<DeploymentInstance | 部署实例信息 |
| createTime | Timestamp | 创建时间 |
| lastUpdateTime | Timestamp | 更新时间 |
DeploymentInstance
| 参数名称 | 类型 | 描述 |
|---|---|---|
| region | String | 地域(CENTRAL_CHINA，EAST_CHINA，NORTH_CHINA，SOUTH_CHINA，NORTH_EAST，NORTH_WEST，SOUTH_WEST) |
| serviceProvider | String | 服务运营商(CHINA_MOBILE，CHINA_UNICOM，CHINA_TELECOM) |
| replicas | Integer | 副本数 |