对象存储 列出异步导出任务

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

相关产品
对象存储 产品页,含版本规格、价格与购买入口。

一、授权说明

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

二、服务开通

首次使用该功能将默认为你开通数据万象,并绑定存储桶,无需角色授权,即可直接使用。

注意:数据万象绑定后,如果你手动对存储桶进行数据万象的解绑操作,将无法继续使用该功能。

三、使用限制

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

四、请求示例

GET /datasetquery/exports?datasetname=test&maxresults=20&nexttoken=xxxxxx HTTP/1.1Host: <AppId>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: Auth StringAccept: 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 字段说明。

赞 (0)
上一篇 4天前
下一篇 4天前