查询设备列表-Marker
所有文档

          智能视联网平台 EVS

          查询设备列表-Marker

          接口描述

          本接口用于查询用户空间下面所有的设备列表,按marker分页方式查询。

          请求(Request)

          请求URI

          GET /v1/device?spaceId={spaceId}&marker={marker}&maxSize={maxSize}&deviceName={deviceName}&status={status}

          参数名称 类型 是否必需 描述
          spaceId Long 所属空间ID
          marker Long 设备ID,marker键必须存在,但值可以为空
          maxSize Integer 查询结果最大条数
          deviceName String 设备名称筛选,只支持前缀模糊匹配
          status String 设备当前状态,区分设备类型,RTMP设备状态包含:ONLINE(在线)/RUNNING(推流中)/OFFLINE(已封禁设备),GB28181设备状态包含:UNREGISTERED(未注册)/ONLINE(注册后)/OFFLINE(注销后)

          请求头域

          除公共头域外,无其它特殊头域。

          请求体

          响应(Response)

          响应头域

          除公共头域外,无其它特殊头域。

          响应体

          参数名称 类型 描述
          marker String 本次查询的起点
          nextMarker String 下一次查询的起点,为空表示已经返回所有结果
          truncated Boolean 指明是否所有查询都返回了;false:本次已经返回所有结果,true:本次还没有返回所有结果
          data Array 空间信息列表
          + deviceId Long 设备ID
          + deviceName String 设备名称
          + spaceName String 空间名称
          + type String 设备类型,RTMP/GB28181
          + status String 设备状态
          + description String 设备描述
          + platform String 国标设备平台,IPC/NVR
          + manufacturer String 国标设备厂商
          + channelCount Integer 国标通道个数

          示例

          请求示例

          GET /v1/device?spaceId=1000618&marker&maxSize=2 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
          {
              "data": [
                  {
                      "deviceId": 1000908,
                      "deviceName": "evs_device_name",
                      "spaceName": "evs_space_name",
                      "type": "RTMP",
                      "channelCount": 0,
                      "status": "ONLINE",
                      "description": "",
                      "deviceStreamId": "appId/streamId",
                      "domainList": [
                          {
                              "domain": "bcds9n12sumw6yp8iux.a.e-web.com.cn",
                              "type": "DOWNSTREAM",
                              "cname": "bcds9n12sumw6yp8iux.a.e-web.com.cn"
                          },
                          {
                              "domain": "bcdsnsvz5at494i9xpm.b.e-web.com.cn",
                              "type": "UPSTREAM",
                              "cname": "bcdsnsvz5at494i9xpm.b.e-web.com.cn"
                          }
                      ]
                  },
                  {
                      "deviceId": 1000762,
                      "deviceName": "evs_device_name1",
                      "spaceName": "evs_space_name",
                      "type": "RTMP",
                      "channelCount": 0,
                      "status": "ONLINE",
                      "description": "",
                      "deviceStreamId": "appId/streamId1",
                      "domainList": [
                          {
                              "domain": "bcds9n12sumw6yp8iux.a.e-web.com.cn",
                              "type": "DOWNSTREAM",
                              "cname": "bcds9n12sumw6yp8iux.a.e-web.com.cn"
                          },
                          {
                              "domain": "bcdsnsvz5at494i9xpm.b.e-web.com.cn",
                              "type": "UPSTREAM",
                              "cname": "bcdsnsvz5at494i9xpm.b.e-web.com.cn"
                          }
                      ]
                  }
              ],
              "marker": "1000908",
              "nextMarker": "1000762",
              "truncated": true
          }

          错误码

          参考公共错误码

          上一篇
          查询设备列表-Page
          下一篇
          启用设备