Aktualizowanie indeksatora (interfejs API REST usługi Azure AI Search)
Możesz zaktualizować istniejącą definicję indeksatora przy użyciu żądania HTTP PUT. Określ nazwę indeksatora do zaktualizowania identyfikatora URI żądania:
PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Aktualizowanie definicji indeksatora nie jest uruchamiane automatycznie, ale w zależności od modyfikacji i skojarzonego źródła danych może być wymagane zresetowanie i ponowne uruchomienie.
Parametry identyfikatora URI
| Parametr | Opis |
|---|---|
| nazwa usługi | Wymagane. Ustaw tę wartość na unikatową, zdefiniowaną przez użytkownika nazwę usługi wyszukiwania. |
| nazwa indeksatora | Wymagane. Identyfikator URI żądania określa nazwę indeksatora do zaktualizowania. |
| api-version | Wymagane. Bieżąca stabilna wersja to api-version=2020-06-30. Zobacz Wersje interfejsu API , aby uzyskać więcej wersji. |
Nagłówki żądań
W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.
| Pola | Opis |
|---|---|
| Content-Type | Wymagane. Ustaw tę wartość na application/json |
| api-key | Opcjonalnie, jeśli używasz ról platformy Azure , a token elementu nośnego jest udostępniany w żądaniu, w przeciwnym razie wymagany jest klucz. Klucz api-key to unikatowy, generowany przez system ciąg, który uwierzytelnia żądanie w usłudze wyszukiwania. Żądania aktualizacji muszą zawierać api-key nagłówek ustawiony na klucz administratora (w przeciwieństwie do klucza zapytania). Aby uzyskać szczegółowe informacje, zobacz Nawiązywanie połączenia z usługą Azure AI Search przy użyciu uwierzytelniania klucza . |
Treść żądania
Składnia treści żądania jest taka sama jak w przypadku tworzenia indeksatora.
Podczas aktualizowania istniejącego indeksatora cała definicja jest zastępowana zawartością treści żądania. Ogólnie rzecz biorąc, najlepszym wzorcem do użycia w przypadku aktualizacji jest pobranie definicji indeksatora za pomocą polecenia GET, zmodyfikowanie go, a następnie zaktualizowanie go za pomocą funkcji PUT.
Reakcja
W przypadku pomyślnego żądania: 201 Utworzono, jeśli utworzono nowy indeksator, a 204 — brak zawartości, jeśli istniejący indeksator został zaktualizowany.