最近更新时间：2023-02-01
查询设备详细信息
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 系统指定参数。取值：QueryDeviceInfo |
| DeviceId | 是 | String | 设备ID |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
RequestId | 是 | String | 该条接口请求ID |
Code | 是 | String | 0成功 其他失败 |
Message | 否 | String | 结果信息，成功时为空 |
Data | 否 | Object | 返回数据，json对象结构 此接口为空 |
| --DeviceId | 是 | String | 设备ID |
| --Type | 是 | String | 设备类型。取值：ipc、nvr、channel、platform |
| --Name | 是 | String | 设备名称。 |
--GroupId | 是 | String | 设备所属空间ID。 |
--GroupName | 否 | String | 设备所属空间名称。 |
| --ParentId | 否 | String | 上级设备ID |
| --MaxChannelNum | 否 | Long | 最大通道数量。 |
| --ChannelId | 否 | Long | 通道号 |
| --GbDeviceId | 否 | String | 设备国标ID |
| --GbVersion | 否 | String | gb28181协议版本号，仅gb28181空间ipc、nvr设备有效。取值：2011、2016。 |
| --PushUrl | 否 | String | 推流地址 |
| --UserName | 否 | String | 鉴权用户名（NVR的通道可以不用设置）。 |
--Password | 否 | String | 鉴权密码（NVR的通道可以不用设置）。 |
| --ManageStatus | 是 | String | 设备管理状态。取值：active（启用）、stop（停用） |
--Longitude | 否 | String | 设备经度 |
| --Latitude | 否 | String | 设备纬度 |
| --DeviceIp | 否 | String | 设备IP |
| --DevicePort | 否 | Long | 设备端口号 |
| --DeviceSn | 否 | String | 设备序列号 |
--DeviceAddress | 否 | String | 设备地址 |
--Description | 否 | String | 设备描述 |
--SupportPtz | 否 | Integer | 是否支持云台 0:不支持 1:支持 |
| --BusinessStatus | 否 | String | 设备业务状态，4位状态位0000,从右到左依次为: 计划录制状态,手动录制状态,计划截图状态,手动截图状态。（状态位更新有3-6分钟左右延迟）0:空闲 1:开启中 |
| --MaxLocalRecordUploadTaskNum | 否 | Long | 本地上传任务并发最大值，ipc(1-3)，nvr（1-2*MaxChannelNum+1）platform（1-100） |
| --CreateTime | 是 | String | 设备创建时间 格式如：yyyy-MM-ddTHH:mm:ssZ，UTC时间 |
| --UpdateTime | 是 | String | 设备更新时间 格式如：yyyy-MM-ddTHH:mm:ssZ，UTC时间 |
| --MaxChannelId | 否 | Integer | 设备已使用的最大通道序号，nvr设备专用 |
| --EnableGps | 是 | Bool | 是否开启设备GPS数据上传 |
| --GpsStoreDays | 是 | Long | GPS数据保存时间，取值：0 ~ 36 (月)，0表示永久存储。 |
请求示例:
GET https://api.unicloud.com/univms?
Action=QueryDeviceInfo
&DeviceId=uni0340001122060134481927
&公共请求参数
返回示例:
国标ipc设备：
{
"RequestId": "5411eb02-5605-4789-9f9a-73cb38651add",
"Code": "0",
"Data": {
"DeviceId": "uni0340011122061452814105",
"Type": "ipc",
"Name": "测试设备ipc",
"GroupId": "uni0341122060286924475",
"GroupName": "测试国标空间",
"ParentId": "",
"MaxChannelNum": "0",
"ChannelId": "0",
"GbDeviceId": "12000000001320794353",
"PushUrl": "",
"UserName": "username",
"Password": "password",
"GbVersion": "2016",
"ManageStatus": "stop",
"Longitude": "12.21",
"Latitude": "21.12",
"DeviceIp": "10.0.0.1",
"DevicePort": "12345",
"DeviceSn": "12345",
"DeviceAddress": "测试设备地址",
"Description": "测试设备ipc",
"CreateTime": "2022-06-29T01:31:44Z",
"UpdateTime": "2022-06-29T01:47:39Z"
}
}
国标nvr设备：
{
"RequestId": "9de1b2f8-50b4-4629-ace3-a8d98dbc6c2e",
"Code": "0",
"Data": {
"DeviceId": "uni0340021122061775779565",
"Type": "nvr",
"Name": "nvr测试设备",
"GroupId": "uni0341122060286924475",
"GroupName": "测试国标空间",
"ParentId": "",
"MaxChannelNum": "16",
"ChannelId": "0",
"GbDeviceId": "12000000001180570947",
"PushUrl": "",
"UserName": "username",
"Password": "password",
"GbVersion": "2011",
"ManageStatus": "active",
"Longitude": "52.25",
"Latitude": "25.52",
"DeviceIp": "10.0.0.1",
"DevicePort": "4321",
"DeviceSn": "12345",
"DeviceAddress": "测试设备地址",
"Description": "nvr测试设备",
"CreateTime": "2022-06-29T01:35:24Z",
"UpdateTime": "2022-06-29T01:35:24Z",
"MaxChannelId": 1
}
}
国标channel设备(nvr)：
{
"RequestId": "fa66707e-ad7c-4b5d-b8b0-a0d5e3c9a9a9",
"Code": "0",
"Data": {
"DeviceId": "uni0340031122060938682400",
"Type": "channel",
"Name": "channel测试设备",
"GroupId": "uni0341122060286924475",
"GroupName": "测试国标空间",
"ParentId": "uni0340021122061775779565",
"MaxChannelNum": "0",
"ChannelId": "1",
"GbDeviceId": "12000000001320130360",
"PushUrl": "",
"UserName": "",
"Password": "",
"GbVersion": "",
"ManageStatus": "active",
"Longitude": "52.25",
"Latitude": "25.52",
"DeviceIp": "10.0.0.1",
"DevicePort": "4321",
"DeviceSn": "12345",
"DeviceAddress": "测试设备地址",
"Description": "channel测试设备",
"CreateTime": "2022-06-29T01:39:19Z",
"UpdateTime": "2022-06-29T01:39:19Z"
}
}
国标platform设备：
{
"RequestId": "edb4305f-ec44-482b-811b-6ff86cacf8c3",
"Code": "0",
"Data": {
"DeviceId": "uni0340041122070426267133",
"Type": "platform",
"Name": "测试级联设备0004",
"GroupId": "uni03411202109f70ec206",
"GroupName": "上海测试空间",
"ParentId": "",
"MaxChannelNum": "0",
"ChannelId": "0",
"GbDeviceId": "12000000002001000007",
"PushUrl": "",
"UserName": "username",
"Password": "password",
"GbVersion": "2011",
"ManageStatus": "active",
"Longitude": "",
"Latitude": "",
"DeviceIp": "",
"DevicePort": "",
"DeviceSn": "",
"Description": "测试级联设备0004",
"CreateTime": "2022-07-20T02:02:56Z",
"UpdateTime": "2022-07-25T08:52:55Z",
"SupportPtz": 1
}
}
国标channel设备(platform)：
{
"RequestId": "3c031c68-06a0-4a24-be54-201e5f3c33b9",
"Code": "0",
"Data": {
"DeviceId": "uni0340031122071116899151",
"Type": "channel",
"Name": "通道一",
"GroupId": "uni03411202109f70ec206",
"GroupName": "上海测试空间",
"ParentId": "uni0340041122070426267133",
"MaxChannelNum": "0",
"ChannelId": "0",
"GbDeviceId": "13050111091327000001",
"PushUrl": "",
"UserName": "",
"Password": "",
"GbVersion": "",
"ManageStatus": "stop",
"Longitude": "",
"Latitude": "",
"DeviceIp": "",
"DevicePort": "",
"DeviceSn": "",
"Description": "",
"CreateTime": "2022-07-21T11:34:58Z",
"UpdateTime": "2022-07-26T01:06:17Z",
"SupportPtz": 1,
"BusinessStatus": "0000"
}
}
rtmp空间下设备：
{
"RequestId": "419a430d-bc01-453c-a8f6-bd3468a1f019",
"Code": "0",
"Data": {
"DeviceId": "uni0340001122062015593783",
"Type": "ipc",
"Name": "rtmp测试设备",
"GroupId": "uni0341122060388608507",
"GroupName": "测试rtmp空间",
"ParentId": "",
"MaxChannelNum": "0",
"ChannelId": "0",
"GbDeviceId": "",
"PushUrl": "rtmp://rtmp.pushdomain.param/uni0341122060388608507/uni0340001122062015593783?token=d570bc2b7add08dfd7d0b7709eaa7455&time=1656468856",
"UserName": "",
"Password": "",
"GbVersion": "",
"ManageStatus": "active",
"Longitude": "52.25",
"Latitude": "25.52",
"DeviceIp": "10.0.0.1",
"DevicePort": "",
"DeviceSn": "12345",
"DeviceAddress": "测试设备地址",
"Description": "rtmp测试设备",
"CreateTime": "2022-06-29T01:42:19Z",
"UpdateTime": "2022-06-29T01:42:19Z"
}
} |
状态码 | 描述 |
|---|---|
200 | OK |
400 | Bad Request |
