此頁面描述使用 Azure AI 搜尋 API 時經常傳回的 HTTP 狀態代碼。
常見的 HTTP 狀態碼
| 程式碼 | 說明 |
|---|---|
| 200 確定 | GET、PUT 或 POST 的成功。 傳回成功回應。 |
| 201 已建立 | 在 PUT 或 POST 上成功。 已成功建立物件。 |
| 202 已接受 | 在 PUT 或 POST 上成功。 此狀態代碼會針對執行索引器要求傳回。 |
| 204 無內容 | 在 PUT 或 POST 上成功。 更新成功，但響應中沒有傳回的資訊。 |
| 207 多重狀態 | PUT 或 POST 的部分成功。 某些檔成功，但至少一個失敗。 |
| 400 錯誤的請求 | 當要求 URI、標頭或本文發生錯誤時傳回。 回應本文包含錯誤訊息，說明特定問題是什麼。 |
| 401 未經授權 | 認證遺失時傳回。 如果您使用角色型訪問控制，您或搜尋服務遺漏角色指派。 如需存取 Azure AI 搜尋的問題，請參閱 使用角色連線到 Azure AI 搜尋。 如需其他資源搜尋連線的詳細資訊，請參閱 設定搜尋服務以使用受控識別進行連線。 |
| 403 禁止存取 | 授權失敗時傳回。 |
| 404 找不到 | 當伺服器上沒有資源時傳回。 |
| 不支援 405 方法 | 當服務辨識不支援的方法時傳回。 如果您要查詢索引，該要求的公式會包含端點、索引集合和索引，以及 docs 集合和搜尋方法（例如 ， https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01。 |
| 409 衝突 | 寫入作業衝突時傳回。 當兩個進程嘗試同時更新同一份檔時，會傳回此狀態代碼以供資源更新，或在編製索引期間傳回。 Azure AI 搜尋提供資源更新的並行管理。 如需詳細資訊，請參閱 如何在 Azure AI 搜尋中管理並行。 |
| 412 前置條件失敗 | 當 If-Match 或 If-None-Match 標頭的條件評估為 false 時傳回。 在傳送索引定義、索引器、技能集或數據源的 HTTP 要求時，使用 開放式並行控制 建立關聯。 |
| 429 要求太多 | 如果您在建立對象期間取得此狀態代碼，表示服務層級允許 的物件數目上限 。 如果您在使用中索引上收到此錯誤碼，這通常表示您在記憶體上執行不足。 當您接近 記憶體限制時，服務可以進入一種狀態，直到您刪除某些檔，才能新增或更新。 如需詳細資訊，請參閱如果您想要更多記憶體來 規劃和管理容量 ，或如果您想要刪除檔來釋放空間， 請更新內容 。 |
| 499 用戶端已關閉要求 | 此狀態代碼永遠不會在回應中傳回，但您可能會在 搜尋使用分析 與 Azure 監視器所記錄的記錄專案中看到。 它表示客戶端在服務傳回回應之前關閉連線。 當 Azure AI 搜尋偵測到服務端程式代碼未要求取消，或用戶端已不存在時，會記錄 499。 |
| 502 錯誤的閘道 | 當您在連線中輸入 HTTP 而不是 HTTPS 時，就會發生此狀態代碼。 |
| 503 服務無法使用 | 此狀態代碼表示系統負載過重，且無法處理您的要求。 緩和措施包括將等候時間新增至任何重試邏輯或增加容量。 較新的服務會自動提供更多記憶體和運算能力。 如需效能微調的詳細資訊，請參閱 在 Azure AI 搜尋中分析效能。 |
| 504：閘道逾時 | Azure AI 搜尋會接聽 HTTPS 埠 443。 如果您的搜尋服務 URL 包含 HTTP 而非 HTTPS，則會傳回 504 狀態代碼。 |