tencent cloud

Cloud Infinite

Querying Datasets

다운로드
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-09-08 16:24:27
AI 번역 및 품질 검수 완료

Feature Description

Query information about a Dataset.

Authorization Description

When using a sub-account, add the ci:DescribeDataset permission to the action of the authorization policy. For all APIs supported by Cloud Infinite, see CI action.

Use Limits

Before using this API, confirm the relevant restrictions. For details, see Usage Limits.

Request

Request sample

GET /dataset?datasetname=test&statistics=true HTTP/1.1
Host: <AppId>.ci.ap-jakarta.myqcloud.com
Date: <GMT Date>
Authorization: Auth String
Accept: application/json
Note:
Authorization: A request header that carries authentication information and is used to verify the legitimacy of the request. For details, see Request Signature.

Request header

This API only uses common request headers. For details, see Common Request Headers.

Request Parameters

Parameter Name
Description
Type
Required
datasetname
Dataset name. It is unique within the same account. You can query it through the console or the ListDatasets API.
String
Yes
statistics
This parameter specifies whether to immediately collect statistics on the latest data in the dataset, such as file quantity and size. Valid values are as follows. The default value is false.
false: Statistics are not collected immediately, and the total file size, file quantity, and other data returned by the API have a 10-minute delay.
true: Statistics are collected immediately, and the total file size, count, and other statistical data returned by the API are real-time. Collecting real-time data takes some time, so please wait patiently.
Boolean
No

Request body

This request has no request body.

Response

Response Headers

This API only returns common response headers. For details, see Common Response Headers.

Response Body

{
"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****"
}
The specific data content of the response body is as follows:
Parameter Name
Type
Description
RequestId
string
Request ID.
Dataset
Container
Dataset information. Same as the Dataset in the response body of the dataset creation API.

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백