查询异步导出任务

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

我的收藏

功能描述

查询单个异步导出任务的状态。

授权说明

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

服务开通

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

请求

请求示例

GET /datasetquery/export?datasetname=test&jobid=xxxxxx HTTP/1.1
Host: <AppId>.ci.<Region>.myqcloud.com
Authorization: Auth String
Content-Length: xxx
Content-Type: application/json
Accept: application/json
说明:
Authorization: Auth String(详情请参见 请求签名 文档)。
通过子账号使用时,需要授予相关的权限,详情请参见 授权粒度详情 文档。

请求头

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

请求参数

具体参数如下:
参数名称
描述
类型
是否必选
DatasetName
数据集名称,同一个账户下唯一
String
JobId
创建时返回的唯一任务 Id
String

请求体

该请求的请求体为空。

响应

响应头

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

响应体

{
"Job": {
"CreateTime": "2025-04-09T19:38:08.454310276+08:00",
"JobId": "xxxxxx",
"Name": "fortest",
"Output": {
"Bucket": "ci-qta-bj-1250000000",
"Object": "prefix001",
"Region": "ap-beijing"
},
"Query": {
"Field": "",
"Operation": "",
"SubQueries": [],
"Value": ""
},
"StartTime": "1970-01-01T00:00:00+08:00",
"EndTime": "1970-01-01T00:00:00+08:00",
"State": "todo"
},
"RequestId": "NjdmNjVjMjBfNzM0NjZjMT**********"
}
响应包体具体数据内容如下:
参数名称
类型
描述
RequestId
String
请求 ID
Job
Container
创建的任务信息
Job 节点说明:请参见 创建异步导出任务 接口响应部分的 Job 字段说明。