翻訳の取り消し

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

• このメソッドは、 id クエリ パラメーターによって要求に示されているように、現在処理中またはキューに登録されている (保留中) 翻訳ジョブを取り消します。
• 既に完了している場合、失敗した場合、または取り消し中の場合、操作は取り消されません。 これらのインスタンスでは、無効な要求が返されます。
• 完了した翻訳はキャンセルできません。また、課金されます。

要求 URL

  curl -i -X  DELETE "{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 オブジェクトは、成功時の応答の例です。

状態コード:200

{
  "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 オブジェクトは、エラー応答の例です。 他のエラー コードのスキーマも同じです。

状態コード: 500

{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "target": "Operation",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}

次のステップ

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