文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>对象存储>SDK 文档>Python SDK>智能检索 MetaInsight>数据集管理>查询绑定关系列表

查询绑定关系列表

最近更新时间：2025-06-17 20:13:52

我的收藏

本页目录：

简介

本文档提供关于查询绑定关系列表的相关 API 概览以及 SDK 示例代码。
API
操作描述
查询绑定关系列表

功能说明

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

示例代码

from qcloud_cos import CosConfig
from qcloud_cos import MetaInsightClient
import os
import sys

# 替换为用户的 SecretId，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
secret_id = os.environ["SECRETID"]
# 替换为用户的 SecretKey，请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
secret_key = os.environ["SECRETKEY"]
# 替换为用户的 region，已创建桶归属的 region 可以在控制台查看，https://console.cloud.tencent.com/cos5/bucket
region = ('ap-beijing')
# COS 支持的所有 region 列表参见 https://www.qcloud.com/document/product/436/6224
token = None  # 如果使用永久密钥不需要填入 token，如果使用临时密钥需要填入，临时密钥生成和使用指引参见 https://cloud.tencent.com/document/product/436/14048
# 用户 appid 请登录访问管理控制台进行查看和管理，https://console.cloud.tencent.com/cam/capi
appid = '1250000000'

config = CosConfig(Appid=appid, Region=region, SecretId=secret_id,
                   SecretKey=secret_key,
                   Token=token)  # 获取配置对象
client = MetaInsightClient(config)

def ci_describe_dataset_bindings():
    # 查询绑定关系列表

    response, data = client.ci_describe_dataset_bindings(
        DatasetName = "数据集名称",
        MaxResults = 100,
        NextToken = "下一页",
        ContentType="application/json"
    )
    print(response)
    print(data)
    return response, data

参数说明

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

返回结果说明

response 为响应头，data 为响应结果，数据类型都为 dict。

response 内容

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

响应体 data

响应体具体数据内容如下：
参数名称
参数描述
类型
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

中国站
目录