GetLanceTaskStatus

权限说明

API	Action	说明
GetLanceTaskStatus	oss:GetTableMaintenanceJobStatus	查询单个维护任务。

请求语法

GET /lance/oss/v1/table/{id}/tasks/{task_id} HTTP/1.1
Host: {tableBucketHost}
Date: GMT Date
Authorization: SignatureValue

请求参数

无业务请求 Body。本节接口的公共约定（访问地址、表标识、请求与响应头、权限、异步提交与额度、状态、错误码）见 Lance 表维护。

参数	位置	数据类型	是否必须	描述
id	path	string	是	当前表标识，默认 namespace$table_name。
task_id	path	string	是	Submit 返回的任务 ID。
delimiter	query	string	否	表标识分隔符，默认 $。

响应

HTTP/1.1 200 OK
Content-Type: application/json
x-oss-table-id: {table_id}

{
  "task_info": {
    "task_id": "11111111111111111111111111111111",
    "task_type": "lance_compact",
    "params": {
      "target_rows_per_fragment": 1048576,
      "materialize_deletions": true,
      "materialize_deletions_threshold": 0.1,
      "max_rows_per_group": 1024,
      "max_bytes_per_file": 0,
      "compaction_mode": "reencode"
    },
    "status": "submitted",
    "created_at": "2026-09-18T04:00:00.000000+00:00",
    "started_at": "",
    "completed_at": "",
    "result": {},
    "error": null
  }
}

字段	类型	描述
task_id	string	任务 ID。
task_type	string	五种 lance_ 前缀类型之一。
params	object	实际保存的任务参数，包含服务端补齐的默认值。
status	string	当前任务状态。
created_at	string	任务创建时间。
started_at	string	任务开始时间；未开始时为空字符串。
completed_at	string	进入终态的时间；非终态时为空字符串。
result	object	任务执行结果，初始为 {}；可以包含嵌套对象和数组，不同任务类型的结果结构不固定。
error	object 或 null	已知状态为 failed 时包含错误对象；其他已知状态为 null。

顶层只有 task_info，其对象结构见上表。示例 ID 和时间仅用于说明。不存在和不属于当前表的任务都返回 404 / TaskNotFound / 10000。

错误码

本接口使用 Lance 统一 JSON 错误格式，通用错误码与错误响应结构见公共约定中的错误响应格式。