文档首页/ 视频智能分析服务 VIAS/ API参考/ 平台API/ 视频中心/ 更新视频源分组 - UpdateVideoGroup
更新时间:2025-12-18 GMT+08:00
分享

更新视频源分组 - UpdateVideoGroup

功能介绍

更新视频源分组。

调试

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

URI

PUT /v2/{project_id}/video-group/{video_group_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

video_group_id

String

参数解释:

已创建成功的视频源分组id。

约束限制:

不涉及。

取值范围:

只能由小写英文字母(a~z)、数字(0~9)、中划线(-)、下划线(_)组成长度范围是[4,36]。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

不涉及。

取值范围:

字符串长度[0, 32768]。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

video_group_name

String

参数解释:

视频源分组名称。如不传入则不修改名称。

约束限制:

不涉及。

取值范围:

只能由中文、中划线(-)、下划线(_)、英文字母(a~z)、数字(0~9)组成。长度范围为[1, 20]。

默认取值:

不涉及。

description

String

参数解释:

描述。如不传入则不修改描述。

约束限制:

不涉及。

取值范围:

字符串长度[0, 100]。

默认取值:

不涉及。

video_source_ids

Array of strings

参数解释:

分组中的视频源id集。

约束限制:

不涉及。

取值范围:

id个数需在1~50,每个id只能由小写英文字母(a~z,)、数字(0~9)、中划线(-)、下划线(_)组成。长度范围为[4, 36]。

默认取值:

不涉及。

响应参数

状态码:200

更新成功。

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息描述。

取值范围:

不涉及。

detail

String

参数解释:

错误详情。

取值范围:

不涉及。

params

Array of strings

参数解释:

错误参数列举。

取值范围:

列表长度[0, 1]。

reason

String

参数解释:

错误原因。

取值范围:

不涉及。

advice

String

参数解释:

建议。

取值范围:

不涉及。

状态码:500

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息描述。

取值范围:

不涉及。

detail

String

参数解释:

错误详情。

取值范围:

不涉及。

params

Array of strings

参数解释:

错误参数列举。

取值范围:

列表长度[0, 1]。

reason

String

参数解释:

错误原因。

取值范围:

不涉及。

advice

String

参数解释:

建议。

取值范围:

不涉及。

请求示例

修改视频源分组请求体

/v2/{project_id}/video-group/{video_group_id}

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

响应示例

状态码

状态码

描述

200

更新成功。

400

请求错误。

500

内部错误。

相关文档