Sdílet prostřednictvím

Stavové kódy HTTP (Azure AI Search)

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

Běžné stavové kódy HTTP

Kód 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.
207 Multi-Status Částečný úspěch pro 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.
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.
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é