文档首页/高性能弹性文件服务 SFS Turbo/API参考/API/存储联动管理/查询数据导入导出任务列表 - ListHpcCacheTasks
更新时间：2026-02-27 GMT+08:00
查看PDF
分享

查询数据导入导出任务列表 - ListHpcCacheTasks

功能介绍

查询数据导入导出任务列表

接口约束

  • 该接口仅适用于SFS Turbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB文件系统。

  • 该接口仅适用于NFS文件系统共享协议。

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

GET /v1/{project_id}/sfs-turbo/{share_id}/hpc-cache/tasks

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

share_id

是

String

文件系统ID

表2 Query参数

参数

是否必选

参数类型

描述

type

否

String

任务类型。

枚举值：

  • import：表示附加元数据导入。

  • preload：表示数据预热。

  • export：表示导出。

  • import_metadata：表示快速导入。

status

否

String

任务状态

offset

否

Long

offset，默认值为 0

limit

否

Long

limit，默认值为 1000

start_time

否

String

start_time

end_time

否

String

end_time

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型

响应参数

状态码：200

表4 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID

表5 响应Body参数

参数

参数类型

描述

tasks

Array of OneHpcCacheTaskInfoResp objects

任务详情

count

Long

任务数量

表6 OneHpcCacheTaskInfoResp

参数

参数类型

描述

task_id

String

任务ID

type

String

任务类型。

枚举值：

  • import：表示附加元数据导入。

  • preload：表示数据预热。

  • export：表示导出。

  • import_metadata：表示快速导入。

status

String

任务状态。

枚举值：

  • SUCCESS：表示成功。

  • DOING：表示进行中。

  • FAIL：表示失败。

  • DELETING：表示删除中。

src_target

String

联动目录名称

src_prefix

String

导入导出任务的源端路径前缀

dest_target

String

和src_target保持一致

dest_prefix

String

和src_prefix保持一致

start_time

String

任务开始时间

end_time

String

任务结束时间

message

String

任务执行结果信息

状态码：400

表7 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID

表8 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

状态码：500

表9 响应Header参数

参数

参数类型

描述

X-request-id

String

请求ID

表10 响应Body参数

参数

参数类型

描述

errCode

String

错误码

errMsg

String

错误描述

请求示例

文件系统ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"， 查询数据导入导出任务列表

GET /v1/{project_id}/sfs-turbo/77ba6f4b-6365-4895-8dda-bc7142af4dde/hpc-cache/tasks

响应示例

状态码：200

成功

{
  "tasks" : [ {
    "task_id" : "7bd2a9b6-xxxx-4605-xxxx-512d636001b0",
    "type" : "import",
    "status" : "DOING",
    "src_target" : "sfs-link-directory",
    "src_prefix" : "input/datasets/",
    "dest_target" : "sfs-link-directory",
    "dest_prefix" : "input/datasets/",
    "message" : "",
    "start_time" : "2023-09-02T15:04:05",
    "end_time" : ""
  } ],
  "count" : 1
}

状态码：400

错误响应

{
  "errCode" : "SFS.TURBO.0001",
  "errMsg" : "parameter error"
}

状态码：500

错误响应

{
  "errCode" : "SFS.TURBO.0005",
  "errMsg" : "Internal server error"
}

状态码

状态码

描述

200

成功

400

错误响应

500

错误响应

错误码

请参见错误码。

父主题：存储联动管理

相关文档