DeleteLanceTask

更新时间:
复制 MD 格式

删除当前表下一个终态任务的记录。此接口不取消排队中或执行中的任务,也不回滚该任务已经完成的数据修改。

权限说明

API

Action

说明

DeleteLanceTask

oss:PutTableMaintenanceConfiguration

删除终态维护任务记录。

请求语法

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

请求参数

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

参数

位置

数据类型

是否必须

描述

id

path

string

是

当前表标识。

task_id

path

string

是

要删除的任务 ID。

delimiter

query

string

否

默认值 $。表标识分隔符。

响应

HTTP/1.1 204 No Content
x-oss-table-id: {table_id}

任务情况

响应

存在且为 completed / failed

删除成功后返回 204,无 Body

submitted / running

409 / TaskStateConflict / 10001

未知非空状态

409 / TaskStateConflict / 10001

不存在、已删除或属于另一张表

404 / TaskNotFound / 10000

重复 Delete 不会再次返回 204,而是返回 404。客户端如需“确保记录不存在”的语义,可以将 204 和确认表仍有效时的 TaskNotFound 视为目标已达成。

删除顺序是先删除任务正文,再删除索引。如果正文删除成功而索引删除失败,本次可能返回内部错误;随后 Get/Delete 会因正文不存在返回 TaskNotFound。后台需清理残留索引。

错误码

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