列出数据集

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

我的收藏

简介

本文档提供关于列出数据集的相关 API 概览以及 SDK 示例代码。
API
操作描述
列出数据集

功能说明

获取数据集(Dataset)列表。

示例代码

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_datasets():
# 列出数据集

response, data = client.ci_describe_datasets(
MaxResults = 100,
NextToken = "下一页",
Prefix = "数据集前缀",
ContentType="application/json"
)
print(response)
print(data)
return response, data

参数说明

调用 ci_describe_datasets 函数,具体请求参数如下:
参数名称
参数描述
类型
是否必填
MaxResults
本次返回数据集的最大个数,取值范围为0~200。不设置此参数或者设置为0时,则默认值为100。
Integer
NextToken
翻页标记。当文件总数大于设置的 MaxResults 时,用于翻页的 Token。从 NextToken 开始按字典序返回文件信息列表。填写上次查询返回的值,首次使用时填写为空。
String
Prefix
数据集名称前缀。
String

返回结果说明

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

response内容

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

响应体data

响应体具体数据内容如下:
参数名称
参数描述
类型
RequestId
请求 ID。
String
Datasets
数据集信息。
Container Array
NextToken
翻页标记。当任务列表总数大于设置的 MaxResults 时,用于翻页的 Token。符合条件的任务列表未全部返回时,此参数才有值。下一次列出任务列表时将此值作为 NextToken 传入,将后续的任务列表返回。
String
Datasets 节点内容:
参数名称
参数描述
类型
Region
园区信息。
String
TemplateId
检索模板。
String
Description
数据集描述信息。
String
CreateTime
数据集创建时间的时间戳,格式为 RFC3339Nano。
String
UpdateTime
数据集修改时间的时间戳,格式为 RFC3339Nano。
创建数据集后,如果未更新过数据集,则数据集修改时间的时间戳和数据集创建时间的时间戳相同。
String
BindCount
数据集当前绑定的 COS Bucket 数量。
Integer
FileCount
数据集中已建立元数据索引的文件数量,存在10分钟延迟,如需查看最新数据请使用查询数据集接口。
Integer
TotalFileSize
数据集中已建立元数据索引的文件总大小,单位为字节,存在10分钟延迟,如需查看最新数据请使用查询数据集接口。
Integer
DatasetName
数据集名称。
String