Stavové kódy HTTP (Azure AI Search)

Tato stránka popisuje stavové kódy HTTP, které se často vracejí při použití rozhraní REST API služby Azure AI Search.

Běžné stavové kódy HTTP

Code	Popis
200 OK	Úspěch v GET, PUT nebo POST. Vráceno pro úspěšnou odpověď.
201 Vytvořeno	Úspěch v PUT nebo POST. Objekt byl úspěšně vytvořen.
202 Přijato	Úspěch v PUT nebo POST. Tento stavový kód se vrátí pro žádosti o spuštění indexeru.
204 Chybí obsah	Úspěch v PUT nebo POST. Aktualizace byla úspěšná, ale v odpovědi se nezobrazují žádné informace.
206 Částečný obsah	Částečný úspěch při GET nebo POST pro načítání znalostní báze v pracovních postupech agentického načítání. Vrátí se, když žádost proběhne úspěšně, ale některé nekritické součásti procesu načítání nebo řazení selžou, což vede k neúplným výsledkům nebo hodnocením, které nemusí odrážet úplné hodnocení relevance.
207 Multi-Stav	Částečný úspěch na PUT nebo POST. Některé dokumenty byly úspěšné, ale alespoň jeden selhal.
400 – Chybný požadavek	Vrátí se, když v identifikátoru URI požadavku, hlavičkách nebo textu požadavku dojde k chybě. Text odpovědi obsahuje chybovou zprávu s vysvětlením konkrétního problému.
401 Neautorizováno	Vráceno, když chybí přihlašovací údaje. Pokud používáte řízení přístupu na základě role, vy nebo vyhledávací služba chybí přiřazení role. Problémy s přístupem ke službě Azure AI Search najdete v tématu Připojení k Azure AI Search pomocí rolí. Další informace o připojeních vyhledávání k jiným prostředkům najdete v tématu Konfigurace vyhledávací služby pro připojení pomocí spravované identity.
402 Je vyžadována platba	Vrátí se po vyčerpání měsíčního přídělu bezplatných požadavků na sémantické řazení. Může se také zobrazit tato chyba: "Sémantické využití bezplatných dotazů bylo překročeno za měsíc. Povolte sémantickou fakturaci, abyste mohli dál používat sémantické vyhledávání https://aka.ms/SemanticPriceDocPage". Chcete-li chybu vyřešit, přejděte z bezplatného plánu na standardní fakturaci.
403 Zakázáno	Vráceno, když autorizace selže.
404 Nenalezena	Vrátí se, když prostředek na serveru neexistuje.
Metoda 405 není podporována.	Vráceno, když služba rozpozná nepodporovanou metodu. Pokud dotazujete index, formulace tohoto požadavku zahrnuje koncový bod, kolekci indexů a index a kolekci dokumentů a metodu vyhledávání (například https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01).
409 – Konflikt	Vráceno při konfliktu operací zápisu. Tento stavový kód se vrátí pro aktualizace prostředků nebo při indexování, když se dva procesy pokusí aktualizovat stejný dokument současně. Azure AI Search poskytuje správu souběžnosti pro aktualizace prostředků. Další informace najdete v tématu Správa souběžnosti ve službě Azure AI Search.
412 Předběžná podmínka selhala	Vrátí se, když se podmínka hlavičky If-Match nebo IfNone-Match vyhodnotí jako nepravda. Přidružené k používání optimistického řízení souběžnosti při odesílání požadavků HTTP na definice indexu, indexery, sady dovedností nebo zdroje dat.
415 Nepodporovaný typ média	Tato chyba může nastat, pokud používáte CURL nebo příkazové akce k předání JSON v definici objektu nebo požadavku a hlavička požadavku nespecifikuje typ obsahu aplikace/jsonu. Pro CURL, pokud použijete -d příznak (který je výchozí na x-www-form-urlencoded), můžete tento příznak nahradit příznakem --json (který se výchozím nastavením používá na application/json), nebo přidat .-H "Content-Type: application/json"
429 – Příliš mnoho požadavků	Pokud tento stavový kód získáte během vytváření objektu, znamená to, že máte povolený maximální počet objektů pro vaši úroveň služby. Pokud se zobrazí tento kód chyby v aktivním indexu, obvykle to znamená, že máte málo úložiště. Když se blížíte limitům úložiště, může služba zadat stav, ve kterém nemůžete přidávat ani aktualizovat, dokud neodstraníte některé dokumenty. Další informace najdete v tématu Plánování a správa kapacity , pokud chcete mít větší úložiště nebo aktualizovat obsah , pokud chcete uvolnit místo odstraněním dokumentů.
499 Klient zavřený požadavek	Tento stavový kód se nikdy nevrátí v odpovědi, ale může se zobrazit v záznamech protokolu zaznamenaných analýzou provozu vyhledávání a službou Azure Monitor. Označuje, že klient ukončil připojení před vrácením odpovědi službou. Když Azure AI Search zjistí zrušení, které nebylo požadováno kódem na straně služby nebo že klient už neexistuje, protokoluje se 499.
502 – Chybná brána	Tento stavový kód nastane, když do připojení zadáte místo HTTPS protokol HTTP.
503 Služba není k dispozici	Tento stavový kód znamená, že systém je zatížený velkým zatížením a váš požadavek nejde zpracovat. Omezení rizik zahrnují přidání doby čekání do jakékoli logiky opakování nebo zvýšení kapacity. Novější služby jsou automaticky vybaveny větším úložištěm a výpočetním výkonem. Další informace o ladění výkonu najdete v tématu Analýza výkonu ve službě Azure AI Search.
504: Vypršení časového limitu brány	Azure AI Search naslouchá na portu HTTPS 443. Pokud adresa URL vyhledávací služby obsahuje místo HTTPS protokol HTTP, vrátí se stavový kód 504.

Viz také

• Rozhraní REST API služby Azure AI Search