删除当前表下一个终态任务的记录。此接口不取消排队中或执行中的任务,也不回滚该任务已经完成的数据修改。
权限说明
|
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 错误格式,通用错误码与错误响应结构见公共约定中的 错误响应格式。
该文章对您有帮助吗?