文档首页 > > API参考> API> 设备管理> 创建GB28181设备通道

创建GB28181设备通道

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

功能介绍

此接口用于创建GB28181设备(摄像头、网络硬盘录像机等)通道。

创建成功之后,自动为GB28181设备生成设备ID,以及选择关联的GB28181凭证。用户在设备注册时使用该设备ID与凭证,作为设备的用户名以及认证ID。

URI

  • URI格式
    POST /v1/{project_id}/devices
  • 参数说明

    参数

    是否必选

    类型

    说明

    project_id

    String

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

请求

  • 请求样例
    POST /v1/6204a5bd270343b5885144cf9c8c158d/devices
    {
        "type": "IPC",
        "username": "0100",
        "quantity": 2,
        "suffix": "abc",
        "description": "description for device"
    }
  • 参数说明

    参数

    是否必选

    类型

    说明

    type

    String

    设备类型,目前仅支持IPC和NVR类型的设备,不区分大小写。

    username

    String

    关联的GB28181设备密码对应的用户名。

    quantity

    Integer

    创建设备的个数。最小值为1,最大值为用户当前可以创建设备的剩余配额,不填该参数时默认值为1。

    description

    String

    设备的描述,可填字符串最大长度为500。

    suffix

    String

    设备通道关联的视频流名称后缀。

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

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

响应

  • 响应样例
    {
        "device_id_list": ["34020000001300000001", "34020000001300000002"]
    }
  • 返回设备ID列表

    参数

    类型

    说明

    device_id_list

    Array of strings

    创建成功的设备ID列表。

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

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

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

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

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

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

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区