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

创建视频源

功能介绍

创建视频源

URI

POST /v2/{project_id}/source

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

最大长度:64

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

表3 请求Body参数

参数

是否必选

参数类型

描述

video_source_name

String

视频源名称,只支持中文、英文字母(a-z,A-Z)、数字、特殊字符(空格.-_() ()),不能以空格开头和结尾

最小长度:1

最大长度:100

access_type

String

接入类型(cloud、edge)

type

String

类型:obs、vcn、url、restful、camera

latitude

String

视频源的地理位置信息,纬度,-90.00000~90.00000

longitude

String

视频源的地理位置信息,经度,-180.00000~180.00000

video_group_ids

Array of strings

系统中所有的视频源分组,只能由小写英文字母(a~z)、数字(0~9)、中划线(-)、下划线(_)组成, 长度范围为[4, 36]

type_config

String

视频源配置信息xml url形式: <type>URL</type> <config> <URL_ADDRESS></URL_ADDRESS> </config> vcn形式: <type>VCN</type> <config> <DATA_SOURCE_ID></DATA_SOURCE_ID> <STREAM_TYPE></STREAM_TYPE> <IP></IP> <PORT></PORT> <USER_NAME></USER_NAME> <PASSWORD></PASSWORD> </config> restful形式: <type>RESTFUL</type> <config> <HTTP_CHECK></HTTP_CHECK> <URL></URL> <RTSP_URL></RTSP_URL> </config> camera形式: <type>CAMERA</type> <config> <EDGE_CAMERA_ID></EDGE_CAMERA_ID> </config>

最大长度:1024

tag

Array of strings

视频源标签,标签最多选择4个,标签内容只能由中文, 英文字母(a~z, A~Z)、数字(0~9)、中划线(-)、下划线(_)组成, 最小长度:1 最大长度:10

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

video_source_id

String

视频源id

请求示例

创建视频源请求体

/v2/{project_id}/source/sources/{video_source_id}

{
  "video_source_name" : "url_test",
  "access_type" : "cloud",
  "type" : "url",
  "longitude" : "",
  "latitude" : "",
  "tag" : [ ],
  "video_group_ids" : [ ],
  "type_config" : "<type_config>        <url_address>rtsp://12.12.12.12:333</url_address>      </type_config>"
}

响应示例

状态码: 200

视频源信息

{
  "video_source_id" : "xxxxxxx-xxxxxxx-xxxxxxx-xxxxx-xxxxxx"
}

状态码

状态码

描述

200

视频源信息

错误码

请参见错误码