文档首页/ 高性能弹性文件服务 SFS Turbo/ API参考/ API/ 文件系统管理/ 获取文件系统异步任务列表
更新时间：2025-08-27 GMT+08:00
查看PDF
分享

获取文件系统异步任务列表

功能介绍

获取文件系统异步任务列表。仅支持查询目录资源使用情况的任务，API请求路径的feature取值为dir-usage，以下简称为DU任务。

接口约束

在2023年8月1号之后创建的文件系统支持该API操作。后端有5min的缓存时间，查询的数据可能有延迟。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

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

share_id

是

String

文件系统ID

feature

是

String

任务类型。例，DU任务取值为dir-usage
表2 Query参数

参数

是否必选

参数类型

描述

marker

否

String

marker填写为上一页返回的最后一条记录的task_id，作为下一次分页的起始值。比如，marker为d651ea2b-2b20-4c6d-8bbf-2adcec18dac9，limit为100，表示从d651ea2b-2b20-4c6d-8bbf-2adcec18dac9后返回最多100条满足查询条件的记录。

limit

否

Integer

limit, 取值为正整数. 默认为20，最大值为100

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型, application/json

响应参数

状态码：200

表4 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表5 响应Body参数

参数

参数类型

描述

tasks

Array of OneFsTaskResp objects

任务列表
表6 OneFsTaskResp

参数

参数类型

描述

task_id

String

任务ID

status

String

任务状态, SUCCESS表示成功，DOING表示正在执行，FAIL表示失败

枚举值：

  • SUCCESS

  • DOING

  • FAIL

dir_usage

FsDuInfo object

目录资源使用情况(包含子目录)

begin_time

String

任务开始时间，UTC时间，例如：2006-01-02 15:04:05'

end_time

String

任务结束时间，UTC时间，例如：2006-01-02 15:04:06'
表7 FsDuInfo

参数

参数类型

描述

path

String

文件系统内合法的目录全路径

used_capacity

Long

占用容量，单位：byte

file_count

FsFileCount object

该目录下所有文件数目

message

String

错误信息
表8 FsFileCount

参数

参数类型

描述

dir

Long

目录数目

regular

Long

普通文件数目

pipe

Long

管道文件数目

char

Long

字符设备数目

block

Long

块设备数目

socket

Long

套接字数目

symlink

Long

符号链接数目

状态码：400

表9 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表10 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码：404

表11 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表12 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码：500

表13 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID
表14 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde的文件系统，获取DU任务列表,从任务ID为"11abef677ac40f46644d1d5cfc2424a4"起，获取50个任务

GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/shares/77ba6f4b-6365-4895-8dda-bc7142af4dde/fs/dir-usage/tasks?marker=11abef677ac40f46644d1d5cfc2424a4&limit=50

响应示例

状态码：200

成功

{
  "tasks" : [ {
    "task_id" : "2b31ed520xxxxxxebedb6e57xxxxxxxx",
    "status" : "SUCCESS",
    "dir_usage" : {
      "path" : "/path",
      "used_capacity" : 0,
      "file_count" : {
        "dir" : 0,
        "regular" : 0,
        "pipe" : 0,
        "char" : 0,
        "block" : 0,
        "socket" : 0,
        "symlink" : 0
      },
      "message" : ""
    },
    "begin_time" : "2023-03-01 11:46:01",
    "end_time" : "2023-03-01 11:46:01"
  } ]
}

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

状态码

状态码

描述

200

成功

400

错误响应

404

错误响应

500

错误响应

错误码

请参见错误码。

父主题： 文件系统管理

相关文档