获取翻译作业状态

检索特定批处理翻译作业的总体状态和文档摘要。 提交批处理请求后轮询此终结点,直到作业达到终端状态:SucceededFailedCancelledValidationFailed

HTTP 方法: GET API 版本: 2026-03-01

请求

GET {endpoint}/translator/document/batches/{jobId}?api-version=2026-03-01

请求标头

标题 必需 Description
Ocp-Apim-Subscription-Key 是的 Azure门户中的翻译器资源密钥。
Ocp-Apim-Subscription-Region 条件 如果使用区域资源,则为必需。

路径参数

参数 必需 Description
jobId 是的 提交批处理请求时标头中 operation-location 返回的作业 ID。

示例请求

curl -X GET "{endpoint}/translator/document/batches/{jobId}?api-version=2026-03-01" \
  -H "Ocp-Apim-Subscription-Key: {key}"

响应

响应状态代码

状态代码 Description
200 单击“确定”。 返回总体作业状态和文档摘要。
401 身份验证失败。 检查订阅密钥。
404 找不到作业。 验证 .jobId
500 内部服务器错误。

响应正文

领域 类型 Description
id 字符串 作业编号。
status 字符串 总体作业状态:NotStarted、、RunningSucceededFailedCancelled、或CancellingValidationFailed
createdDateTimeUtc 字符串 作业创建日期/时间(UTC)。
lastActionDateTimeUtc 字符串 上次状态更改日期/时间(UTC)。
summary 对象 按状态统计的文档计数:成功、失败、inProgress、notStarted、已取消、总计。
error 对象 如果作业失败,错误详细信息。 包括 codemessage 字段。