一、授权说明
通过子账号使用时,需要在 授权策略 的 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 字段说明。