Kody stanu HTTP (Azure AI Search)
Na tej stronie opisano kody stanu HTTP, które są często zwracane podczas korzystania z interfejsu API usługi Azure AI Search.
Typowe kody stanu HTTP
| Kod | Opis |
|---|---|
| 200 OK | Powodzenie operacji GET, PUT lub POST. Zwrócone dla pomyślnej odpowiedzi. Podczas indeksowania ten kod wskazuje, że wszystkie elementy zostały trwale przechowywane i zaczną być indeksowane. Indeksowanie jest uruchamiane w tle i sprawia, że nowe dokumenty można wykonywać zapytania i przeszukiwać kilka sekund po zakończeniu operacji indeksowania. |
| Utworzono 201 | Powodzenie na PUT lub POST. Obiekt został utworzony lub zaktualizowany pomyślnie. |
| Zaakceptowano 204 | Powodzenie na PUT lub POST. Pomyślnie przekazano indeks lub dokumenty. |
| 207 — wiele stanów | Częściowy sukces put lub POST. Niektóre dokumenty zakończyły się pomyślnie, ale co najmniej jeden zakończył się niepowodzeniem. |
| 400 Nieprawidłowe żądanie | Zwracany w przypadku wystąpienia błędu w identyfikatorze URI żądania, nagłówkach lub treści. Treść odpowiedzi zawiera komunikat o błędzie wyjaśniający, jaki jest konkretny problem. |
| 403 Zabronione | Zwracany po przekazaniu nieprawidłowego klucza api-key. |
| 404 — Nie znaleziono | Zwracany, gdy zasób nie istnieje na serwerze. Jeśli zarządzasz indeksem lub wykonujesz względem tego zapytania, sprawdź składnię i sprawdź, czy nazwa indeksu jest poprawnie określona. |
| Metoda 405 nie jest obsługiwana | Zwracany, gdy żądanie określa rozpoznaną metodę, ale nie jest obsługiwana. Jeśli wykonujesz zapytanie dotyczące indeksu, sformułowanie tego żądania obejmuje punkt końcowy, kolekcję indeksów i indeks oraz kolekcję dokumentacji i metodę wyszukiwania (na przykład https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30). |
| 409 Konflikt | Zwracane w przypadku konfliktu operacji zapisu. Ten błąd jest zwracany w przypadku aktualizacji zasobów lub podczas indeksowania, gdy dwa procesy próbują jednocześnie zaktualizować ten sam dokument. Usługa Azure AI Search zapewnia zarządzanie współbieżnością aktualizacji zasobów. Aby uzyskać więcej informacji, zobacz Jak zarządzać współbieżnością w usłudze Azure AI Search. |
| 412 Warunek wstępny nie powiódł się | Zwracany, gdy warunek nagłówka If-Match lub If-None-Match zwraca wartość false. Skojarzone z użyciem optymistycznej kontrolki współbieżności podczas wysyłania żądań HTTP dla definicji indeksu, indeksatorów lub źródeł danych. |
| 429 Zbyt wiele żądań | Jeśli ten błąd wystąpi podczas próby utworzenia indeksu, oznacza to, że masz już maksymalną liczbę indeksów dozwolonych dla warstwy cenowej. Liczba indeksów przechowywanych w usłudze Azure AI Search jest widoczna na pulpicie nawigacyjnym usługi wyszukiwania na Azure Portal. Aby wyświetlić indeksy według nazwy, wybierz kafelek Indeks . Alternatywnie możesz również uzyskać listę indeksów według nazwy przy użyciu operacji Indeksy listy . Aby uzyskać szczegółowe informacje, zobacz Indeksy list .
Jeśli ten błąd wystąpi podczas przekazywania dokumentu, oznacza to, że przekroczono limit przydziału liczby dokumentów na indeks. Musisz utworzyć nowy indeks lub uaktualnić w celu uzyskania wyższych limitów pojemności. |
| 499 Zamknięte żądanie klienta | Ten błąd nigdy nie jest zwracany w odpowiedzi, ale może być widoczny w wpisach dziennika zarejestrowanych przez analizę ruchu wyszukiwania i usługę Azure Monitor. Wskazuje, że klient zamknął połączenie przed zwróceniem odpowiedzi przez usługę. Gdy usługa Azure AI Search wykryje anulowanie, którego nie zażądał kod po stronie usługi lub że klient już nie istnieje, jest rejestrowany błąd 499. |
| 502 — zła brama | Ten błąd występuje podczas wprowadzania protokołu HTTP zamiast HTTPS w połączeniu. |
| 503 — usługa niedostępna | Ten błąd oznacza, że system jest mocno obciążony i w tej chwili nie można przetworzyć żądania. Ważne: W takim przypadku zdecydowanie zalecamy, aby kod klienta został wycofany i czekał przed ponowieniu próby. Zapewni to systemowi dodatkowy czas na przetworzenie danych, co zwiększy prawdopodobieństwo pomyślnego wykonania przyszłych żądań. Szybkie ponawianie żądań tylko wydłuży czas trwania problemu. Zobacz Analizowanie wydajności , aby uzyskać więcej informacji na temat ograniczania przepustowości i sposobu zapobiegania temu warunku. |
| 504: Limit czasu bramy | Usługa Azure AI Search nasłuchuje na porcie HTTPS 443. Jeśli adres URL usługi wyszukiwania zawiera protokół HTTP zamiast HTTPS, zwracany jest kod stanu 504. |