HTTP-állapotkódok (Azure AI Search)
Ez a lap az Azure AI Search API használatakor gyakran visszaadott HTTP-állapotkódokat ismerteti.
Gyakori HTTP-állapotkódok
Code | Description |
---|---|
200 OK | Sikeres a GET, a PUT vagy a POST. Sikeres válasz céljából visszaadva. Az indexelés során ez a kód azt jelzi, hogy az összes elem tartósan lett tárolva, és elkezdi indexelni. Az indexelés a háttérben fut, és az indexelési művelet befejezése után néhány másodperccel lekérdezhetővé és kereshetővé teszi az új dokumentumokat. |
201 Létrehozva | Siker a PUT vagy a POST rendszeren. Az objektum létrehozása vagy frissítése sikerült. |
204 Elfogadva | Siker a PUT vagy a POST rendszeren. Az indexelés vagy a dokumentumok feltöltése sikeresen megtörtént. |
207 Többállapotú | Részleges siker a PUT vagy a POST esetében. Egyes dokumentumok sikeresek voltak, de legalább egy sikertelen volt. |
400 Hibás kérelem | Akkor adja vissza, ha hiba van a kérelem URI-jában, fejléceiben vagy törzsében. A válasz törzse egy hibaüzenetet tartalmaz, amely elmagyarázza, hogy mi az adott probléma. |
403 – Tiltott | Érvénytelen API-kulcs átadásakor ad vissza. |
404 Nem található | Akkor adja vissza, ha egy erőforrás nem létezik a kiszolgálón. Ha indexet kezel vagy kérdez le, ellenőrizze a szintaxist, és ellenőrizze, hogy az index neve helyesen van-e megadva. |
A 405-ös metódus nem támogatott | Akkor adja vissza, ha a kérelem egy felismert, de nem támogatott metódust ad meg. Ha indexet kérdez le, a kérés megfogalmazása magában foglalja a végpontot, az indexgyűjteményt és az indexet, valamint a dokumentumgyűjteményt és a keresési módszert (például https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30 ). |
409 Ütközés | Az írási műveletek ütközése esetén ad vissza. Ez a hiba erőforrás-frissítések esetén vagy indexelés közben jelenik meg, amikor két folyamat egyszerre próbálja frissíteni ugyanazt a dokumentumot. Az Azure AI Search egyidejűségi felügyeletet biztosít az erőforrás-frissítésekhez. További információ: Egyidejűség kezelése az Azure AI Searchben. |
412 Az előfeltétel nem sikerült | Akkor adja vissza, ha egy If-Match vagy a Ha-None-Match fejléc állapota hamisnak számít. Az indexdefiníciók, indexelők vagy adatforrások HTTP-kéréseinek küldésekor optimista egyidejűség-vezérléssel társítva. |
429 – Túl sok kérelem | Ha ez a hiba egy index létrehozásakor jelentkezik, az azt jelenti, hogy már rendelkezik a tarifacsomaghoz engedélyezett indexek maximális számával. Az Azure AI Searchben tárolt indexek száma látható a keresési szolgáltatás irányítópultján a Azure Portal. Az indexek név szerinti megtekintéséhez válassza az Index csempét. Az indexek listáját név szerint is lekérheti a Listaindexek művelettel. Részletekért lásd: Listaindexek .
Ha ez a hiba a dokumentum feltöltése során jelentkezik, az azt jelzi, hogy túllépte a kvótát az indexenkénti dokumentumok száma alapján. Létre kell hoznia egy új indexet, vagy frissítenie kell a magasabb kapacitáskorlátok érdekében. |
499 Ügyfél lezárt kérése | Ezt a hibát a rendszer soha nem adja vissza válaszként, de a keresési forgalomelemzés és az Azure Monitor által rögzített naplóbejegyzésekben is megjelenhet. Azt jelzi, hogy egy ügyfél lezárta a kapcsolatot, mielőtt a szolgáltatás válaszát visszaadta volna. Ha az Azure AI Search szolgáltatásoldali kód által nem kért lemondást észlel, vagy ha az ügyfél már nem létezik, a rendszer 499-ben hibát naplóz. |
502 Hibás átjáró | Ez a hiba akkor fordul elő, ha HTTPS helyett HTTP-t ír be a kapcsolatba. |
503 A szolgáltatás nem érhető el | Ez a hibaüzenet azt jelzi, hogy a rendszer terhelése nagy, és a kérés jelenleg nem dolgozható fel. Fontos: Ebben az esetben erősen javasoljuk, hogy az ügyfélkód vissza lépjen, és várjon az újrapróbálkozás előtt. Ezzel a rendszer számára időt ad a helyreállításra, így a jövőbeni kérések nagyobb eséllyel lesznek sikeresek. A gyors újrapróbálkozásokkal csupán az adott szituációt állandósítja. A szabályozással és a feltétel megelőzésének módjával kapcsolatos további információkért lásd: Teljesítmény elemzése . |
504: Átjáró időtúllépése | Az Azure AI Search a 443-os HTTPS-porton figyel. Ha a keresési szolgáltatás URL-címe HTTPS helyett HTTP-t tartalmaz, a rendszer 504-ös állapotkódot ad vissza. |