文档首页/ 高性能弹性文件服务 SFS Turbo/ API参考/ API/ 文件系统管理/ 取消/删除文件系统异步任务 - DeleteFsTask
更新时间：2026-09-30 GMT+08:00
查看PDF
分享

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

功能介绍

如果异步任务正在执行，则取消并删除任务；否则，删除任务。仅支持删除目录资源使用情况的任务，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缓存型

  • 100MB/s/TiB-智算型

  • 200MB/s/TiB-智算型

标准型、标准型-增强版、性能型、性能型-增强版类型的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}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID，用于标识资源所属的IAM项目空间，实现项目级资源隔离与权限管控。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

share_id

是

String

参数解释：

文件系统ID，用于唯一标识SFS Turbo文件系统实例。

获取方法请参见查询文件系统列表接口。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

feature

是

String

参数解释：

任务类型标识，用于指定要取消或删除的异步任务类型。

约束限制：

不涉及。

取值范围：

  • dir-usage：查询目录资源使用情况任务（DU任务）。

默认取值：

不涉及。

task_id

是

String

参数解释：

任务ID，用于唯一标识要取消或删除的异步任务。

获取方法请参见创建文件系统异步任务。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token，用于鉴权认证。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

Content-Type

是

String

参数解释：

请求消息体MIME类型，用于标识请求正文的数据格式。

约束限制：

不涉及。

取值范围：

application/json

默认取值：

application/json

响应参数

状态码：202

表3 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释：

请求ID，用于唯一标识和追踪本次请求。

取值范围：

不涉及。

状态码：400

表4 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释：

请求ID，用于唯一标识和追踪本次请求。

取值范围：

不涉及。
表5 响应Body参数

参数

参数类型

描述

errCode

String

参数解释：

错误码，用于标识请求失败的原因。详细错误码请参见错误码。

取值范围：

不涉及。

errMsg

String

参数解释：

错误描述，用于描述请求失败的具体原因，便于排查问题。请参见错误码。

取值范围：

不涉及。

状态码：404

表6 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释：

请求ID，用于唯一标识和追踪本次请求。

取值范围：

不涉及。
表7 响应Body参数

参数

参数类型

描述

errCode

String

参数解释：

错误码，用于标识请求失败的原因。详细错误码请参见错误码。

取值范围：

不涉及。

errMsg

String

参数解释：

错误描述，用于描述请求失败的具体原因，便于排查问题。请参见错误码。

取值范围：

不涉及。

状态码：500

表8 响应Header参数

参数

参数类型

描述

X-request-id

String

参数解释：

请求ID，用于唯一标识和追踪本次请求。

取值范围：

不涉及。
表9 响应Body参数

参数

参数类型

描述

errCode

String

参数解释：

错误码，用于标识请求失败的原因。详细错误码请参见错误码。

取值范围：

不涉及。

errMsg

String

参数解释：

错误描述，用于描述请求失败的具体原因，便于排查问题。请参见错误码。

取值范围：

不涉及。

请求示例

ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"的文件系统，删除任务ID为"11abef67-7ac4-0f46-644d-1d5cfc2424a4"的DU任务

DELETE HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde/fs/dir-usage/tasks/11abef67-7ac4-0f46-644d-1d5cfc2424a4

响应示例

状态码：202

无

状态码：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

已接受

400

错误响应

404

错误响应

500

错误响应

错误码

请参见错误码。

父主题： 文件系统管理

相关文档