文档首页/ 弹性文件服务 SFS/ API参考/ SFS Turbo API说明/ 文件系统管理/ 取消/删除文件系统异步任务
更新时间：2024-12-31 GMT+08:00
查看PDF
分享

取消/删除文件系统异步任务

功能介绍

如果异步任务正在执行，则取消并删除任务；否则，删除任务。仅支持删除目录资源使用情况的任务，API请求路径的feature取值为dir-usage，以下简称为DU任务。

接口约束

在2023年8月1号之后创建的文件系统支持该API操作。API请求路径的feature仅支持以下取值：

  • dir-usage

该接口仅适用于以下类型：

  • 20MB/s/TiB

  • 40MB/s/TiB

  • 125MB/s/TiB

  • 250MB/s/TiB

  • 500MB/s/TiB

  • 1000MB/s/TiB

  • HPC缓存型文件系统

标准型、标准型-增强版、性能型、性能型-增强版类型的SFS Turbo文件系统，请使用“查询目录资源使用情况”接口。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

URI

DELETE /v1/{project_id}/sfs-turbo/shares/{share_id}/fs/{feature}/tasks/{task_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目id

share_id

是

String

文件系统id

feature

是

String

任务类型。例，DU任务取值为dir-usage

task_id

是

String

任务ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型, application/json

响应参数

状态码： 400

表3 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码： 404

表4 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码： 500

表5 响应Body参数

参数

参数类型

描述

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

错误响应

错误码

请参见错误码。

父主题： 文件系统管理

相关文档