取消/删除文件系统异步任务
功能介绍
如果异步任务正在执行,则取消并删除任务;否则,删除任务。仅支持删除目录资源使用情况的任务,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}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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 |
响应参数
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
errCode |
String |
错误码 最小长度:8 最大长度:36 |
errMsg |
String |
错误描述 最小长度:2 最大长度:512 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
errCode |
String |
错误码 最小长度:8 最大长度:36 |
errMsg |
String |
错误描述 最小长度:2 最大长度:512 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
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 |
错误响应 |
错误码
请参见错误码。