列出异步导出任务

最近更新时间:2025-07-01 16:08:22

我的收藏

功能描述

查询智能检索的异步导出任务列表。

授权说明

通过子账号使用时,需要在 授权策略 的 action 中添加 ci:ListDatasetExport 权限,数据万象支持的所有操作接口请参见 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": [
{
"CreateTime": "2025-04-07T17:07:33+08:00",
"EndTime": "1970-01-01T00:00:00+08:00",
"JobId": "bd83b246138f11f0941052540006042a",
"Name": "demo",
"Output": {
"Bucket": "test-1250000000",
"Object": "test",
"Region": "ap-beijing"
},
"Query": {
"Field": "ContentType",
"Operation": "eq",
"SubQueries": [],
"Value": "image/jpeg"
},
"StartTime": "1970-01-01T00:00:00+08:00",
"State": "todo"
}
],
"NextToken": "",
"RequestId": "NjdmNjVkMjZfNzM0NjZjMTxxxxxxxxxx"
}
响应包体具体数据内容如下:
参数名称
类型
描述
RequestId
String
请求 ID
Jobs
Container Array
异步导出任务的列表
NextToken
String
当任务总数大于设置的 MaxResults 时,用于翻页的 token。下一次列出任务时以此值为 NextToken,将未返回的结果返回。当任务未全部返回时,此参数才有值
Jobs 节点说明:请参见 创建异步导出任务 接口响应部分的 Job 字段说明。