调用CreateBinding创建绑定任务_智能媒体管理-阿里云帮助中心

创建数据集（Dataset）和对象存储（OSS）Bucket的绑定关系，自动同步全量和增量文件并为其索引。

接口说明

请确保在使用该接口前，已充分了解 IMM 产品的收费方式和价格。

在创建绑定关系前，请确保已经创建对应的项目和数据集。

说明数据绑定将使用创建项目或数据集时所指定的工作流模板对文件进行处理。

绑定关系创建后，智能媒体管理（IMM）会先对对象存储（OSS） Bucket中的已有数据进行全量扫描，并抽取文件元数据信息进行索引。完成后，继续对 OSS中新增的文件进行准实时的增量追踪扫描、抽取以及索引。通过此方式为文件建立索引后，您可以使用文件查询API（例如SimpleQuery）对文件进行查询、管理和统计。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
ProjectName	string	是	项目名称，获取方式请参见创建项目。	test-project
DatasetName	string	是	数据集名称，获取方式请参见创建数据集。	test-dataset
URI	string	是	数据集绑定的对象存储（OSS） Bucket URI。对象存储（OSS） Bucket URI 的格式为oss://${Bucket}，其中`${Bucket}`为和当前项目处于同一地域的 OSS Bucket 名称。	oss://test-bucket

返回参数

名称	类型	描述	示例值
	object	响应结构体。
RequestId	string	请求ID。	5F74C5C9-5AC0-49F9-914D-E01589D3****
Binding	Binding	绑定信息。

示例

正常返回示例

JSON格式

{
  "RequestId": "5F74C5C9-5AC0-49F9-914D-E01589D3****",
  "Binding": {
    "ProjectName": "immtest",
    "DatasetName": "dataset001",
    "URI": "oss://examplebucket",
    "State": "Running",
    "Phase": "FullScanning",
    "Detail": "已暂停。",
    "CreateTime": "2021-06-29T14:50:13.011643661+08:00",
    "UpdateTime": "2021-06-29T14:50:13.011643661+08:00"
  }
}

错误码

HTTP status code	错误码	错误信息
400	param_error	Param error
404	not_found	The resource can not be found

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

变更历史

变更时间	变更内容概要	操作
2021-06-15	新增 OpenAPI