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

查询数据集与存储桶的绑定关系

最近更新时间：2025-09-19 15:44:53

我的收藏

本页目录：

简介

本文档提供关于查询数据集与存储桶的绑定关系的相关 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_binding():
    # 查询数据集与存储桶的绑定关系

    response, data = client.ci_describe_dataset_binding(
        DatasetName = "数据集名称",
        Uri = "uri",
        ContentType="application/json"
    )
    print(response)
    print(data)
    return response, data

参数说明

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

返回结果说明

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

response 内容

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

响应体data

响应体具体数据内容如下：
参数名称
参数描述
类型
RequestId
请求 ID。
String
Binding
数据集和 COS Bucket 绑定关系信息的列表。
Container
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
中国站
目录