調用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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。