查询空间列表-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 | 总个数 |
示例
请求示例
GET /v1/space?status=RUNNING&spaceName=evs_space&pageNo=1&pageSize=10 HTTP/1.1
x-bce-date: 2020-03-25T09:28:13Z
host: evs.bj.baidubce.com
content-type: application/json
authorization: bce-auth-v1/e8e4a9ced6794355a9a1b8a20b58d37b/2020-03-25T09:28:13Z/1800/content-type;host;x-date/4a1692dc4bab84f5801f79ea0c1fece3601cf73ecd94409d2a94b3942b971715
响应示例
HTTP/1.1 200 OK
Transfer-Encoding: chunked
x-bce-request-id: 012b9747-f13a-4a2c-a488-02b221844dca
Cache-Control: no-cache
Server: BWS
Date: Tue, 24 Mar 202 013:34:07 GMT
Content-Type: application/json;charset=UTF-8
{
"pageNo": 1,
"pageSize": 10,
"data": [
{
"spaceId": 1,
"spaceName": "evs_space_1",
"type": "RTMP",
"status": "RUNNING",
"description": "evs_space_description_1",
"deviceCount": 3,
"edgeId": 1,
"edgeName": "河北保定联通"
},
{
"spaceId": 2,
"spaceName": "evs_space_2",
"type": "GB28181",
"status": "RUNNING",
"description": "evs_space_description_2",
"deviceCount": 10,
"edgeId": 1,
"edgeName": "河北保定联通"
}
]
}
错误码
参考公共错误码