文档中心

向量数据库VikingDB

请输入

离线任务(Task)

任务查询

概述

查询指定 task 的详情信息和执行进度

请求参数

字段名	类型	必须	说明
task_id	string	是	任务ID，在创建任务时返回

示例

请求参数

curl -i -X GET \
  -H 'Content-Type: application/json' \
  -H 'Authorization: HMAC-SHA256 ***' \
  https://api-vikingdb.volces.com/api/task/info \
  -d '{
    "task_id": "*************"
}'

返回值

属性	类型	说明
task_id	string	任务ID
task_type	string	任务类型
task_status	string	任务状态
update_person	string	任务更新人
update_time	string	任务信息更新时间
create_time	string	任务信息创建时间
process_info	map	任务处理信息，例如进度等
task_params	map	任务配置信息，用户填入

task_type 类型包括

data_import	数据导入任务
data_export	数据导出任务
filter_update	数据过滤更新任务
filter_delete	数据过滤删除任务

task_status 任务状态包括

init	queued	confirm	confirmed	running	done	fail
初始化中	排队中	需要人工确认	已确认	执行中	完成	失败

process_info 任务信息包括

字段	类型	说明
task_progress	string	任务进度例如50%
err_msg	string	任务错误信息
sampled_data	list	采样5条数据用于展示
sampled_timestamp	int64	采样的时间戳，后写入的数据不会被处理
scan_data_count	int64	当前扫描数据量
total_data_count	int64	collection 数据总条数(预估）
total_filter_count	int64	已经过滤出的数据

返回说明补充

create_time 与 update_time 为字符串，格式为 YYYY-MM-DD HH:mm:ss，时区为 Asia/Shanghai（UTC+8）。解析时不要按本地系统时区二次偏移。

返回说明补充

sampled_timestamp 类型为 int64，单位为毫秒，是 Unix Epoch 时间戳；晚于该采样点写入的数据不会被本次任务处理。

鉴权说明补充

鉴权说明

示例中的 Authorization: HMAC-SHA256 *** 不是固定 Token。请从火山引擎控制台“密钥管理”获取 AK/SK，并根据 HTTP 方法、URI、查询参数、规范化请求头和请求体摘要生成 HMAC-SHA256 签名。完整步骤参见API 签名调用指南。使用官方 SDK 时由 SDK 自动完成签名，不要在代码或文档中写入真实密钥。

错误处理补充

返回结构补充

字段	类型	含义
`code`	int	业务状态码；成功时为 0。
`message`	string	状态说明或错误信息。
`request_id`	string	请求唯一标识，用于问题排查。
`data`	object / array	接口业务数据；没有业务数据时可为空。

错误码

本接口的业务错误码、触发条件和处理建议统一参见向量库 V1 错误码。排查时请保留响应中的 request_id。

最近更新时间：2026.09.08 15:30:03

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

请求参数 #

返回说明补充 #

返回说明补充 #

鉴权说明补充 #

鉴权说明 #

错误处理补充 #

返回结构补充 #

错误码 #

请求参数

返回说明补充

返回说明补充

鉴权说明补充

鉴权说明

错误处理补充

返回结构补充

错误码