调用AddDataSource以创建一个数据源,通常代表一组图片,一组音视频文件,一组虚拟数据源(第三方视频接入平台生成的视频播放链接)等。创建成功后通过UploadFile向数据源中上传数据。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String AddDataSource

系统规定参数,取值:AddDataSource

CorpId String 252060345870948812*

项目标识(ID),通过“我的项目”创建VCS项目创建获取项目标识。

DataSourceName String PicDataSource

数据源名称。

DataSourceType String VIDEO

数据源类型音频数据源:AUDIO;视频数据源:VIDEO;实体设备:DEVICE;图片数据源:PIC

Description String DataSource for aliyun

数据源描述注释,方便后续维护数据来源。

Url String http://.......

类型为AUDIO或VIDEO时,必需

hls规则:

-http://a.b.d.c/x/y/z.m3u8?params...

-https://a.b.d.c/x/y/z.m3u8?params...

flv规则:

-http://a.b.d.c/x/y/z.flv?params...

-https://a.b.d.c/x/y/z.flv?params...

rtmp规则

-rtmp://a.b.d.c/x/y/z?params...

如果还没有创建项目,则您还没有CorpId参数,请先通过控制台界面或调用CreateCrop创建

返回数据

名称 类型 示例值 描述
Message String success

添加数据源返回消息。

Data Object

添加数据源返回信息。

KafkaTopic String audio_algo1585959481645918

分配kafka topic名称,通过kafka接入图片计算时需要用到此参数。

DataSourceId String ds_ddd12345675_1594196239688

数据源标识(ID)。

OssPath String audio_algo1585959481645918

分配OSS路径。计算保存在OSS里的图片时需要用到此参数。

Code String 200

错误码。200 :成功

RequestId String asbde-wefcse

请求ID,标识这次请求,如果出现问题,可以通过RequestId找到这次请求的相关记录来进行排错。

示例

请求示例

package main

import (
	openapi "github.com/alibabacloud-go/darabonba-openapi/client"
	"github.com/alibabacloud-go/tea/tea"
	vcs20200515 "github.com/alibabacloud-go/vcs-20200515/v3/client"
)

func CreateClient(accessKeyId string, accessKeySecret string) (client *vcs20200515.Client, err error) {
	config := &openapi.Config{
		// 您的AccessKey ID
		AccessKeyId: &accessKeyId,
		// 您的AccessKey Secret
		AccessKeySecret: &accessKeySecret,
	}
	// 访问的域名
	config.Endpoint = tea.String("vcs.cn-hangzhou.aliyuncs.com")
	client, err = vcs20200515.NewClient(config)
	return
}

func main() {
    client, err := CreateClient("<accessKeyId>", "<accessSecret>")
	if err != nil {
		panic(err)
	}
	addDataSourceRequest := &vcs20200515.AddDataSourceRequest{
		CorpId:         tea.String("4205000985250103552"),
		DataSourceName: tea.String("test"),
		DataSourceType: tea.String("VIDEO"),
		Description:    tea.String("test"),
		Url:            tea.String("rtmp://vec-space-test-1.aliyunvcs.cn/live/test1?auth_key=1640232029-0-0-d92f910ad2ce84c0e96e266584d5bb20"),
	}
	// 复制代码运行请自行打印 API 的返回值
	_, err = client.AddDataSource(addDataSourceRequest)
	if err != nil {
		panic(err)
	}
}

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<AddDataSourceResponse>
    <Message>success</Message>
    <Data>
        <KafkaTopic>audio_algo1585959481645918</KafkaTopic>
        <DataSourceId>ds_ddd12345675_1594196239688</DataSourceId>
        <OssPath>audio_algo1585959481645918</OssPath>
    </Data>
    <Code>200</Code>
    <RequestId>asbde-wefcse</RequestId>
</AddDataSourceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Message" : "success",
  "Data" : {
    "KafkaTopic" : "audio_algo1585959481645918",
    "DataSourceId" : "ds_ddd12345675_1594196239688",
    "OssPath" : "audio_algo1585959481645918"
  },
  "Code" : "200",
  "RequestId" : "asbde-wefcse"
}

错误码

访问错误中心查看更多错误码。