更新时间:2025-11-19 GMT+08:00
分享

创建视频源分组

功能介绍

创建视频源分组。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/video-group

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

表3 请求Body参数

参数

是否必选

参数类型

描述

video_group_name

String

视频源分组名称,只能由中文、小写英文字母(a~z)、大写英文字母(A~Z)、数字(0~9)组成, 长度范围为[1, 20]。

description

String

视频源分组描述。

access_type

String

接入方式,只能选择cloud 或者 edge。

video_source_ids

Array of strings

选中分组内视频源id列表,只能由小写英文字母(a~z,)、数字(0~9)、中划线(-)、下划线(_)组成, 长度范围为[4, 36]。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

video_group_id

String

视频源分组id。

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息描述。

detail

String

错误详情。

params

Array of strings

错误参数列举。

reason

String

错误原因。

advice

String

建议。

状态码:500

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息描述。

detail

String

错误详情。

params

Array of strings

错误参数列举。

reason

String

错误原因。

advice

String

建议。

请求示例

创建视频源分组请求体

/v2/{project_id}/video-group

{
  "video_source_ids" : [ "xxxxxxx-xxxxxxx-xxxxxxx-xxxxx-xxxxxx" ],
  "video_group_name" : "test000",
  "description" : "",
  "access_type" : "cloud"
}

响应示例

状态码:200

创建成功。

{
  "video_group_id" : "a9334780-a53c-454e-a3c1-259c54678ec1"
}

状态码

状态码

描述

200

创建成功。

400

请求错误。

500

内部错误。

相关文档