视频监控 > API 文档 > 设备管理相关接口 >获取设备列表

获取设备列表

最近更新时间：2021-09-23 16:16:46

描述

本接口用于查询空间下的设备列表。

接口请求域名：qvs.qiniuapi.com
请求方式：GET
接口路径：/v1/namespaces/{namespaceId}/devices?offset=<offset>&line=<line>&prefix=<prefix>&status=<status>&qtype=<qtype>

请求参数

路径参数

参数名称	必填	字段类型	说明
namespaceId	是	string	空间ID
offset	否	integer	在全部流中的偏移量
line	否	integer	一次返回多少条
prefix	否	string	可以通过gbid前缀、设备名称或设备描述进行检索查询，支持模糊查询
state	否	string	按设备状态查询，offline: 离线, online: 在线, notReg: 未注册, locked: 锁定
qtype	否	integer	按设备类型查询，0:全部, 1:摄像头, 2:平台

响应参数

参数名称	类型	说明
items	设备数组	设备数组
items.gbId	string	设备国标Id
items.name	string	设备名称
items.state	string	状态（offline: 离线, online: 在线, notReg: 未注册, locked: 锁定）
items.desc	string	设备描述
items.status	boolean	false: 未推流状态, true:推流状态
items.createdAt	integer	创建时间，Unix时间戳，秒
items.updatedAt	integer	更新时间，Unix时间戳，秒
items.lastKeepaliveAt	integer	最近心跳时间, Unix时间戳, 秒
items.lastRegisterAt	integer	最近注册时间, Unix时间戳, 秒

示例

请求示例

curl --request GET \
  --url http://qvs.qiniuapi.com/v1/namespaces/2akrarvzvyijd/devices \
  --header 'authorization: Qiniu j853F3bLkWl59I5BOkWm6q1Z1mZClpr9Z9CLfDE0:u372aQV0359mzwTVGxn22sRgFYc='
}'

响应示例

{
  "items": [
    {
      "name": "device1",
      "desc": "gb patch test",
      "nsId": "2akrarvzvyijd",
      "nsName": "gbt",
      "gbId": "31011500991320000028",
      "state": "notReg",
      "username": "username",
      "password": "password",
      "pullIfRegister": false,
      "createdAt": 1596166110,
      "updatedAt": 1596176486,
      "channels": 0,
      "lastRegisterAt": 0,
      "lastKeepaliveAt": 0
    },
    {
      "name": "beijing_test",
      "desc": "gbtest11",
      "nsId": "2akrarvzvyijd",
      "nsName": "gbt",
      "gbId": "31011500991320000020",
      "state": "offline",
      "username": "aaaaa",
      "password": "aaaaa",
      "pullIfRegister": true,
      "createdAt": 1595313745,
      "updatedAt": 1596081446,
      "channels": 0,
      "lastRegisterAt": 1596024977,
      "lastKeepaliveAt": 1596089383
    }
  ],
  "total": 2
}

以上内容是否对您有帮助？