修改设备配置
所有文档

          智能视联网平台 EVS

          修改设备配置

          接口描述

          本接口用于修改EVS设备配置。

          请求(Request)

          请求URI

          PUT /v1/device/{deviceId}

          参数名称 类型 是否必需 描述
          deviceId Long 设备ID

          请求头域

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

          请求体

          参数名称 类型 是否必需 描述
          deviceName String 设备名称,最大长度256个字符
          deviceStreamId String 当type=RTMP时必填;该字段即app/stream的拼接,最大长度256个字符
          description String 设备描述,最大长度512个字符
          recording Object 录制配置
          + sameAsSpace Boolean 是否和空间一致,为true时表示和空间保持一致
          + enabled Object 是否开启录制
          + bucket String 边缘存储bucket
          + duration Integer 录制单文件时长,单位:秒
          + format String 存储格式,可选:MP4、FLV、M3U8
          + authEnabled Boolean 录制文件下载地址是否开启鉴权
          + authExpire Integer 鉴权URL有效时间,单位:秒
          thumbnail Object 截图配置
          + enabled Boolean 是否开启截图
          + bucket String 边缘存储bucket
          + interval Integer 截图周期,单位:秒
          + authEnabled Boolean 截图文件下载地址是否开启鉴权
          + authExpire Integer 鉴权URL有效时间,单位:秒
          gis Object 地理位置配置,当「人员轨迹分析」应用绑定此空间设备时,要求空间下所有设备已设置gis信息
          + longitude Float 经度,范围[-180, 180]
          + latitude Float 经度,范围[-90, 90]
          + name String 地理位置名称

          响应(Response)

          响应头域

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

          响应体

          无。

          示例

          请求示例

          PUT /v1/device/1000001 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
          
          {
            "deviceName": "evs_device_name",
            "description": "evs_device_description",
            "recording": {
                  "sameAsSpace": true
            },
            "thumbnail": {
                  "enabled": true,
                  "bucket": "evs_bucket",
                  "interval": 10,
                  "authEnabled": true,
                  "authExpire": 3600
            }
          }

          响应示例

          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

          错误码

          错误码(code) 消息(message) 描述 HTTP状态码
          DeviceOperationNotPermitted device operation not permitted for space is not running, space id : XXX 当前空间未就绪,不允许创建设备 403
          DeviceAlreadyExist device already exist, device name : XXX 更新的设备名称已经存在 400
          RequestArgumentIllegal update device argument illegal 更新设备的请求参数不合法 400
          上一篇
          删除设备
          下一篇
          查询设备