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 | Description |
|---|---|
| 200 OK | Úspěch na GET, PUT nebo POST. Vráceno pro úspěšnou odpověď. Během indexování tento kód označuje, že všechny položky byly uloženy trvale a začnou se indexovat. Indexování běží na pozadí a umožňuje dotazování a prohledávání nových dokumentů několik sekund po dokončení operace indexování. |
| 201 Vytvořeno | Úspěch na PUT nebo POST. Objekt byl úspěšně vytvořen nebo aktualizován. |
| 204 Přijato | Úspěch na PUT nebo POST. Index nebo dokumenty se úspěšně nahrály. |
| 207 Multi-Status | Částečný úspěch pro PUT nebo POST. Některé dokumenty byly úspěšné, ale alespoň jeden z nich selhal. |
| 400 – Chybný požadavek | Vrátí se, když dojde k chybě v identifikátoru URI požadavku, hlavičkách nebo textu požadavku. Text odpovědi obsahuje chybovou zprávu s vysvětlením konkrétního problému. |
| 403 – Zakázáno | Vrátí se, když předáte neplatný klíč api-key. |
| 404 Nenalezeno | Vrátí se, když prostředek na serveru neexistuje. Pokud spravujete nebo dotazujete index, zkontrolujte syntaxi a ověřte, že je název indexu správně zadaný. |
| Metoda 405 není podporována. | Vrátí se, když požadavek určuje metodu, která se rozpozná, ale nepodporuje. Pokud dotazujete index, formulace tohoto požadavku zahrnuje koncový bod, kolekci indexů a indexy, kolekci dokumentů a metodu vyhledávání (například https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30). |
| 409 – Konflikt | Vrátí se při konfliktu operací zápisu. Tato chyba se vrátí při aktualizacích 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 se nezdařila | Vrátí se, když se podmínka hlavičky If-Match nebo If-None-Match vyhodnotí jako false. Souvisí s používáním optimistického řízení souběžnosti při odesílání požadavků HTTP pro definice indexů, indexery nebo zdroje dat. |
| 429 – Příliš mnoho požadavků | Pokud k této chybě dojde při pokusu o vytvoření indexu, znamená to, že už máte maximální povolený počet indexů pro vaši cenovou úroveň. Počet indexů uložených ve službě Azure AI Search se zobrazuje na řídicím panelu vyhledávací služby na Azure Portal. Pokud chcete zobrazit indexy podle názvu, vyberte dlaždici Index . Případně můžete také získat seznam indexů podle názvu pomocí operace List Indexes (Seznam indexů ). Podrobnosti najdete v tématu Výpis indexů . Pokud k této chybě dojde během nahrávání dokumentu, znamená to, že jste překročili kvótu počtu dokumentů na index. Musíte buď vytvořit nový index, nebo upgradovat kvůli vyšším limitům kapacity. |
| 499 – Uzavřená žádost klienta | Tato chyba se v odpovědi nikdy nevrátí, ale může se zobrazit v položkách 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é kód na straně služby nevyžádá nebo že klient už neexistuje, zaprotokoluje se chyba 499. |
| 502 – Chybná brána | K této chybě dochází, když v připojení místo HTTPS zadáte PROTOKOL HTTP. |
| 503 – Nedostupná služba | Tato chyba znamená, že je systém velmi zatížen a váš požadavek nelze v tuto chvíli zpracovat. Důležité: V takovém případě důrazně doporučujeme, aby váš klientský kód couvnul a před opakováním vyčkal. Systému tak poskytnete čas k obnovení, což zvýší šanci na úspěšné provedení dalších požadavků. Rychlé opakování požadavků pouze prodlouží situaci. Další informace o omezování a o tom, jak této podmínce zabránit, najdete v tématu Analýza výkonu . |
| 504: Vypršení časového limitu brány | Azure AI Search naslouchá na portu HTTPS 443. Pokud adresa URL vyhledávací služby obsahuje HTTP místo HTTPS, vrátí se stavový kód 504. |