# 查询数据导入导出任务列表 - ListHpcCacheTasks
#### 功能介绍
查询数据导入导出任务列表。
#### 接口约束
- 该接口仅适用于SFS Turbo 20MB/s/TiB、40MB/s/TiB、125MB/s/TiB、250MB/s/TiB、500MB/s/TiB、1000MB/s/TiB、100MB/s/TiB-智算型、200MB/s/TiB-智算型文件系统。
  
- 该接口仅适用于NFS文件系统共享协议。
  
- 100MB/s/TiB-智算型、200MB/s/TiB-智算型不支持创建任务类型为导出的数据任务。
  
 
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=ListHpcCacheTasks)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0079.html)。
#### URI
GET /v1/{project_id}/sfs-turbo/{share_id}/hpc-cache/tasks
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述     |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID   |
| share_id   | 是    | String | 文件系统ID |
   
表2Query参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| 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                                                                                             | 任务数量 |
   
 表6OneHpcCacheTaskInfoResp 
| 参数          | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| 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/2b31ed520xxxxxxebedb6e57xxxxxxxx/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 | 错误响应 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。