tencent cloud

Cloud Infinite

DokumentasiCloud InfiniteAPI DocumentationIntelligent Search MetaInsightBasic SearchAsynchronous Export of Query ResultsListing Asynchronous Export Tasks

Listing Asynchronous Export Tasks

Unduh
Mode fokus
Ukuran font
Terakhir diperbarui: 2026-09-08 16:24:28
Diterjemahkan oleh AI

Feature Description

This API is used to query the information list of all asynchronous export tasks under the intelligent search service. The returned results include detailed information such as task ID, status, creation time, and progress, allowing you to centrally monitor and manage all submitted search export tasks. To query a single task, see Query Asynchronous Export Task.

Authorization Description

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

Service Activation

When you use this feature for the first time, Cloud Infinite is activated for you by default, and the Bucket is automatically bound. You can use the feature directly without role authorization.
Note:
After Cloud Infinite is bound, if you manually unbind Cloud Infinite from the bucket, you will no longer be able to use this feature.

Use Limits

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

Request

Request sample

GET /datasetquery/exports?datasetname=test&maxresults=20&nexttoken=xxxxxx 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 Parameters

The specific parameters are as follows:
Parameter Name
Description
Type
Required
DatasetName
Dataset name, unique within the same account
String
Yes
MaxResults
Maximum number of task lists to return. Value range: 0-200. If this parameter is not set or is set to 0, the default value is 100
Integer
No
NextToken
When the total number of tasks exceeds the specified MaxResults, this token is used for pagination. Starting from NextToken, the task list is returned in lexicographic order. Set this parameter to empty when calling this API for the first time
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

{
	"Jobs": [{
		"JobId": "xxxxxx",
		"Name": "fortest",
		"ExportJobType": 1,
		"Query": {
			"Operation": "and",
			"SubQueries": [{
					"Field": "ContentType",
					"Value": "image/jpeg",
					"Operation": "eq"
				},
				{
					"Field": "Size",
					"Value": "1000",
					"Operation": "gt"
				}
			]
		},
		"Output": {
			"Bucket": "test-1250000000",
			"Object": "prefix001",
			"Region": "ap-jakarta"
		},
		"CreateTime": "2025-04-09T19:38:08.454310276+08:00",
		"StartTime": "1970-01-01T00:00:00+08:00",
		"EndTime": "1970-01-01T00:00:00+08:00",
		"State": "todo",
		"GfsPreHeatConfig": {
			"ClusterId": "",
			"Priority": 1
		},
		"Progress": 0
	}],
	"NextToken": "",
	"RequestId": "NjdmNjVkMjZfNzM0NjZjMTxxxxxxxxxx"
}
The specific data content of the response body is as follows:
Parameter Name
Type
Description
RequestId
String
Request ID
Jobs
Container Array
List of asynchronous export tasks
NextToken
String
When the total number of tasks exceeds the specified MaxResults, this parameter is the token used for pagination. The next time you list tasks, use this value as NextToken to return the results that have not been returned. This parameter has a value only when not all tasks have been returned
Jobs node description: see the Job field description in the response section of the Create Asynchronous Export Task API.

Topik sebelumnya: Querying Asynchronous Export TasksTopik selanjutnya: Canceling an Asynchronous Export Task

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan

Search
    Enter keywords to search documentation