数据万象绑定存储桶与数据集-API 文档-文档中心-腾讯云

功能描述
将一个对象存储（COS）存储桶绑定到数据集（Dataset）上。绑定后，将对存储桶中新增的文件进行准实时的增量追踪扫描，依据数据集的检索模板对文件进行处理，抽取文件的元数据进行索引。通过此方式为文件建立元数据索引后，您可以使用智能检索的查询接口进行数据的查询统计。
授权说明
授权策略中 action 设置为 ci:CreateDatasetBinding，详情请参见 数据万象 action。
限制说明
每个数据集绑定的最大个数为10。
目前仅支持绑定北京地域的存储桶到数据集上。
请求
请求示例
POST /datasetbinding HTTP/1.1
Host: <AppId>.ci.<Region>.myqcloud.com
Authorization: Auth String
Content-Length: xxx
Content-Type: application/json
Accept: application/json
说明：
Authorization: Auth String（详情请参见 请求签名 文档）。
通过子账号使用时，需要授予相关的权限，详情请参见 授权粒度详情 文档。
请求头
此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。
请求体
{
    "DatasetName": "test",
    "URI": "cos://examplebucket-1250000000"
}
请求参数
参数名称
描述
类型
是否必选
DatasetName
数据集名称，同一个账户下唯一。
String
是
URI
资源标识字段，表示需要与数据集绑定的资源，当前仅支持 COS 存储桶，字段规则：cos://<BucketName>，其中 BucketName 表示 COS 存储桶名称，例如：cos://examplebucket-1250000000。
String
是
响应
响应头
此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。
响应体
{
    "Binding": {
        "CreateTime": "2023-12-25 19:19:32.751303843 +0800 CST m=+272347.749940194",
        "DatasetName": "test",
        "State": "Running",
        "URI": "cos://examplebucket-1250000000",
        "UpdateTime": "2023-12-25 19:19:32.751303991 +0800 CST m=+272347.749940332"
    },
    "RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"
}
响应包体具体数据内容如下：
参数名称
类型
描述
Binding
Container
绑定信息。
RequestId
String
请求 ID。
Binding 节点内容：
参数名称
类型
描述
CreateTime
String
数据集和 COS Bucket 绑定关系创建时间的时间戳，格式为 RFC3339Nano。
DatasetName
String
数据集名称。
State
String
数据集和 COS Bucket 绑定关系的状态。取值范围如下：
Running：绑定关系运行中。
URI
String
资源标识字段，表示需要与数据集绑定的资源，当前仅支持 COS 存储桶，字段规则：cos://<BucketName>，其中 BucketName 表示 COS 存储桶名称，例如：cos://examplebucket-1250000000。
UpdateTime
String
数据集和 COS Bucket 的绑定关系修改时间的时间戳，格式为 RFC3339Nano。
创建绑定关系后，如果未暂停或者未重启过绑定关系，则绑定关系修改时间的时间戳和绑定关系创建时间的时间戳相同。
﻿

参数名称	描述	类型	是否必选
DatasetName	数据集名称，同一个账户下唯一。	String	是
URI	资源标识字段，表示需要与数据集绑定的资源，当前仅支持 COS 存储桶，字段规则：`cos://<BucketName>`，其中 BucketName 表示 COS 存储桶名称，例如：`cos://examplebucket-1250000000`。	String	是

绑定存储桶与数据集

本页目录：

功能描述

授权说明

限制说明

请求

请求示例

请求头

请求体

请求参数

响应

响应头

响应体