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 からのクライアント識別子を使用して報告します。 |