取消/删除文件系统异步任务 - DeleteFsTask
功能介绍
如果异步任务正在执行,则取消并删除任务;否则,删除任务。仅支持删除目录资源使用情况的任务,API请求路径的feature取值为dir-usage,以下简称为DU任务。
接口约束
在2023年8月1号之后创建的文件系统支持该API操作。API请求路径的feature仅支持以下取值:
该接口仅适用于以下类型:
标准型、标准型-增强版、性能型、性能型-增强版类型的SFS Turbo文件系统,请使用“查询目录资源使用情况”接口。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
DELETE /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/{feature}/tasks/{task_id}
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID |
share_id | 是 | String | 文件系统ID |
feature | 是 | String | 任务类型。例,DU任务取值为dir-usage |
task_id | 是 | String | 任务ID |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 账号的token |
Content-Type | 是 | String | MIME类型,application/json |
响应参数
状态码:202
参数 | 参数类型 | 描述 |
|---|---|---|
X-request-id | String | 请求ID |
状态码:400
参数 | 参数类型 | 描述 |
|---|---|---|
X-request-id | String | 请求ID |
参数 | 参数类型 | 描述 |
|---|---|---|
errCode | String | 错误码 |
errMsg | String | 错误描述 |
状态码:404
参数 | 参数类型 | 描述 |
|---|---|---|
X-request-id | String | 请求ID |
参数 | 参数类型 | 描述 |
|---|---|---|
errCode | String | 错误码 |
errMsg | String | 错误描述 |
状态码:500
参数 | 参数类型 | 描述 |
|---|---|---|
X-request-id | String | 请求ID |
参数 | 参数类型 | 描述 |
|---|---|---|
errCode | String | 错误码 |
errMsg | String | 错误描述 |
请求示例
ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"的文件系统,删除任务ID为"11abef677ac40f46644d1d5cfc2424a4"的DU任务
DELETE HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde/fs/dir-usage/tasks/11abef677ac40f46644d1d5cfc2424a4 响应示例
状态码:400
错误响应
{
"errCode" : "SFS.TURBO.0123",
"errMsg" : "feature invalid"
} 状态码:404
错误响应
{
"errCode" : "SFS.TURBO.0124",
"errMsg" : "task_id not found"
} 状态码:500
错误响应
{
"errCode" : "SFS.TURBO.0005",
"errMsg" : "Internal server error"
} 状态码
状态码 | 描述 |
|---|---|
202 | Accepted |
400 | 错误响应 |
404 | 错误响应 |
500 | 错误响应 |
错误码
请参见错误码。

