检索批处理翻译作业中每个文档的翻译状态。 响应包括每文档状态、进度、输出位置和字符用法。 此操作支持对大型作业有用的分页、排序和筛选。
HTTP 方法： GET API 版本： 2026-03-01
请求
GET {endpoint}/translator/document/batches/{jobId}/documents?api-version=2026-03-01
| 标题 |
必需 |
Description |
Ocp-Apim-Subscription-Key |
是的 |
Azure门户中的翻译器资源密钥。 |
Ocp-Apim-Subscription-Region |
条件 |
如果使用区域资源，则为必需。 |
路径参数
| 参数 |
必需 |
Description |
jobId |
是的 |
提交批处理请求时标头中 operation-location 返回的作业 ID。 |
查询参数
| 参数 |
必需 |
Description |
api-version |
是的 |
API 的版本。 当前值： 2026-03-01. |
$top |
No |
要返回的最大记录数（对于分页）。 |
$skip |
No |
要跳过的记录数（用于分页）。 |
$orderBy |
No |
排序字段。 支持值： createdDateTimeUtc， lastActionDateTimeUtc。 |
示例请求
curl -X GET "{endpoint}/translator/document/batches/{jobId}/documents?api-version=2026-03-01" \
-H "Ocp-Apim-Subscription-Key: {key}"
响应
响应状态代码
| 状态代码 |
Description |
200 |
单击“确定”。 返回文档及其翻译状态的列表。 |
401 |
身份验证失败。 检查订阅密钥。 |
404 |
找不到作业。 验证 .jobId |
500 |
内部服务器错误。 |
响应正文
| 领域 |
类型 |
Description |
value |
数组 |
文档状态对象的数组。 |
value[].id |
字符串 |
文档 ID。 使用此值可调用 特定文档的“获取”状态。 |
value[].sourcePath |
字符串 |
Blob 存储容器中的源文件路径。 |
value[].status |
字符串 |
文档翻译状态。 |
value[].to |
字符串 |
目标语言代码。 |
value[].progress |
number |
将转换进度转换为介于 0 和 1 之间的值。 |
value[].characterCharged |
整数 |
本文档计费的字符数。 |
nextLink |
字符串 |
如果应用分页，则为下一页结果的 URL。 |
相关内容