检索批处理翻译作业中单个文档的状态详细信息。 响应包括翻译状态、进度、输出 URL 和字符用法。 这是检索错误详细信息或一个文档的输出 URL 的最有针对性的方法，无需分页完整文档列表。
HTTP 方法： GET API 版本： 2026-03-01
请求
GET {endpoint}/translator/document/batches/{jobId}/documents/{documentId}?api-version=2026-03-01
| 标题 |
必需 |
Description |
Ocp-Apim-Subscription-Key |
是的 |
Azure门户中的翻译器资源密钥。 |
Ocp-Apim-Subscription-Region |
条件 |
如果使用区域资源，则为必需。 |
路径参数
| 参数 |
必需 |
Description |
jobId |
是的 |
提交批处理请求时标头中 operation-location 返回的作业 ID。 |
documentId |
是的 |
获取所有文档的状态返回的文档 ID。 |
示例请求
curl -X GET "{endpoint}/translator/document/batches/{jobId}/documents/{documentId}?api-version=2026-03-01" \
-H "Ocp-Apim-Subscription-Key: {key}"
响应
响应状态代码
| 状态代码 |
Description |
200 |
单击“确定”。 返回指定文档的状态和元数据。 |
401 |
身份验证失败。 检查订阅密钥。 |
404 |
找不到文档或作业。 验证这两者 jobId 以及 documentId。 |
500 |
内部服务器错误。 |
响应正文
| 领域 |
类型 |
Description |
id |
字符串 |
文档 ID。 |
sourcePath |
字符串 |
Blob 存储容器中的源文件路径。 |
status |
字符串 |
文档翻译状态：NotStarted、、Running、Succeeded、FailedCancelled、或CancellingValidationFailed。 |
to |
字符串 |
目标语言代码。 |
progress |
number |
将转换进度转换为介于 0 和 1 之间的值。 |
characterCharged |
整数 |
本文档计费的字符数。 |
error |
对象 |
如果文档失败，错误详细信息。 包括 code 和 message 字段。 |
相关内容