Aktualizowanie indeksatora (interfejs API REST Azure Cognitive 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 Wymagane. Element api-key służy do uwierzytelniania żądania w usługa wyszukiwania. Jest to wartość ciągu unikatowa dla usługi. Żądania aktualizacji muszą zawierać api-key nagłówek ustawiony na klucz administratora (w przeciwieństwie do klucza zapytania). Klucz interfejsu API można znaleźć na pulpicie nawigacyjnym usługi wyszukiwania w Azure Portal.

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.

Zobacz też