文档首页 > > API参考> API> 设备管理> 更新GB28181设备通道接入策略

更新GB28181设备通道接入策略

分享
更新时间: 2019/09/03 16:30

功能介绍

该接口用于设置GB28181设备的视频接入策略。用户可以通过设置接入策略定时自动进行设备的接入。

URI

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

    参数

    是否必选

    类型

    说明

    project_id

    String

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

    device_id

    String

    设备ID。

    channel_id

    String

    通道ID。

请求

  • 请求样例
    PUT /v1/3266392d188c47d09948b1859f0a5e07/devices/93390842351320000001/channels/ 93390842351320000001/access-strategy
    {
         "start_time": "10:00",
         "end_time": "18:00",
         "total_length": 240,
         "random_strategy": "RANDOM",
         "periodicity": "DAY",
         "state": "STOPPED"
    }
  • 参数说明

    参数

    是否必选

    类型

    说明

    random_strategy

    String

    视频采集类型,可选值为:

    • RANDOM:表示使用随机采集方法。在开始时间和结束时间内,随机采集总时长为total_length参数值的视频。

      详见随机策略(RANDOM)说明

    • CONSECUTIVE:表示从开始时间连续采集时长为total_length参数值的视频。

    默认值为RANDOM,不区分大小写。

    start_time

    String

    一天中视频接入的开始时间,时间格式为HH:MM,取值范围是00:10~23:40。分钟数值须为10的倍数,例如10:10、10:20、10:30等。

    第一次设置接入测略时,该参数必填。后续更新接入策略时,该参数可选。

    end_time

    String

    一天中视频接入的结束时间,时间格式为HH:MM,取值范围是00:10~23:50。分钟数值须为10的倍数,如23:10、23:20等。

    end_time必须晚于start_time。

    • 第一次设置视频采集类型为RANDOM时,该参数必填。后续更新接入策略时,该参数可选
    • 采集类型为CONSECUTIVE时,该参数被忽略。

    total_length

    Integer

    视频接入总采集时长,单位:分钟。

    参数值须为10的倍数,最小值为10分钟,最大值根据用户的配额决定。不同的视频采集类型,total_length有不同的配额设置:

    • 采集类型为RANDOM时,start_time加上total_length后的时间不能超过end_time。
    • 采集类型为CONSECUTIVE时,start_time加上total_length后的时间不能超过24:00,即采集时长不允许跨天。

    第一次设置接入测试略时,该参数必填。后续更新接入策略时,该参数可选。

    periodicity

    String

    采集周期,可选值为:

    • ONCE:表示采集一次。
    • DAY:表示每天执行。

    默认值为DAY,不区分大小写。

    state

    String

    视频接入状态,可选值为:

    • ACTIVE:表示激活当前视频接入策略。
    • STOPPED:表示停止当前视频接入策略。

    默认值为STOPPED,不区分大小写。

  • 随机策略(RANDOM)说明:
    1. 一天内从start_time到end_time的时间,会随机分成若干个时间分片(总分片个数不超过6个),每个时间分片最短为10min,最长不超过total_length时间,每两个时间分片之间的间隔至少为20min。
    2. 如果设置为每天执行采集(即“periodicity”“DAY”),每天的时间分片会重新随机生成,以保证每天接入的时间分片不同。
    3. 如果更新了接入策略(例如修改了start_time、total_length等参数),并且当前接入策略运行状态为ACTIVE,则会重新生成分片,其中分片开始时间早于当前时间的不会在当天执行,分片开始时间晚于当前时间的会在当天执行。

响应

  • 成功时,响应样例:
    {
         "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

提交反馈 取消

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

跳转到云社区