tencent cloud

Cloud Infinite

Listing Datasets

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

Feature Description

List datasets.

Authorization Description

When using a sub-account, add the ci:DescribeDatasets 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 /datasets?maxresults=2&prefix=test&nexttoken=xxxx HTTP/1.1
Host: <AppId>.ci.ap-jakarta.myqcloud.com
Date: <GMT Date>
Authorization: Auth String
Accept: application/json
Note:
Authorization: Auth String. For details, see Request Signature.

Request header

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

Request Parameter

Parameter Name
Description
Type
Required
maxresults
Maximum number of datasets to return. Value range: 0-200. If this parameter is not set or is set to 0, the default value is 100.
Long
No
nexttoken
Pagination marker. When the total number of files exceeds the specified MaxResults, this Token is used for pagination. Starting from NextToken, the file information list is returned in lexicographic order. Enter the value returned from the previous query. Leave this parameter empty for the first use.
String
No
prefix
Dataset name prefix
String
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

{
"Datasets": [{
"BindCount": 0,
"CreateTime": "2023-12-25 15:12:27.139749816 +0800 CST",
"DatasetName": "test001",
"Description": "test001",
"FileCount": 0,
"TemplateId": "Official:DefaultEmptyId",
"TotalFileSize": 0,
"UpdateTime": "2023-12-25 15:12:27.139749953 +0800 CST"
}, {
"BindCount": 0,
"CreateTime": "2023-12-25 15:07:00.331922722 +0800 CST",
"DatasetName": "test002",
"Description": "test002",
"FileCount": 0,
"TemplateId": "Official:COSBasicMeta",
"TotalFileSize": 0,
"UpdateTime": "2023-12-25 15:41:41.978447866 +0800 CST"
}],
"NextToken": "2:1251668577:test",
"RequestId": "NWFjMzQ0MDZfOTBmYTUwXzZkZV8z****"

}
The specific data content of the response body is as follows:
Parameter Name
Description
Type
Datasets
Dataset information. Same as the Dataset in the response body of the dataset creation API.
Container Array
NextToken
Pagination marker. When the total number of task lists exceeds the specified MaxResults, this parameter is the Token used for pagination. This parameter has a value only when not all task lists that meet the conditions have been returned. The next time you list task lists, pass this value as NextToken to return the subsequent task lists.
String
RequestId
Request ID.
String


도움말 및 지원

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

피드백