修改设备信息。如果您需要添加NVR设备下的IPC,可以调用 CreateDevice并传入ParentId。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyDevice

系统规定参数。取值:ModifyDevice

DeviceId String 3200000099118700****

指定需要修改的设备ID

DeviceName String 某公司门口

所要修改的设备的名称,便于分类。

长度限制64位。

DeviceAddress String 某地市

修改后的设备所在的实际地址,至少需要您录入省份和市区。

长度限制64位。

设备安装地址修改不影响citycode和经纬度。

Longitude String 116.397128

经度。取值范围-180~180,小数最多6位。

Latitude String 39.916527

纬度。取值范围-90~90,小数最多6位。

DeviceDirection String 由内朝外

设备安装方向。

IPC 默认由内朝外。

长度限制64位。

DeviceSite String 东门门口

设备安装地点。

长度限制64位。

DeviceResolution String 1920*1080

设备分辨率,格式为“数字*数字”。

IPC默认1920*1080

DeviceRate String 4096

码率范围128-16384kbps,默认4096。

FrameRate String 25

设备支持的帧率。仅适用于IPC。

取值范围 1~100。默认25。

GovLength String 50

I帧间隔。仅适用于IPC。

取值范围5-250。

推荐为帧率两倍。

EncodeFormat String 6

视频或图片格式。仅适用于IPC。

枚举值:

3: MJPEG

6: H.264

13: H.265

默认6。

AudioEnable String 1

是否开启音频。仅适用于IPC。

取值范围:0 关闭; 1 打开。默认1。

OSDTimeEnable String 1

是否在画面上显示时间。仅适用于IPC。

取值范围:0 关闭; 1 打开。默认1。

OSDTimeType String 2

时间显示类型。仅适用于IPC。

取值范围:

0:YYYY-MM-DD 星期W HH:MM:SS;

1:DD-MM-YYYY星期W HH:MM:SS;

2:YYYY年MM月DD日 星期W HH:MM:SS;

3:MM月DD日YYYY年 星期W HH:MM:SS;

4:YYYY-MM-DD

OSDTimeX String 99

时间戳X像素坐标(可选),以播放窗口左上角像素为原点,水平向右为正。仅适用于IPC。

默认99。

OSDTimeY String 1

时间戳Y像素坐标(可选),以播放窗口左上角像素为原点,竖直向下为正。仅适用于IPC。

默认1。

Vendor String 阿里云

设备厂商,如阿里云等。

长度限制64位。

DeviceModel String ACube200-8

所要注册设备的型号,便于分类。

长度限制64位。

DeviceSubType String 1

1:标清固定摄像机

2:标清云台摄像机

3:高清固定摄像机

4:高清云台摄像机

199:视图库摄像机

DeviceIp String 192.168.XX.XX

设备IP。

注:仅针对IPC设备生效,其他设备不支持设置IP。

Password String ******

密码

返回数据

名称 类型 示例值 描述
RequestId String 46329898-489C-4E63-9BA1-C1DA5C5D0986

请求ID

Code String 200

错误码

Message String success

错误码描述

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyDevice
&DeviceId=3200000099118700****
&DeviceName=某公司门口
&DeviceAddress=某地市
&Longitude=116.397128
&Latitude=39.916527
&DeviceDirection=由内朝外
&DeviceSite=东门门口
&DeviceResolution=1920*1080
&DeviceRate=4096
&FrameRate=25
&GovLength=50
&EncodeFormat=6
&AudioEnable=1
&OSDTimeEnable=1
&OSDTimeType=2
&OSDTimeX=99
&OSDTimeY=1
&Vendor=阿里云
&DeviceModel=ACube200-8
&DeviceSubType=1
&DeviceIp=192.168.XX.XX
&Password=******
&公共请求参数

正常返回示例

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "46329898-489C-4E63-9BA1-C1DA5C5D0986",
  "Code" : "200",
  "Message" : "success"
}

错误码

访问错误中心查看更多错误码。