Azure AI 搜尋服務 (HTTP 狀態碼)
此頁面描述使用 Azure AI 搜尋 API 時經常傳回的 HTTP 狀態碼。
常見的 HTTP 狀態碼
| 程式碼 | 描述 |
|---|---|
| 200 確定 | GET、PUT 或 POST 執行成功。 傳回成功回應。 在編制索引期間，此程式碼會指出所有專案都已永久儲存，並開始編制索引。 索引編制會在背景執行，並在編制索引作業完成之後，讓新檔可供查詢和搜尋。 |
| 201 Created | PUT 或 POST 執行成功。 已成功建立或更新物件。 |
| 204 已接受 | PUT 或 POST 執行成功。 已成功上傳索引或文件。 |
| 207 多重狀態 | PUT 或 POST 部分執行成功。 有些文件成功，但至少有一項失敗。 |
| 400 不正確的要求 | 當要求 URI、標頭或本文發生錯誤時傳回。 回應本文包含錯誤訊息，說明特定問題是什麼。 |
| 403 禁止 | 在傳遞無效的 api 金鑰時傳回。 |
| 404 找不到 | 當伺服器上沒有資源時傳回。 如果您要管理或查詢索引，請檢查語法，並確認已正確指定索引名稱。 |
| 不支援 405 方法 | 當要求指定可辨識但不支援的方法時傳回。 如果您要查詢索引，該要求的公式包括端點、索引集合和索引，以及 docs 集合和搜尋方法 (例如， https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30) 。 |
| 409 衝突 | 寫入作業衝突時傳回。 當兩個進程嘗試同時更新相同的檔時，會針對資源更新傳回此錯誤，或在編制索引期間傳回。 Azure AI 搜尋服務提供資源更新的並行管理。 如需詳細資訊，請參閱 如何在 Azure AI 搜尋服務中管理並行。 |
| 412 先決條件失敗 | 當 If-Match 或 If-None-Match 標頭的條件評估為 false 時傳回。 傳送索引定義、索引子或資料來源的 HTTP 要求時，與使用 開放式並行存取控制 相關聯。 |
| 429 要求太多 | 如果您嘗試建立索引時發生此錯誤，這表示您已經擁有定價層允許的索引數目上限。 儲存在 Azure AI 搜尋服務中的索引計數會顯示在Azure 入口網站的搜尋服務儀表板中。 若要依名稱檢視索引，請選取 [索引] 圖格。 或者，您也可以使用清單索引作業，依名稱取得 索引 的清單。 如需詳細資訊，請參閱 列出索引 。 如果在檔上傳期間發生此錯誤，表示您已超過每個索引檔數目的配額。 您必須建立新的索引，或進行升級以取得更高的容量限制。 |
| 499 用戶端已關閉要求 | 此錯誤永遠不會在回應中傳回，但您可能會在 搜尋流量分析和 Azure 監視器所記錄的記錄專案中看到此錯誤。 它表示用戶端在服務傳迴響應之前已關閉連線。 當 Azure AI 搜尋服務偵測到服務端程式碼未要求的取消，或用戶端已不存在時，就會記錄 499 錯誤。 |
| 502 錯誤的閘道 | 如果在連線中輸入 HTTP 而非 HTTPS，就會發生此錯誤。 |
| 503 服務無法使用 | 此錯誤表示系統負載過重，因此目前無法處理要求。 重要： 在此情況下，強烈建議您的用戶端程式代碼回復，並在重試之前等候。 這可讓系統有時間復原，以增加未來之要求的成功機會。 快速重試要求只會讓這種情況持續下去。 如需節流和如何防止此狀況的詳細資訊，請參閱 分析效能 。 |
| 504：閘道逾時 | Azure AI 搜尋服務會接聽 HTTPS 埠 443。 如果您的搜尋服務 URL 包含 HTTP 而非 HTTPS，則會傳回 504 狀態碼。 |