更新时间:2024-06-19 GMT+08:00
分享

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

功能介绍

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

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

错误码

最小长度:8

最大长度:36

errMsg

String

错误描述

最小长度:2

最大长度:512

状态码: 404

表4 响应Body参数

参数

参数类型

描述

errCode

String

错误码

最小长度:8

最大长度:36

errMsg

String

错误描述

最小长度:2

最大长度:512

状态码: 500

表5 响应Body参数

参数

参数类型

描述

errCode

String

错误码

最小长度:8

最大长度:36

errMsg

String

错误描述

最小长度:2

最大长度:512

请求示例

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

错误响应

错误码

请参见错误码

分享:

    相关文档

    相关产品