对象存储查询绑定关系列表

一、功能描述

查询数据集和对象存储（COS）Bucket 绑定关系列表。

二、授权说明

通过子账号使用时，需要在授权策略的 action 中添加 ci:DescribeDatasetBindings 权限。数据万象支持的所有操作接口请参见 CI action。

三、使用限制

使用该接口时，请先确认相关限制条件。详情请参见使用限制。

四、请求示例

GET /datasetbindings?datasetname=test&limit=100 HTTP/1.1Host: <AppId>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: Auth StringAccept: application/json

注意：说明：

注意：Authorization：携带鉴权信息，用于验证请求的合法性的请求头，详情请参见请求签名文档。

五、请求头

此接口仅使用公共请求头部，详情请参见公共请求头部文档。

六、请求参数

具体参数如下：

参数名称	描述	类型	是否必选
DatasetName	数据集名称，同一个账户下唯一。可通过控制台或接口查询。	String	是
MaxResults	返回绑定关系的最大个数，取值范围为0~200。不设置此参数或者设置为0时，则默认值为100。	Integer	否
NextToken	当绑定关系总数大于设置的 MaxResults 时，用于翻页的 token。从 NextToken 开始按字典序返回绑定关系信息列表。第一次调用此接口时，设置为空。	String	否

七、请求体

该请求无请求体。

八、响应头

此接口仅返回公共响应头部，详情请参见公共响应头部文档。

九、响应体

{ "Bindings": [{ "CreateTime": "2023-12-25 19:18:19.809729971 +0800 CST", "DatasetName": "test", "State": "Running", "URI": "cos://examplebucket1-1250000000", "UpdateTime": "2023-12-25 19:18:19.809730114 +0800 CST" }, { "CreateTime": "2023-12-25 19:18:19.809729971 +0800 CST", "DatasetName": "test", "State": "Running", "URI": "cos://examplebucket2-1250000000", "UpdateTime": "2023-12-25 19:18:19.809730114 +0800 CST" }], "NextToken": "2:1250000000:test", "RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"}

响应包体具体数据内容如下：

参数名称	类型	描述
Bindings	Container Array	数据集和 COS Bucket 绑定关系信息的列表。
NextToken	String	当绑定关系总数大于设置的 MaxResults 时，用于翻页的 token。下一次列出绑定关系信息时以此值为 NextToken，将未返回的结果返回。当绑定关系未全部返回时，此参数才有值。
RequestId	String	请求 ID。

Bindings 节点内容：

参数名称	类型	描述
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。创建绑定关系后，如果未暂停或者未重启过绑定关系，则绑定关系修改时间的时间戳和绑定关系创建时间的时间戳相同。
StockState	String	当前绑定的存储桶对应的存量索引的状态：有效值如下：NoIndexing：未进行存量建立索引。Indexing：存量索引建立中。Success：存量索引已建立完成。

对象存储 查询绑定关系列表