HTTP 状態コード (Azure AI Search)
このページでは、Azure AI Search API の使用時に頻繁に返される HTTP 状態コードについて説明します。
一般的な HTTP 状態コード
| コード | 説明 |
|---|---|
| 200 OK | GET、PUT、または POST に成功しました。 正常に応答するために返されます。 インデックス作成中、このコードは、すべての項目が永続的に格納され、インデックスの作成を開始することを示します。 インデックス作成はバックグラウンドで実行され、インデックス作成操作が完了してから数秒後に新しいドキュメントを照会および検索できるようになります。 |
| 201 Created | PUT または POST に成功しました。 オブジェクトが正常に作成または更新されました。 |
| 204 Accepted | PUT または POST に成功しました。 インデックスまたはドキュメントのアップロードが成功しました。 |
| 207 Multi-Status | PUT または POST が一部成功しました。 ドキュメントの一部は成功しましたが、少なくとも 1 つが失敗しました。 |
| 400 Bad Request | 要求 URI、ヘッダー、または本文にエラーがある場合に返されます。 応答本文には、特定の問題の内容を説明するエラー メッセージが含まれています。 |
| 403 許可されていません | 無効な api-key を渡すと返されます。 |
| 404 見つかりません | サーバー上にリソースが存在しない場合に返されます。 インデックスを管理またはクエリする場合は、構文をチェックし、インデックス名が正しく指定されていることを確認します。 |
| 405 メソッドがサポートされていません | 要求が認識されるがサポートされていないメソッドを指定した場合に返されます。 インデックスに対してクエリを実行する場合、その要求の定式化には、エンドポイント、インデックスのコレクションとインデックス、docs コレクションと検索メソッド (例: https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30) が含まれます。 |
| 409 競合 | 書き込み操作の競合時に返されます。 このエラーは、リソースの更新時、または 2 つのプロセスが同じドキュメントを同時に更新しようとしたときにインデックス作成中に返されます。 Azure AI Search では、リソースの更新に対するコンカレンシー管理が提供されます。 詳細については、「 Azure AI Search でコンカレンシーを管理する方法」を参照してください。 |
| 412 Precondition Failed | If-Match または If-None-Match ヘッダーの条件が false と評価されたときに返されます。 インデックス定義、インデクサー、またはデータ ソースの HTTP 要求を送信するときの オプティミスティック コンカレンシー制御 の使用に関連付けられます。 |
| 429 Too Many Requests | インデックスの作成中にこのエラーが発生した場合は、価格レベルで許可されているインデックスの最大数が既に存在することを意味します。 Azure AI Search に格納されているインデックスの数は、Azure portalの検索サービス ダッシュボードに表示されます。 インデックスを名前で表示するには、[ インデックス ] タイルを選択します。 または、List Indexes 操作を使用して、名前でインデックスの 一覧を 取得することもできます。 詳細については、「 インデックスの一覧取得 」を参照してください。 ドキュメントのアップロード中にこのエラーが発生した場合は、インデックスあたりのドキュメント数のクォータを超えたことを示します。 新しいインデックスを作成するか、またはさらに高い処理能力の限界にアップグレードする必要があります。 |
| 499 クライアントクローズ要求 | このエラーは応答では返されませんが、 検索トラフィック分析 と Azure Monitor によって記録されたログ エントリに表示される場合があります。 これは、応答がサービスによって返される前に、クライアントが接続を閉じたことを示します。 サービス側コードによって要求されなかったキャンセル、またはクライアントが存在しなくなったキャンセルが Azure AI Search によって検出されると、499 エラーがログに記録されます。 |
| 502 無効なゲートウェイ | このエラーは、接続に HTTPS ではなく HTTP を入力すると発生します。 |
| 503 サービス利用不可 | このエラーは、システムが過負荷の状態にあり、この時点では要求を処理できないことを示します。 大事な： この場合は、クライアント コードをオフに戻し、再試行する前に待機することを強くお勧めします。 こうすることで、システムが回復する時間が生まれ、その後の要求に成功する可能性が高くなります。 要求をすぐに再試行しても、状況が長引くだけです。 調整とこの状態を防ぐ方法の詳細については、「 パフォーマンスの分析 」を参照してください。 |
| 504: ゲートウェイのタイムアウト | Azure AI Search は HTTPS ポート 443 でリッスンします。 検索サービスの URL に HTTPS ではなく HTTP が含まれている場合は、504 状態コードが返されます。 |