分页查询翻译任务列表。默认按创建时间倒序排列,仅返回当前调用方自己的任务。支持按状态、语种、文件名和时间范围筛选。
请求参数
分页令牌。首次查询不传,后续查询传入上一次响应中返回的 NextToken。
按任务状态筛选。可选值:ANALYZED、PENDING、PROCESSING、COMPLETED、FAILED、CANCELLED
起始时间筛选。格式:YYYY-MM-dd HH:mm:ss。
结束时间筛选。格式:YYYY-MM-dd HH:mm:ss。
响应参数
调用示例
ListTranslationTasksRequest request = new ListTranslationTasksRequest()
.setMaxResults(10);
ListTranslationTasksResponse response = client.listTranslationTasks(request);
ListTranslationTasksResponseBody.ListTranslationTasksResponseBodyData data = response.getBody().getData();
System.out.println("总条数: " + data.getTotal());
for (ListTranslationTasksResponseBody.ListTranslationTasksResponseBodyDataList task : data.getList()) {
System.out.println("TaskId: " + task.getTaskId() + ", 状态: " + task.getStatus()
+ ", 文件: " + task.getOriginalFileName());
}
String nextToken = null;
int page = 1;
do {
ListTranslationTasksRequest request = new ListTranslationTasksRequest()
.setMaxResults(5)
.setNextToken(nextToken);
ListTranslationTasksResponse response = client.listTranslationTasks(request);
ListTranslationTasksResponseBody.ListTranslationTasksResponseBodyData data = response.getBody().getData();
System.out.println("[第 " + page + " 页] 本页 " + data.getList().size() + " 条, 共 " + data.getTotal() + " 条");
for (ListTranslationTasksResponseBody.ListTranslationTasksResponseBodyDataList task : data.getList()) {
System.out.println(" " + task.getTaskId() + " - " + task.getStatus());
}
nextToken = data.getNextToken();
page++;
} while (nextToken != null);
ListTranslationTasksRequest request = new ListTranslationTasksRequest()
.setMaxResults(10)
.setStatus("COMPLETED")
.setSourceLanguage("zh")
.setTargetLanguage("en")
.setStartTime("2026-01-01 00:00:00")
.setEndTime("2026-12-31 23:59:59");
ListTranslationTasksResponse response = client.listTranslationTasks(request);
响应示例
{
"Data": {
"List": [
{
"TaskId": "f9c35b0453b",
"OriginalFileName": "quarterly-report.pptx",
"Status": "COMPLETED",
"Progress": 100,
"SourceLanguage": "zh",
"TargetLanguage": "en",
"Template": "common",
"FileFormat": "PPTX",
"FileName": "quarterly-report.pptx",
"TaskType": "DOCUMENT",
"WordCount": 1600,
"PageCount": 21,
"CostCredits": 81.2992,
"CostTime": 196000,
"Creator": "acc_93****c936",
"CreatorName": "test@example.com",
"GmtCreate": "1782459562000",
"StartTime": "1782459562000",
"CompleteTime": "1782459758000",
"ErrorMessage": "",
"WorkSpaceId": "6458351****0cc5",
"OrgId": "org_c6****cdc2ce7"
}
],
"Total": 50,
"MaxResults": 10,
"NextToken": "AAAAAVpfrV4aVmra0dxbtRB74lmSGzegoejeIqxIET/WdX50"
}
}
错误码
| 错误码 | 说明 |
|---|
InvalidParameter | 参数校验失败 |
InvalidParameter.Page | 分页参数不合法 |