查询空间列表-Page
更新时间:2022-02-17
接口描述
本接口用于查询用户账号下面所有的空间列表,按page分页方式查询。
请求(Request)
请求URI
GET /v1/space?pageNo={pageNo}&pageSize={pageSize}&spaceName={spaceName}&status={status}
参数名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
pageNo | Integer | 是 | 分页查询标识第几页 |
pageSize | Integer | 是 | 分页查询标识每页多少条数据 |
spaceName | String | 否 | 空间名称筛选,只支持前缀模糊匹配 |
status | String | 否 | 空间状态筛选,可取值:OPERATING, RUNNING, STOPPED |
请求头域
除公共头域外,无其它特殊头域。
请求体
无
响应(Response)
响应头域
除公共头域外,无其它特殊头域。
响应体
参数名称 | 类型 | 描述 |
---|---|---|
pageNo | Integer | 当前页数 |
pageSize | Integer | 当前页的大小 |
data | Array | 空间信息列表 |
+ spaceId | Long | 空间ID |
+ spaceName | String | 空间名称 |
+ type | String | 空间类型 |
+ status | String | 空间状态 |
+ description | String | 空间描述 |
+ deviceCount | Integer | 设备个数 |
+ edgeId | Integer | 所属节点ID |
+ edgeName | String | 所属节点名称 |
totalCount | Integer | 总个数 |
示例
请求示例
Plain Text
1GET /v1/space?status=RUNNING&spaceName=evs_space&pageNo=1&pageSize=10 HTTP/1.1
2x-bce-date: 2020-03-25T09:28:13Z
3host: evs.bj.baidubce.com
4content-type: application/json
5authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
响应示例
Plain Text
1HTTP/1.1 200 OK
2Transfer-Encoding: chunked
3x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
4Cache-Control: no-cache
5Server: BWS
6Date: Tue, 24 Mar 202 013:34:07 GMT
7Content-Type: application/json;charset=UTF-8
8{
9 "pageNo": 1,
10 "pageSize": 10,
11 "data": [
12 {
13 "spaceId": 1,
14 "spaceName": "evs_space_1",
15 "type": "RTMP",
16 "status": "RUNNING",
17 "description": "evs_space_description_1",
18 "deviceCount": 3,
19 "edgeId": 1,
20 "edgeName": "河北保定联通"
21 },
22 {
23 "spaceId": 2,
24 "spaceName": "evs_space_2",
25 "type": "GB28181",
26 "status": "RUNNING",
27 "description": "evs_space_description_2",
28 "deviceCount": 10,
29 "edgeId": 1,
30 "edgeName": "河北保定联通"
31 }
32 ]
33}
错误码
参考公共错误码