简介
查询绑定关系列表功能是由 数据万象（Cloud Infinite，CI）提供的，数据万象将处理能力与 COS SDK 完全结合，您可以直接按照本篇文档指引进行使用。
本文档提供关于查询绑定关系列表的相关 API 概览以及 SDK 示例代码。
注意：
API | 操作描述 |
查询绑定关系列表 |
查询绑定关系列表
功能说明
查询数据集和对象存储（COS）Bucket 绑定关系列表。
方法原型
public DescribeDatasetBindingsResponse describeDatasetBindings(DescribeDatasetBindingsRequest customRequest)
请求示例
DescribeDatasetBindingsRequest request = new DescribeDatasetBindingsRequest();request.setAppId("1234567890");//设置数据集名称，同一个账户下唯一。;是否必传：是request.setDatasetname("数据集名称");//设置返回绑定关系的最大个数，取值范围为0~200。不设置此参数或者设置为0时，则默认值为100。;是否必传：否request.setMaxresults(100);//设置当绑定关系总数大于设置的MaxResults时，用于翻页的token。从NextToken开始按字典序返回绑定关系信息列表。第一次调用此接口时，设置为空。;是否必传：否request.setNexttoken("下一页");DescribeDatasetBindingsResponse response = client.describeDatasetBindings(request);
参数说明
Request： 中的具体数据描述如下：
参数名称 | 描述 | 类型 | 是否必传 |
AppId | String | 是 | |
datasetname | 数据集名称，同一个账户下唯一。 | String | 是 |
maxresults | 返回绑定关系的最大个数，取值范围为0~200。不设置此参数或者设置为0时，则默认值为100。 | Integer | 否 |
nexttoken | 当绑定关系总数大于设置的 MaxResults 时，用于翻页的 token。从 NextToken 开始按字典序返回绑定关系信息列表。第一次调用此接口时，设置为空。 | String | 否 |
响应参数说明：
DescribeDatasetBindingsResponse 中的具体数据描述如下：
参数名称 | 描述 | 类型 |
requestId | 请求 ID | String |
nextToken | 当绑定关系总数大于设置的 MaxResults 时，用于翻页的 token。下一次列出绑定关系信息时以此值为 NextToken，将未返回的结果返回。当绑定关系未全部返回时，此参数才有值。 | String |
bindings | 数据集和 COS Bucket 绑定关系信息的列表。 | Container Array |
Binding 中的具体数据描述如下：
参数名称 | 描述 | 类型 |
uRI | 资源标识字段，表示需要与数据集绑定的资源，当前仅支持 COS存 储桶，字段规则： cos://<BucketName>，其中 BucketName 表示 COS 存储桶名称，例如：cos://examplebucket-1250000000 | String |
state | 数据集和 COS Bucket 绑定关系的状态。取值范围如下： Running：绑定关系运行中。 | String |
createTime | 数据集和 COS Bucket 绑定关系创建时间的时间戳，格式为 RFC3339Nano。 | String |
updateTime | 数据集和 COS Bucket 的绑定关系修改时间的时间戳，格式为 RFC3339Nano。 创建绑定关系后，如果未暂停或者未重启过绑定关系，则绑定关系修改时间的时间戳和绑定关系创建时间的时间戳相同。 | String |
datasetName | 数据集名称。 | String |
返回结果说明
成功：返回 DescribeDatasetBindingsResponse 对象响应信息。
失败：发生错误（如 Bucket 不存在），抛出异常 CosClientException 或者 CosServiceException。详情请参见 异常处理。
