Aktualizowanie źródła danych (interfejs API REST usługi Azure AI Search)
Zastępuje istniejącą definicję źródła danych poprawioną wersją.
PUT https://[service name].search.windows.net/datasources/[data source name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Parametry identyfikatora URI
| Parametr | Opis |
|---|---|
| nazwa usługi | Wymagane. Ustaw tę wartość na unikatową, zdefiniowaną przez użytkownika nazwę usługi wyszukiwania. |
| nazwa źródła danych | Wymagane. Identyfikator URI żądania określa nazwę źródła danych 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 dostarczany w żądaniu, w przeciwnym razie wymagany jest klucz. Api-key to unikatowy ciąg generowany przez system, 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 źródła danych.
Podczas aktualizowania istniejącego źródła danych 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 źródła danych za pomocą metody GET, zmodyfikowanie jej, a następnie zaktualizowanie jej za pomocą instrukcji PUT.
Reakcja
W przypadku pomyślnego żądania: 201 Utworzono, jeśli utworzono nowe źródło danych, i 204 Brak zawartości, jeśli istniejące źródło danych zostało zaktualizowane
Uwaga
Niektórych właściwości nie można zaktualizować w istniejącym źródle danych. Na przykład nie można zmienić typu istniejącego źródła danych.