次の方法で共有


Foundry Tools の Azure Translator 応答コードとメッセージ

HTTP プロトコルを使用して、IISを実行しているサーバー上のコンテンツにアクセスすると、サーバーは要求の結果と応答の性質 (成功や失敗など) を示す数値コードを返します。 状態コードの最初の桁は応答クラスを分類しますが、最後の 2 桁は分類の目的を果たしません。 最初の桁には、次の 5 つの値のいずれかを指定できます。

  • 1xx (情報): 要求が受信され、処理が続行されることを示す中間応答。
  • 2xx (成功): サーバーが正常にクライアント要求を受信して受け入れた。
  • 3xx (リダイレクト): 要求を完了するには、さらに多くのアクションが必要です。
  • 4xx (クライアント エラー): クライアント ブラウザーで発生したエラーが発生し、満たすことはできません。
  • 5xx (サーバー エラー): サーバーでエラーが発生し、要求が失敗しました。

状態コード

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

状態コード Description
200 成功。
400 クエリ パラメーターの 1 つが欠落しているか無効です。 再試行する前に要求パラメーターを修正します。
401 要求を認証できませんでした。 資格情報が指定され、有効であることを確認します。
4:03 要求は承認されません。 詳細エラー メッセージを確認します。 多くの場合、この状態コードは、試用版サブスクリプションで提供されるすべての無料翻訳を使用したことを示します。
408 リソースがないため、要求を満たすことができませんでした。 詳細エラー メッセージを確認します。 要求にカスタム カテゴリが含まれている場合、多くの場合、この状態コードは、カスタム翻訳システムがまだ要求を処理できないことを示します。 要求は、待機期間 (1 分など) 後に再試行する必要があります。
429 クライアントが要求の制限を超えたため、サーバーは要求を拒否しました。
500 予期しないエラーが発生しました。 エラーが解決しない場合は、エラーの日時、応答ヘッダー X-RequestId からの要求識別子、および要求ヘッダー X-ClientTraceId からのクライアント識別子を使用して報告します。
503 サーバーは一時的に使用できません。 要求をやり直してください。 エラーが解決しない場合は、エラーの日時、応答ヘッダー X-RequestId からの要求識別子、および要求ヘッダー X-ClientTraceId からのクライアント識別子を使用して報告します。

エラーが発生した場合、要求は JSON エラー応答を返します。 エラー コードは、3 桁の HTTP 状態コードと 3 桁の数字を組み合わせた 6 桁の数字で、エラーをさらに分類します。

エラー コード

標準エラー応答は、 errorという名前の名前と値のペアを持つ JSON オブジェクトです。 値は、プロパティを持つ JSON オブジェクトでもあります。

  • code: サーバー定義のエラー コード。
  • message: エラーを人間が判読できる表現を提供する文字列。

たとえば、無料試用版サブスクリプションをお持ちのお客様は、無料クォータが使い果たされると、次のエラーが発生します。

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

エラー コードは、3 桁の HTTP 状態コードと 3 桁の数字を組み合わせた 6 桁の数字で、さらにエラーを分類します。 一般的なエラー コードは次のとおりです。

Code Description
400000 要求入力の 1 つが無効です。
400001 "scope" パラメーターが無効です。
400002 "category" パラメーターが無効です。
400003 言語指定子が見つからないか、無効です。
400004 ターゲット スクリプト指定子 ("To script") が見つからないか無効です。
400005 入力テキストが見つからないか無効です。
400006 言語とスクリプトの組み合わせが無効です。
400018 ソース スクリプト指定子 ("From script") が見つからないか無効です。
400019 指定された言語の 1 つがサポートされていません。
400020 入力テキストの配列内の要素の 1 つが無効です。
400021 API バージョン パラメーターがないか、無効です。
400023 指定された言語ペアの 1 つが無効です。
400035 ソース言語 ("From" フィールド) が無効です。
400036 ターゲット言語 ("To" フィールド) が見つからないか、無効です。
400042 指定されたオプションの 1 つ ([オプション] フィールド) が無効です。
400043 クライアント トレース ID (ClientTraceId フィールドまたは X-ClientTraceId ヘッダー) が見つからないか、無効です。
400050 入力テキストが長すぎます。 要求の制限を表示します
400064 "translation" パラメーターが見つからないか、無効です。
400070 ターゲット スクリプトの数 (ToScript パラメーター) がターゲット言語の数 (To パラメーター) と一致しません。
400071 この値は TextType では無効です。
400072 入力テキストの配列に要素が多すぎます。
400073 スクリプト パラメーターが無効です。
400074 要求の本文が有効な JSON ではありません。
400075 言語ペアとカテゴリの組み合わせが無効です。
400077 要求の最大サイズを超えています。 要求の制限を表示します
400079 言語間の翻訳を要求されたカスタム システムが存在しません。
400080 表記変換は、言語またはスクリプトではサポートされていません。
401000 資格情報が見つからないか無効であるため、要求は承認されていません。
401015 "指定された資格情報は Speech API 用です。 この要求には、Text API の資格情報が必要です。 Translator のサブスクリプションを使用してください。"
403000 操作は許可されていません。
403001 サブスクリプションが空きクォータを超えたため、操作は許可されません。
405000 要求メソッドは、要求されたリソースではサポートされていません。
408001 要求された翻訳システムが準備中です。 数分後に再試行してください。
408002 受信ストリームの待機中に要求がタイムアウトしました。 クライアントは、サーバーが待機する準備ができた時間内に要求を生成しませんでした。 クライアントは、後で変更を加えずに要求を繰り返すことができます。
415000 Content-Type ヘッダーが見つからないか無効です。
429000, 429001, 429002 クライアントが要求の制限を超えたため、サーバーは要求を拒否しました。
500000 予期しないエラーが発生しました。 エラーが解決しない場合は、エラーの日付/時刻、応答ヘッダー X-RequestId からの要求識別子、および要求ヘッダー X-ClientTraceId からのクライアント識別子を使用して報告します。
503000 サービスは一時的に使用できません。 再試行してください。 エラーが解決しない場合は、エラーの日付/時刻、応答ヘッダー X-RequestId からの要求識別子、および要求ヘッダー X-ClientTraceId からのクライアント識別子を使用して報告します。