文档首页 > > API参考> API> 设备管理> 更新GB28181设备通道信息

更新GB28181设备通道信息

分享
更新时间:2020/09/21 GMT+08:00

功能介绍

该接口用于改变通道关联的视频流名称后缀,或者进行“视频邀约”“取消邀约”,以激活/断开GB28181设备的视频传输。

当设备处于UNREGISTERED(未注册)、ONLINE(未邀约)或OFFLINE(已下线)状态时,才可以修改视频流名称后缀。

URI

  • URI格式
    PUT /v1/{project_id}/devices/{device_id}/channels/{channel_id}
  • 参数说明

    参数

    是否必选

    类型

    说明

    project_id

    String

    项目ID,获取方法请参见获取项目ID

    device_id

    String

    设备ID。

    channel_id

    String

    通道ID。

请求消息

  • 请求样例
    PUT /v1/{project_id}/devices/device123123sadf/channels/chanadfasdf
    {
        "state": "ACTIVE"
    }
  • 参数说明

    参数

    是否必选

    类型

    说明

    state

    String

    视频流状态:

    • ACTIVE:进行视频邀约。
    • STOPPED:断开视频。

    不区分大小写。

    tcp_priority

    String

    是否优先使用TCP传输的配置。

    取值范围:TRUE、FALSE。

    • 当选择TRUE时,如果IPC设备支持TCP协议传输,通道进行视频邀约时优先使用TCP协议接入到VIS服务中。
    • 当选择FALSE时,IPC设备通道进行视频邀约时优先使用UDP协议接入到VIS服务中。

    NVR设备通道暂时不支持配置相关配置。

    默认值FALSE。

    suffix

    String

    设备通道关联的视频流名称后缀。当设备处于UNREGISTERED(未注册)、ONLINE(未邀约)或OFFLINE(已下线)状态时,才可以修改名称后缀。

    后缀长度为0位到30位之间(长度为0时表示不设置后缀),可以包含字母、数字、中划线(-)或者下划线(_),不能包含其他的特殊字符。

    说明:

    国标设备注册后,会自动创建与设备关联的视频流。视频流的名称可以添加suffix字段作为名称后缀,以帮助用户更好区分不同的视频流。

响应消息

  • 成功时,响应样例:
    {
         "result": "success"
    }
  • 失败时,返回如下参数:

    参数

    说明

    error_code

    错误码。

    error_msg

    错误消息,详见错误码说明

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。具体返回错误码请参考错误码说明

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源或没有开通服务。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问