简介
本文档提供关于查询数据集的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
查询数据集 |
功能说明
查询一个数据集(Dataset)信息。
示例代码
from qcloud_cos import CosConfigfrom qcloud_cos import MetaInsightClientimport osimport sys# 替换为用户的 SecretId,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capisecret_id = os.environ["SECRETID"]# 替换为用户的 SecretKey,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capisecret_key = os.environ["SECRETKEY"]# 替换为用户的 region,已创建桶归属的 region 可以在控制台查看,https://console.cloud.tencent.com/cos5/bucketregion = ('ap-beijing')# COS 支持的所有 region 列表参见 https://www.qcloud.com/document/product/436/6224token = None # 如果使用永久密钥不需要填入 token,如果使用临时密钥需要填入,临时密钥生成和使用指引参见 https://cloud.tencent.com/document/product/436/14048# 用户 appid 请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capiappid = '1250000000'config = CosConfig(Appid=appid, Region=region, SecretId=secret_id,SecretKey=secret_key,Token=token) # 获取配置对象client = MetaInsightClient(config)def ci_describe_dataset():# 查询数据集response, data = client.ci_describe_dataset(DatasetName = "数据集名称",Statistics = "",ContentType="application/json")print(response)print(data)return response, data
参数说明
调用 ci_describe_dataset 函数,具体请求参数如下:
参数名称 | 参数描述 | 类型 | 是否必填 |
DatasetName | 数据集名称,同一个账户下唯一。 | String | 是 |
Statistics | 该参数用于指定是否需要立即统计一次数据集中最新的文件数量、大小等数据,参数有效值: false:不立即统计,接口返回的文件总大小、数量等数据存在10分钟的延迟。 true:立即统计,接口返回的文件总大小、数量等统计数据为实时统计的,统计实时数据需要一定时间,请耐心等待。 默认值为 false。 | boolean | 否 |
返回结果说明
response 为响应头,data 为响应结果,数据类型都为 dict。
response 内容
响应体 data
响应体具体数据内容如下:
参数名称 | 参数描述 | 类型 |
RequestId | 请求 ID。 | String |
Dataset | 数据集信息。 | Container |
Dataset 节点内容:
参数名称 | 参数描述 | 类型 |
Region | 园区信息。 | String |
TemplateId | 模板 ID。 | String |
Description | 数据集描述信息。 | String |
CreateTime | 数据集创建时间的时间戳,格式为 RFC3339Nano。 | String |
UpdateTime | 数据集修改时间的时间戳,格式为 RFC3339Nano。 创建数据集后,如果未更新过数据集,则数据集修改时间的时间戳和数据集创建时间的时间戳相同。 | String |
BindCount | 数据集当前绑定的 COS Bucket 数量。 | Integer |
FileCount | 数据集当前文件数量。 | Integer |
TotalFileSize | 数据集中当前文件总大小,单位为字节。 | Integer |
DatasetName | 数据集名称。 | String |