一、功能描述
查询一个数据集(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 |