一、授权说明
通过子账号使用时，需要在 授权策略 的 action 中添加 ci:CreateDatasetBinding权限。数据万象支持的所有操作接口请参见 CI action。
二、限制说明
·每个数据集可绑定的最大个数为10。
·目前仅支持绑定北京、上海地域的存储桶到数据集上。
·COS 加密桶的文件无法被读取并创建元数据索引。
·不支持跨账号的 COS 桶，仅支持绑定本账号下的 COS 桶。
三、请求示例
POST /datasetbinding HTTP/1.1Host: <AppId>.ci.<Region>.myqcloud.comAuthorization: Auth StringContent-Length: 123Content-Type: application/jsonAccept: application/json
注意：说明：
注意：Authorization：携带鉴权信息，用于验证请求的合法性的请求头，详情请参见 请求签名 文档。
四、请求头
此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。
五、请求体
{ "DatasetName": "test", "URI": "cos://examplebucket-1250000000/test_data", "Mode": 0}
六、请求参数
| 参数名称 | 描述 | 类型 | 是否必选 |
| DatasetName | 数据集名称，同一个账户下唯一，可通过 控制台 或 接口 查询 | String | 是 |
| URI | 资源标识字段，表示需要与数据集绑定的资源，当前支持 COS 存储桶及桶内的目录，可添加 prefix 进行目录绑定；字段规则：cos://<BucketName>/prefix，其中 BucketName 表示 COS 存储桶名称，例如：cos://examplebucket-1250000000，可直接绑定某存储桶；亦可以添加 prefix，prefix 代表了某个路径，例如：cos://examplebucket-1250000000/test_data | String | 是 |
| Mode | 建立绑定后，以何种方式进行文件索引特征的提取，取值如下：0：表示仅对增量文件建立索引1：表示在对增量文件建立索引的同时对存储桶中存量文件建立索引，存量文件索引建立的时长与存量文件数有关默认值为0 | Integer | 否 |
七、响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
八、响应体
{ "Binding": { "DatasetName": "test", "URI": "cos://examplebucket-1250000000/test_data", "State": "Running", "StockState": "Indexing", "CreateTime": "2025-04-09T19:38:08.454310276+08:00", "UpdateTime": "2025-04-09T19:38:08.454310276+08:00" }, "RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"}
响应包体具体数据内容如下：
| 参数名称 | 类型 | 描述 |
| Binding | Container | 绑定信息 |
| RequestId | String | 请求 ID |
Binding 节点内容：
| 参数名称 | 类型 | 描述 |
| DatasetName | String | 数据集名称 |
| URI | String | 资源标识字段，表示需要与数据集绑定的资源，当前支持 COS 存储桶及桶内的目录，可添加 prefix 进行目录绑定；字段规则：cos://<BucketName>/prefix，其中 BucketName 表示 COS 存储桶名称，例如：cos://examplebucket-1250000000，可直接绑定某存储桶；亦可以添加 prefix，prefix 代表了某个路径，例如：cos://examplebucket-1250000000/test_data |
| State | String | 数据集和 COS Bucket 绑定关系的状态，取值为：Running：绑定关系运行中 |
| StockState | String | 当前绑定的存储桶对应的存量索引的状态，取值如下：NoIndexing：未进行存量建立索引Indexing：存量索引建立中Success：存量索引已建立完成 |
| CreateTime | String | 数据集和 COS Bucket 绑定关系创建时间的时间戳，格式为 RFC3339Nano |
| UpdateTime | String | 数据集和 COS Bucket 的绑定关系修改时间的时间戳，格式为 RFC3339Nano创建绑定关系后，如果未暂停或者未重启过绑定关系，则绑定关系修改时间的时间戳和绑定关系创建时间的时间戳相同 |