このページでは、Azure AI Search API の使用時に頻繁に返される HTTP 状態コードについて説明します。
一般的な HTTP 状態コード
| コード | 形容 |
|---|---|
| 200 OK | GET、PUT、または POST での成功。 応答が成功した場合に返されます。 |
| 201 Created | PUT または POST での成功。 オブジェクトが正常に作成されました。 |
| 202 承諾済み | PUT または POST での成功。 この状態コードは、インデクサーの実行要求に対して返されます。 |
| 204 コンテンツなし | PUT または POST での成功。 更新は成功しましたが、応答で返す情報はありません。 |
| 207 マルチステータス | PUT または POST の部分的な成功。 一部のドキュメントは成功しましたが、少なくとも 1 つは失敗しました。 |
| 400 無効な要求 | 要求 URI、ヘッダー、または本文にエラーが発生したときに返されます。 応答本文には、特定の問題の内容を説明するエラー メッセージが含まれています。 |
| 401 未承認 | 資格情報が見つからない場合に返されます。 ロールベースのアクセス制御を使用している場合、ユーザーまたは検索サービスにロールの割り当てが欠落しています。 Azure AI Search へのアクセスに関する問題については、ロールを使用した Azure AI Search への接続 |
| 403 禁止 | 承認が失敗したときに返されます。 |
| 404 見つかりません | サーバーにリソースが存在しない場合に返されます。 |
| 405 メソッドはサポートされていません | サービスがサポートされていないメソッドを認識したときに返されます。 インデックスのクエリを実行する場合、その要求の定式化には、エンドポイント、インデックスのコレクションとインデックス、ドキュメント コレクションと検索方法 (たとえば、https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01) が含まれます。 |
| 409 競合 | 書き込み操作の競合時に返されます。 この状態コードは、リソース更新の場合、または 2 つのプロセスが同じドキュメントを同時に更新しようとしたときにインデックス作成中に返されます。 Azure AI Search では、リソースの更新に対するコンカレンシー管理が提供されます。 詳細については、「Azure AI Searchでコンカレンシーを管理する方法」を参照してください。 |
| 412 前提条件に失敗しました | If-Match または If-None-Match ヘッダーの条件が false と評価されたときに返されます。 インデックス定義、インデクサー、スキルセット、またはデータ ソースに対する HTTP 要求を送信するときに、オプティミスティック コンカレンシー制御 の使用に関連付けられます。 |
| 429 要求が多すぎます | オブジェクトの作成時にこの状態コードを取得する場合は、サービス レベルで許可される オブジェクトの最大数 があることを意味します。 アクティブなインデックスに対してこのエラー コードが表示される場合は、通常、ストレージが不足していることを意味します。 ストレージの制限に近付くと、一部のドキュメントを削除するまでサービスは追加または更新できない状態になります。 詳細については、「ストレージを増やす場合は 容量を計画および管理 する」、ドキュメントを削除して領域を解放する場合は コンテンツを更新 する方法に関するページを参照してください。 |
| 499 クライアントのクローズ要求 | この状態コードは応答では返されませんが、検索トラフィック分析 と Azure Monitor によって記録されたログ エントリに表示されることがあります。 これは、サービスから応答が返される前に、クライアントが接続を閉じたことを示します。 サービス側コードによって要求されなかったキャンセル、またはクライアントが存在しなくなったキャンセルが Azure AI Search によって検出されると、499 がログに記録されます。 |
| 502 無効なゲートウェイ | この状態コードは、接続で HTTPS ではなく HTTP を入力したときに発生します。 |
| 503 サービスを利用できない | この状態コードは、システムの負荷が高く、要求を処理できないことを意味します。 軽減策には、再試行ロジックへの待機時間の追加や容量の増加が含まれます。 新しいサービスでは、ストレージとコンピューティング能力が自動的に増えます。 パフォーマンス チューニングの詳細については、「Azure AI Searchでのパフォーマンスの分析」を参照してください。 |
| 504: ゲートウェイ のタイムアウト | Azure AI Search は HTTPS ポート 443 でリッスンします。 検索サービスの URL に HTTPS ではなく HTTP が含まれている場合は、504 状態コードが返されます。 |