HTTP-állapotkódok (Azure AI Search)

Ez az oldal az Azure AI Search REST API-k használatakor gyakran visszaadott HTTP-állapotkódokat ismerteti.

Gyakori HTTP-állapotkódok

Kód	Leírás
200 OK	Siker a GET, PUT vagy POST rendszeren. Sikeres válaszért visszaadva.
201 Létrehozva	Siker a PUT vagy POST rendszeren. Az objektum létrehozása sikeresen megtörtént.
202 Elfogadva	Siker a PUT vagy POST rendszeren. A rendszer ezt az állapotkódot adja vissza az indexelő-kérelmek futtatásához.
204 Nincs tartalom	Siker a PUT vagy POST rendszeren. A frissítés sikeres volt, de a válaszban nincs visszaadandó információ.
206 Részleges tartalom	Részleges siker a GET vagy a POST szolgáltatásban a tudásbázis lekéréséhez az ügynöki lekérési munkafolyamatokban. Akkor adja vissza, ha a kérés sikeres volt, de a lekérési vagy rangsorolási folyamat bizonyos nem kritikus összetevői meghiúsultak, ami hiányos eredményekhez vagy rangsoroláshoz vezetett, amelyek esetleg nem tükrözik a teljes relevanciapontozást.
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érés	Akkor jelenik meg, ha hiba történt a kérelem URI-jában, fejléceiben vagy törzsében. A válasz törzse egy hibaüzenetet tartalmaz, amely ismerteti az adott problémát.
401 Nem engedélyezett	Akkor adja vissza, ha a hitelesítő adatok hiányoznak. Szerepköralapú hozzáférés-vezérlés használata esetén Ön vagy a keresőszolgáltatás nem rendelkezik szerepkör-hozzárendeléssel. Az Azure AI Search elérésével kapcsolatos problémákért lásd: Csatlakozás az Azure AI Searchhez szerepkörök használatával. További információ a más erőforrásokhoz való keresési kapcsolatokról: Keresési szolgáltatás konfigurálása felügyelt identitás használatával való csatlakozáshoz.
402 Fizetés szükséges	Akkor jelenik meg, ha az ingyenes szemantikai rangsorolási kérelmek havi kiosztása kimerült. A következő hibaüzenet is megjelenhet: "Az ingyenes lekérdezés szemantikai használata túllépte a hónapot. Engedélyezze a szemantikai számlázást a szemantikai keresés https://aka.ms/SemanticPriceDocPage"használatának folytatásához ;. A hiba elhárításához váltson az ingyenes csomagról a normál számlázásra.
403 – Hozzáférés megtagadva	A visszaadott érték, ha az engedélyezés sikertelen.
404 Nem található	Akkor adja vissza, ha egy erőforrás nem létezik a kiszolgálón.
A 405-ös módszer nem támogatott	Akkor adja vissza, ha a szolgáltatás felismer egy nem támogatott metódust. 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=2024-07-01).
409 Ütközés	Az írási műveletek ütközése esetén ad vissza. Ez az állapotkód erőforrás-frissítések esetén vagy indexeléskor jelenik meg, amikor két folyamat egyszerre próbálja frissíteni ugyanazt a dokumentumot. Az Azure AI Search egyidejűséget biztosít az erőforrás-frissítésekhez. További információ : Az egyidejűség kezelése az Azure AI Searchben.
412 Az előkondicionálás sikertelen	Akkor ad vissza, ha egy If-Match vagy If-None-Match fejléc állapota hamis. Optimista egyidejűség-vezérlés használata az indexdefiníciók, indexelők, képességkészletek vagy adatforrások HTTP-kéréseinek küldésekor.
415 Nem támogatott médiatípus	Ez a hiba akkor fordulhat elő, ha CURL vagy parancssori műveleteket használsz JSON továbbításához egy objektumdefinícióban vagy kérésben, és a kérés fejléce nem határozza meg alkalmazás/json tartalomtípusát. CURL-nél, ha a -d zászlót használod (ami alapértelmezettként ), x-www-form-urlencodedlecserélheted a --json zászlót a zászlóra (ami alapértelmezettként application/json), vagy hozzáadhatod a -H "Content-Type: application/json".
429 – Túl sok kérelem	Ha ezt az állapotkódot az objektum létrehozásakor kapja meg, az azt jelenti, hogy a szolgáltatásszinten engedélyezett objektumok maximális száma engedélyezett. Ha ezt a hibakódot egy aktív indexen kapja meg, az általában azt jelenti, hogy kevés a tárterület. A tárterületkorlátok közeledtével a szolgáltatás olyan állapotba léphet, amelyben nem vehet fel vagy nem frissíthet, amíg nem töröl néhány dokumentumot. További információ: Kapacitás megtervezése és kezelése , ha több tárhelyre van szüksége , vagy ha a dokumentumok törlésével szabadít fel helyet.
499 Ügyfél által lezárt kérelem	Ez az állapotkód soha nem jelenik meg válaszban, 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 az ügyfél már nem létezik, a rendszer naplózza a 499-et.
502 Hibás átjáró	Ez az állapotkód akkor fordul elő, ha HTTPS helyett HTTP-t ír be a kapcsolatba.
503 A szolgáltatás nem érhető el	Ez az állapotkód azt jelenti, hogy a rendszer nagy terhelés alatt áll, és a kérés nem dolgozható fel. A kockázatcsökkentések közé tartozik a várakozási idő hozzáadása az újrapróbálkozásra szolgáló logikához vagy a kapacitás növelése. Az újabb szolgáltatások automatikusan több tárolási és számítási teljesítménnyel járnak. A teljesítményhangolásról további információt az Azure AI Search teljesítményelemzése című témakörben talál.
504: Átjáró időtúllépése	Az Azure AI Search a 443-as HTTPS-porton figyel. Ha a keresési szolgáltatás URL-címe HTTPS helyett HTTP-t tartalmaz, a rendszer egy 504-ben megadott állapotkódot ad vissza.

Lásd még

• Azure AI Search REST API-k