共用方式為


Azure Translator in Foundry Tools 回應代碼與訊息

當您使用 HTTP 通訊協定來存取執行 IIS之伺服器上的內容時,伺服器會傳回數值碼,指出要求的結果和回應的性質,包括其成功或失敗。 狀態代碼的第一個數位會將回應類別分類,而最後兩位數則沒有分類用途。 第一個數位可以是五個值之一:

  • 1xx (資訊):暫時回應,指出已收到要求並繼續進行處理。
  • 2xx (成功):伺服器已成功接收並接受用戶端要求。
  • 3xx (重新導向):需要採取更多動作才能完成要求。
  • 4xx (用戶端錯誤):發生錯誤源自客戶端瀏覽器且無法完成。
  • 5xx (伺服器錯誤):伺服器發生錯誤,要求失敗。

狀態代碼

以下是要求傳回的可能 HTTP 狀態碼。

狀態代碼 說明
200 成功。
400 其中一個查詢參數遺失或無效。 重試之前,請先更正要求參數。
401 無法驗證要求。 檢查是否已指定認證且有效。
403 要求未獲授權。 檢查詳細數據錯誤訊息。 此狀態代碼通常表示您使用試用版訂用帳戶所提供的所有免費翻譯。
408 因為缺少資源,因此無法完成要求。 檢查詳細數據錯誤訊息。 當要求包含自定義類別時,此狀態代碼通常表示自定義翻譯系統尚無法提供要求。 要求應在等候期間後重試(例如 1 分鐘)。
429 伺服器因為客戶端超過要求限制而拒絕要求。
500 發生未預期的錯誤。 如果錯誤持續發生,請報告失敗的日期和時間、來自響應標頭 X-RequestId 的要求標識碼,以及來自要求標頭 X-ClientTraceId 的用戶端識別符。
503 伺服器暫時無法使用。 請重試。 如果錯誤持續發生,請報告失敗的日期和時間、來自響應標頭 X-RequestId 的要求標識碼,以及來自要求標頭 X-ClientTraceId 的用戶端識別符。

如果發生錯誤,要求會傳回 JSON 錯誤回應。 錯誤碼是6位數的數字,結合3位數 HTTP狀態代碼,後面接著3位數的數位,以進一步分類錯誤:

錯誤碼

標準錯誤回應是 JSON 物件,名稱/值群組名稱為 error。 此值也是具有屬性的 JSON 物件:

  • code:伺服器定義的錯誤碼。
  • message:字串,提供人類看得懂的錯誤表示法。

例如,一旦免費配額用盡,具有免費試用訂用帳戶的客戶會收到下列錯誤:

{
  "error": {
    "code":403001,
    "message":"The operation isn't allowed because the subscription has exceeded its free quota."
    }
}

錯誤碼是6位數的數字,結合3位數 HTTP狀態代碼,後面接著3位數的數位,以進一步分類錯誤。 常見的錯誤碼包括:

Code 說明
400000 其中一個要求輸入無效。
400001 "scope" 參數無效。
400002 "category" 參數無效。
400003 語言指定名稱遺漏或無效。
400004 目標指令碼指定名稱 ("To script") 遺漏或無效。
400005 輸入文字遺漏或無效。
400006 語言與指令碼的組合無效。
400018 來源指令碼指定名稱 ("From script") 遺漏或無效。
400019 不支援其中一個指定的語言。
400020 輸入文字陣列中的其中一個元素無效。
400021 API 版本參數遺漏或無效。
400023 其中一個指定的語言組無效。
400035 來源語言 ("From" 欄位) 無效。
400036 目標語言 ("To" 欄位) 無效。
400042 其中一個指定的選項 ("Options" 欄位) 無效。
400043 用戶端追蹤標識碼 (ClientTraceId 欄位或 X-ClientTraceId 標頭) 遺失或無效。
400050 輸入文字太長。 檢視要求限制
400064 "translation" 參數遺漏或無效。
400070 目標指令碼 (ToScript 參數) 數目與目標語言 (To 參數) 數目不符。
400071 此值對 TextType 無效。
400072 輸入文字陣列的元素太多。
400073 指令碼參數無效。
400074 要求的本文不是有效的 JSON。
400075 語言組與類別組合無效。
400077 超過要求大小上限。 檢視要求限制
400079 所要求用來在來源與目標語言之間進行翻譯的自訂系統不存在。
400080 語言或指令碼不支援轉換。
401000 要求未獲得授權,因為認證遺失或無效。
401015 「提供的認證適用於語音 API。 此要求需要文字 API 的認證。 使用翻譯工具的訂用帳戶。
403000 不允許此作業。
403001 不允許此作業,因為訂用帳戶超過其免費配額。
405000 要求的資源不支援要求方法。
408001 正在準備要求的翻譯系統。 請在數分鐘後重試。
408002 等待傳入的串流時要求逾時。 用戶端未在伺服器準備好等待的時間內產生要求。 用戶端可能會在稍後不需要修改的情況下重複要求。
415000 Content-Type 標頭遺失或無效。
429000, 429001, 429002 伺服器因為客戶端超過要求限制而拒絕要求。
500000 發生未預期的錯誤。 如果錯誤持續發生,請報告錯誤日期/時間、響應標頭 X-RequestId 的要求識別碼,以及來自要求標頭 X-ClientTraceId 的用戶端識別碼。
503000 服務暫時無法使用。 重試。 如果錯誤持續發生,請報告錯誤日期/時間、響應標頭 X-RequestId 的要求識別碼,以及來自要求標頭 X-ClientTraceId 的用戶端識別碼。