对象存储 查询数据集

通过子账号使用时,需要在 授权策略 的 action 中添加 ci:DescribeDataset 权限。数据万象支持的所有操作接口。

相关产品
对象存储 产品页,含版本规格、价格与购买入口。

一、功能描述

查询一个数据集(Dataset)信息。

二、使用限制

使用该接口时,请先确认相关限制条件。详情请参见 使用限制。

三、请求示例

GET /dataset?datasetname=test&statistics=true HTTP/1.1Host: <AppId>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: Auth StringAccept: application/json

注意:说明:

注意:Authorization:携带鉴权信息,用于验证请求的合法性的请求头,详情请参见 请求签名 文档。

四、请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

五、请求参数

参数名称 描述 类型 是否必选
datasetname 数据集名称,同一个账户下唯一。可通过 控制台 或 接口 查询 String 是
statistics 该参数用于指定是否需要立即统计一次数据集中最新的文件数量、大小等数据,参数有效值如下,默认值为 false。false:不立即统计,接口返回的文件总大小、数量等数据存在10分钟的延迟true:立即统计,接口返回的文件总大小、数量等统计数据为实时统计的,统计实时数据需要一定时间,请耐心等待 Boolean 否

六、请求体

该请求无请求体。

七、响应头

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

八、响应体

{ "Dataset": { "BindCount": 0, "CreateTime": "2023-12-25 15:16:20.692674978 +0800 CST", "DatasetName": "test", "Description": "test", "FileCount": 0, "TemplateId": "Official:COSBasicMeta", "TotalFileSize": 0, "UpdateTime": "2023-12-25 15:16:20.692675128 +0800 CST" }, "RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"}

响应包体具体数据内容如下:

参数名称 类型 描述
RequestId string 请求 ID
Dataset Container 数据集信息。同创建数据集接口中响应体的 Dataset
赞 (0)
上一篇 4天前
下一篇 4天前