HTTP 状態コード (Azure Cognitive Search)

このページでは、Azure Cognitive 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 見つかりません サーバーにリソースが存在しない場合に返されます。 インデックスの管理中、またはクエリの実行中の場合、構文をチェックしてインデックス名が正しく指定されていることを確認します。
409 競合 書き込み操作の競合時に返されます。 このエラーは、リソースの更新時、または 2 つのプロセスが同じドキュメントを同時に更新しようとしたときに、インデックス作成中に返されます。 Azure Cognitive Searchは、リソース更新のコンカレンシー管理を提供します。 詳細については、「Azure Cognitive Searchでコンカレンシーを管理する方法」を参照してください。
412 Precondition Failed If-Matchまたは If-None-Match ヘッダーの条件が false と評価されたときに返されます。 インデックス定義、インデクサー、またはデータ ソースの HTTP 要求を送信するときの オプティミスティック コンカレンシー制御 の使用に関連付けられます。
429 Too Many Requests インデックスを作成しようとしているときにこのエラーが発生した場合は、価格帯で許可されているインデックスの最大数が既に存在します。 Azure Cognitive Searchに格納されているインデックスの数は、Azure portalの検索サービス ダッシュボードに表示されます。 インデックス名を表示するには、[インデックス] タイルをクリックします。 または、List Indexes 操作を使用して、名前でインデックスの 一覧を 取得することもできます。 詳細については、「 インデックスの一覧取得 」を参照してください。

ドキュメントのアップロード中にこのエラーが発生した場合は、インデックスあたりのドキュメント数のクォータを超えたことを示します。 新しいインデックスを作成するか、またはさらに高い処理能力の限界にアップグレードする必要があります。
499 クライアントの終了要求 このエラーは応答では返されませんが、 検索トラフィック分析 と Azure Monitor によって記録されたログ エントリに表示される場合があります。 これは、クライアントがサービスから応答が返される前に接続を閉じたことを示します。 サービス側コードによって要求されなかった取り消し、またはクライアントが存在しなくなった取り消しがAzure Cognitive Search検出されると、499 エラーがログに記録されます。
502 無効なゲートウェイ このエラーは、接続に HTTPS ではなく HTTP を入力すると発生します。
503 サービス利用不可 このエラーは、システムが過負荷の状態にあり、この時点では要求を処理できないことを示します。 大事な: この場合は、クライアント コードをオフにして、再試行する前に待機することを強くお勧めします。 こうすることで、システムが回復する時間が生まれ、その後の要求に成功する可能性が高くなります。 要求をすぐに再試行しても、状況が長引くだけです。
504: ゲートウェイ のタイムアウト Azure Cognitive Search は HTTPS ポート 443 をリッスンします。 検索サービスの URL に HTTPS ではなく HTTP が含まれている場合は、504 状態コードが返されます。

関連項目