Udostępnij za pośrednictwem

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.
201 Utworzono Powodzenie na PUT lub POST. Pomyślnie utworzono obiekt.
Zaakceptowano 202 Powodzenie na PUT lub POST. Ten kod stanu jest zwracany dla uruchomionych żądań indeksatora.
204 Brak zawartości Powodzenie na PUT lub POST. Aktualizacja zakończyła się pomyślnie, ale nie ma informacji, które należy zwrócić w odpowiedzi.
207 — wiele stanów Częściowy sukces put lub POST. Niektóre dokumenty zakończyły się pomyślnie, ale co najmniej jeden nie powiódł się.
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.
401 Brak autoryzacji Zwracane, gdy brakuje poświadczeń. Jeśli używasz kontroli dostępu opartej na rolach, brakuje przypisania roli lub usługi wyszukiwania. Aby uzyskać informacje o problemach z uzyskiwaniem dostępu do usługi Azure AI Search, zobacz Nawiązywanie połączenia z usługą Azure AI Search przy użyciu ról. Aby uzyskać więcej informacji na temat wyszukiwania połączeń z innymi zasobami, zobacz Konfigurowanie usługi wyszukiwania w celu nawiązania połączenia przy użyciu tożsamości zarządzanej.
403 Zabronione Zwracane, gdy autoryzacja kończy się niepowodzeniem.
404 Nie znaleziono Zwracany, gdy zasób nie istnieje na serwerze.
Metoda 405 nie jest obsługiwana Zwracany, gdy usługa rozpoznaje nieobsługiwaną metodę. Jeśli wykonujesz zapytanie dotyczące indeksu, sformułowanie tego żądania obejmuje punkt końcowy, kolekcję indeksów i indeks oraz kolekcję dokumentów i metodę wyszukiwania (na przykład https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01).
409 Konflikt Zwracany w przypadku konfliktu operacji zapisu. Ten kod stanu 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ą na potrzeby 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żywaniem optymistycznej kontrolki współbieżności podczas wysyłania żądań HTTP dla definicji indeksu, indeksatorów, zestawów umiejętności lub źródeł danych.
429 Zbyt wiele żądań Jeśli ten kod stanu zostanie wyświetlony podczas tworzenia obiektu, oznacza to, że maksymalna liczba obiektów dozwolonych dla warstwy usługi. Jeśli ten kod błędu jest wyświetlany w aktywnym indeksie, zwykle oznacza to, że brakuje miejsca do magazynowania. Gdy zbliżasz się do limitów magazynu, usługa może wprowadzić stan, w którym nie można dodać ani zaktualizować, dopóki nie usuniesz niektórych dokumentów. Aby uzyskać więcej informacji, zobacz Planowanie pojemności i zarządzanie nią , jeśli chcesz więcej miejsca do magazynowania lub Aktualizowanie zawartości , jeśli chcesz zwolnić miejsce, usuwając dokumenty.
499 — Zamknięte żądanie klienta Ten kod stanu 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 przez usługę odpowiedzi. Gdy usługa Azure AI Search wykryje anulowanie, które nie zostało żądane przez kod po stronie usługi lub że klient już nie istnieje, jest rejestrowany błąd 499.
502 Niewłaściwa brama Ten kod stanu występuje po wprowadzeniu protokołu HTTP zamiast HTTPS w połączeniu.
Usługa 503 jest niedostępna Ten kod stanu oznacza, że system jest obciążony dużym obciążeniem i nie można przetworzyć żądania. Środki zaradcze obejmują dodawanie czasów oczekiwania do dowolnej logiki ponawiania prób lub zwiększanie pojemności. Nowsze usługi są dostarczane automatycznie z większą ilością miejsca do magazynowania i mocy obliczeniowej. Aby uzyskać więcej informacji na temat dostrajania wydajności, zobacz Analizowanie wydajności w usłudze Azure AI Search.
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.

Zobacz też