更新时间:2024-04-22 GMT+08:00

获取视频源分组列表

功能介绍

获取视频源分组列表

URI

GET /v2/{project_id}/video-group/groups

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

用户项目ID,获取方法参见获取项目ID和名称

最大长度:64

表2 Query参数

参数

是否必选

参数类型

描述

sort_name

String

排序项。可选,可选值(create_at、modify_at、num_video_source、num_task)

缺省值:create_at

order_by

String

排序顺序,可选,默认倒序,可选值(desc、asc)

缺省值:desc

is_paged

Boolean

是否分页

缺省值:false

page_size

Integer

分页每页显示的条目

最小值:5

最大值:200

缺省值:10

page_num

Integer

第几页

最小值:1

最大值:100000

缺省值:1

name

String

模糊查找参数,可以按分组名称进行模糊查找

最大长度:20

status

String

状态level筛选,可选值(1、2、9)

access_type

Array

根据接入方式筛选(可多选),可选值(cloud、edge)

has_task

Boolean

是否有批量作业

缺省值:false

type

Array

视频源类型筛选(可多选)类型:obs、vcn、url、restful、camera

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,获取方法参见认证鉴权

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

video_group_number

Integer

分组数量

total_number

Integer

视频源分组总数

quota_number

Integer

视频源分组最大限额

video_group_list

Array of VideoGroupListInfoDto objects

分组列表

表5 VideoGroupListInfoDto

参数

参数类型

描述

video_group_id

String

视频源分组id

video_group_name

String

视频源分组名称

num_video_source

Integer

视频源数量

group_status

GroupStatusDto object

分组中视频源状态

access_type

String

接入方式

create_at

Long

创建时间

modify_at

Long

最后一次修改时间

num_batch_task

Integer

已配置批量作业数量

type

String

分组中视频源类型

表6 GroupStatusDto

参数

参数类型

描述

num_online

Integer

在线视频源数量

num_exception

Integer

异常视频源数量

num_offline

Integer

离线视频源数量

请求示例

获取视频源分组列表,展示出账户下的所有视频源分组信息

/v2/{project_id}/videoGroup/groups?is_paged=true&page_size=10&page_num=1

https://{endpoint}/v2/{project_id}/videoGroup/groups?is_paged=true&page_size=10&page_num=1

响应示例

状态码: 200

视频源分组列表响应体

{
  "video_group_number": 23,
  "total_number": 23,
  "quota_number": 200,
  "video_group_list": [
    {
      "video_group_id": "a9334780-a53c-454e-a3c1-259c54678ec1",
      "video_group_name": "test000",
      "num_video_source": 2,
      "group_status": {
        "num_online": 2,
        "num_exception": 0,
        "num_offline": 0
      },
      "access_type": "cloud",
      "create_at": 1680773327730,
      "modify_at": 1680773463291,
      "num_batch_task": 0,
      "type": "restful"
    }
}

状态码

状态码

描述

200

视频源分组列表响应体

错误码

请参见错误码