# 创建视频源分组 - CreateVideoGroup
#### 功能介绍
创建视频源分组。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/VIAS/doc?api=CreateVideoGroup)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
POST /v2/{project_id}/video-group
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                      |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 用户项目ID，获取方法参见[获取项目ID和名称](https://support.huaweicloud.com/api-vias/vias_03_0283.html)。 **约束限制：** 不涉及。 **取值范围：** 字符串长度\[0, 32\]。 **默认取值：** 不涉及。 |
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                     |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token，获取方法参见[认证鉴权](https://support.huaweicloud.com/api-vias/vias_03_0009.html)。 **约束限制：** 不涉及。 **取值范围：** 字符串长度\[0, 32768\]。 **默认取值：** 不涉及。 |
   
表3请求Body参数 
| 参数               | 是否必选 | 参数类型             | 描述                                                                                                                         |
|:---|:---|:---|:---|
| video_group_name | 是    | String           | **参数解释：** 视频源分组名称。 **约束限制：** 不涉及。 **取值范围：** 只能由中文、小写英文字母(a\~z)、大写英文字母(A\~Z)、数字(0\~9)组成, 长度范围为\[1, 20\]。 **默认取值：** 不涉及。     |
| description      | 否    | String           | **参数解释：** 视频源分组描述。 **约束限制：** 不涉及。 **取值范围：** 字符串长度\[0, 100\]。 **默认取值：** 不涉及。                                                |
| 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 | **参数解释：** 错误参数列举。 **取值范围：** 列表长度\[0, 1\]。 |
| reason     | String           | **参数解释：** 错误原因。 **取值范围：** 不涉及。            |
| advice     | String           | **参数解释：** 建议。 **取值范围：** 不涉及。              |
   
**状态码：500**
表6响应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_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 | 内部错误。 |