文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>数据万象>API 文档>智能检索 MetaInsight>查询与统计>查询结果异步导出>列出异步导出任务

列出异步导出任务

最近更新时间：2026-04-07 11:12:20

我的收藏

本页目录：

功能描述

本接口用于查询智能检索服务下，所有异步导出任务的信息列表。返回结果包括任务 ID、状态、创建时间、进度等详细信息，支持您集中监控和管理所有已提交的检索导出任务。如需查询单个任务可参见 查询异步导出任务。

授权说明

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

服务开通

首次使用该功能将默认为您开通数据万象，并绑定存储桶，无需角色授权，即可直接使用。
注意：
数据万象绑定后，如果您手动对存储桶进行数据万象的解绑操作，将无法继续使用该功能。

使用限制

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

请求

请求示例

GET /datasetquery/exports?datasetname=test&maxresults=20&nexttoken=xxxxxx HTTP/1.1
Host: <AppId>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: Auth String
Accept: application/json
说明：
Authorization: Auth String（详情请参见 请求签名 文档）。

请求头

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

请求参数

具体参数如下：
参数名称
描述
类型
是否必选
DatasetName
数据集名称，同一个账户下唯一
String
是
MaxResults
返回任务列表的最大个数，取值范围为0-200。不设置此参数或者设置为0时，则默认值为100
Integer
否
NextToken
当任务总数大于设置的 MaxResults 时，用于翻页的 token。从 NextToken 开始按字典序返回任务列表。第一次调用此接口时，设置为空
String
否

请求体

该请求无请求体。

响应

响应头

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

响应体

{
	"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-beijing"
		},
		"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"
}
响应包体具体数据内容如下：
参数名称
类型
描述
RequestId
String
请求 ID
Jobs
Container Array
异步导出任务的列表
NextToken
String
当任务总数大于设置的 MaxResults 时，用于翻页的 token。下一次列出任务时以此值为 NextToken，将未返回的结果返回。当任务未全部返回时，此参数才有值
Jobs 节点说明：请参见 创建异步导出任务 接口响应部分的 Job 字段说明。

中国站