调用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"
}
错误码
访问错误中心查看更多错误码。