Deletes the record of a terminal-state task for the current table. This interface does not cancel tasks that are queued or running, nor does it roll back data modifications already completed by the task.
Permission notes
|
API |
Action |
Description |
|
DeleteLanceTask |
oss:PutTableMaintenanceConfiguration |
Deletes a terminal-state maintenance task record. |
Request syntax
DELETE /lance/oss/v1/table/{id}/tasks/{task_id} HTTP/1.1
Host: {tableBucketHost}
Date: GMT Date
Authorization: SignatureValueRequest parameters
No business request Body. For the common conventions of this interface (access address, table identifier, request and response headers, permissions, async submission and quota, task status, error codes), see Lance table maintenance.
|
Parameter |
Location |
Data type |
Required |
Description |
|
id |
path |
string |
Yes |
Current table identifier. |
|
task_id |
path |
string |
Yes |
The task ID to delete. |
|
delimiter |
query |
string |
No |
Default value $. Table identifier delimiter. |
Response
HTTP/1.1 204 No Content
x-oss-table-id: {table_id}|
Task state |
Response |
|
Exists and is completed / failed |
Returns 204 on successful deletion, no Body |
|
submitted / running |
409 / TaskStateConflict / 10001 |
|
Unknown non-empty status |
409 / TaskStateConflict / 10001 |
|
Does not exist, already deleted, or belongs to another table |
404 / TaskNotFound / 10000 |
A repeated Delete does not return 204 again; instead it returns 404. If the client needs "ensure the record does not exist" semantics, it can treat both 204 and TaskNotFound (when the table is still valid) as the goal being achieved.
The deletion order is to delete the task body first, then the index. If the body deletion succeeds but the index deletion fails, an internal error may be returned this time; subsequent Get/Delete calls return TaskNotFound because the body no longer exists. The residual index must be cleaned up in the background.
Error codes
This interface uses the Lance unified JSON error format. For common error codes and the error response structure, see Lance table maintenance in the common conventions.