文件 ​

查询异步任务信息 ​

1.接口说明 ​

接口路径:/efile/openapi/v2/file/task/list

请求方式:POST

请求数据类型:application/json

接口描述:查询异步任务信息接口，用于查询提交的异步复制/移动/删除任务信息（建议每次查询100个任务,最多不超过500）。任务结束后，服务端会缓存任务信息24小时。

2.请求消息 ​

请求参数:

Headers:

名称类型必填描述示例
tokenstring是接口凭证eyJhbGciOiJIUzI1N...

参数:

名称类型必填描述示例
taskIdsarray是任务id列表（异步复制/移动/删除接口，返回参数中的taskId）["254653d8816b4407ba27a9d004342c0e",
"3dc8b0a6b508469b8554bc7f72ea006d"]

3.请求示例 ​

cURL请求示例

shell
curl --location 'https://scnet-demo.accloud.cn/efile/openapi/v2/file/task/list' \
--header 'token: <Token>' \
--header 'Content-Type: application/json' \
--data '{
    "taskIds": [
        "10b10bf643814ebfb1fbf0d7e910e8d1"
    ]
}'

Java请求示例

java
import okhttp3.*;

public class FileCopyDemo {

    public static final String TOKEN = "<Token>";
    
    public static final String URL = "https://scnet-demo.accloud.cn/efile/openapi/v2/file/task/list";

    public static void main(String[] args) throws Exception {
        String requestBodyJson = "{\n" +
                "    \"taskIds\": [\n" +
                "        \"10b10bf643814ebfb1fbf0d7e910e8d1\"\n" +
                "    ]\n" +
                "}";
        
        OkHttpClient client = new OkHttpClient().newBuilder()
                .build();
        MediaType mediaType = MediaType.parse("application/json");
        RequestBody body = RequestBody.create(mediaType, requestBodyJson);
        Request request = new Request.Builder()
                .url(URL)
                .method("POST", body)
                .addHeader("token", TOKEN)
                .addHeader("Content-Type", "application/json")
                .build();
        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}

Python请求示例

python
import requests
import json

url = "https://scnet-demo.accloud.cn/efile/openapi/v2/file/task/list"

payload = json.dumps({
    "taskIds": [
        "10b10bf643814ebfb1fbf0d7e910e8d1"
    ]
})
headers = {
    "token": "<Token>",
    'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

4.响应消息 ​

返回参数:

名称类型说明
msgstring异常时的详细异常信息
codestring0：成功，10003：参数异常，911020：文件不存在，911021：文件已存在，911501：空间不足，911507：源文件与目标文件一致,禁止操作，911009：区域用户不存在，911030：权限不足，10001：其它异常
dataarray
taskIdstring任务id，查询任务信息/取消任务时使用
userIdstring用户id
userNamestring用户名
clusterUserNamestring集群用户名
sourcePathstring源文件
targetPathstring目标目录
duplicateHandleTypestring重复文件处理方式。可选值：覆盖：cover，保留二者：both
clusterIdstring集群id
clusterNamestring集群名
operationTypestring操作类型 可选值：复制：copy， 移动：move， 删除：delete
synchronousExecutionboolean执行方式 同步：true，异步：false
statusstring任务状态 可选值：等待：waiting， 处理中：processing， 取消：cancel， 完成：complete， 失败：fail
errorCodestring错误码
errorMsgstring错误消息
totalSizelong文件总大小。synchronousExecution=false 时有值
totalNumlong文件总数量。synchronousExecution=false 时有值
processedSizelong已处理文件大小。synchronousExecution=false 时有值
processedNumlong已处理文件数量。synchronousExecution=false 时有值
progressstring进度
submitTimestring提交时间
startTimestring开始时间
updateTimestring更新时间

返回示例:

json
{
  "code": "0",
  "data": [
    {
      "sourcePath": "/home/demo/efile-test/file_source/text.txt",
      "targetPath": null,
      "duplicateHandleType": null,
      "clusterId": null,
      "clusterName": null,
      "taskId": "10b10bf643814ebfb1fbf0d7e910e8d1",
      "userId": "11949818712",
      "userName": "efile-test",
      "clusterUserName": "efile-test",
      "operationType": "delete",
      "synchronousExecution": true,
      "status": "complete",
      "errorCode": null,
      "errorMsg": null,
      "totalSize": 5,
      "totalNum": 1,
      "processedSize": 0,
      "processedNum": 1,
      "progress": "100%",
      "submitTime": "2025-08-05 15:22:56",
      "startTime": "2025-08-05 15:22:56",
      "updateTime": "2025-08-05 15:22:56"
    }
  ],
  "msg": "success"
}

5.错误码 ​

错误码说明
0成功
10001内部异常（其他异常）
10003参数不全
10004参数无效
10009不支持的版本
911009区域用户不存在
911020文件不存在
911021文件已存在
911022目标地址不是一个文件夹
911025分享文件已存在，请重命名后分享
911029文件路径包含特殊字符，请重命名后再操作
911030权限不足，禁止操作
911031文件重命名失败
911034分享链接创建失败，请重新分享
911404ac认证服务端连接异常
911406服务端token认证异常，未取到关联用户
911501存储空间不足
911502目录非空，操作失败
911504命令执行超时
911505文件大小超出预设大小,无法预览
911506文件类型不在预设范围内,不允许打开
911507源文件与目标文件一致,禁止操作
911700文件名包含非法字符，请重命名后再操作
911048服务繁忙，触发限流，请稍后再试