特定の翻訳ジョブの状態を取得する

リファレンス
機能: Azure AI Translator → Document Translation
API バージョン: 2024-05-01
HTTP メソッド: GET

• get translation statusメソッドを使用して、特定の翻訳ジョブの状態を要求します。 応答には、ジョブ全体の状態と、そのジョブの一部として翻訳されるドキュメントの状態が含まれます。

要求 URL

curl -i -X GET "{document-translation-endpoint}/translator/document/batches/{id}?api-version={date}"

要求パラメーター

クエリ文字列に渡される要求パラメーターを次に示します。

id 値の検索

ジョブ id は、POST start-batch-translation メソッドの応答ヘッダー Operation-Location の URL 値で確認します。 /document/ パラメーターの後に続く英数字の文字列は、操作のジョブ id です。

• また、get-translations-status 要求を使用して、翻訳 "ジョブ" とその id の一覧を取得することもできます。

要求ヘッダー

要求ヘッダーを次に示します。

応答状態コード

要求によって返される可能性のある HTTP 状態コードを次に示します。

翻訳状態の取得の応答

翻訳状態の取得の応答に成功

成功した応答では、次の情報が返されます。

エラー応答

例

成功した応答の例

次の JSON オブジェクトは、成功時の応答の例です。

{
  "id": "727bf148-f327-47a0-9481-abae6362f11e",
  "createdDateTimeUtc": "2020-03-26T00:00:00Z",
  "lastActionDateTimeUtc": "2020-03-26T01:00:00Z",
  "status": "Succeeded",
  "summary": {
    "total": 10,
    "failed": 1,
    "success": 9,
    "inProgress": 0,
    "notYetStarted": 0,
    "cancelled": 0,
    "totalCharacterCharged": 0
  }
}

エラー応答の例

次の JSON オブジェクトは、エラー応答の例です。 他のエラー コードのスキーマも同じです。

状態コード: 401

{
  "error": {
    "code": "Unauthorized",
    "message": "User is not authorized",
    "target": "Document",
    "innerError": {
      "code": "Unauthorized",
      "message": "Operation is not authorized"
    }
  }
}

次のステップ

クイックスタートに従って、ドキュメント翻訳とクライアント ライブラリの使用について学習します。