Umiejętności resetowania (interfejs API REST w wersji zapoznawczej)
Dotyczy: 2023-07-01-Preview, 2021-04-30-Preview, 2020-06-30-Preview
Ważne
2023-07-01-Preview (brak zmian).
2021-04-30-Preview (bez zmian).
2020-06-30-Preview dodaje interfejs API. Obsługuje on buforowane wzbogacania i resetowania scenariuszy.
Żądanie resetowania umiejętności selektywnie przetwarza co najmniej jedną umiejętności w następnym przebiegu indeksatora. W przypadku indeksatorów z włączoną buforowaniem można jawnie zażądać przetwarzania aktualizacji umiejętności, których indeksator nie może wykryć. Jeśli na przykład wprowadzisz zmiany zewnętrzne, takie jak poprawki do umiejętności niestandardowych, możesz użyć tego interfejsu API do ponownego uruchomienia umiejętności. Dane wyjściowe, takie jak magazyn wiedzy lub indeks wyszukiwania, są odświeżane przy użyciu danych wielokrotnego użytku z pamięci podręcznej i nowej zawartości zgodnie ze zaktualizowaną umiejętnością.
Istniejącego zestawu umiejętności można zresetować przy użyciu żądania HTTP POST, określając nazwę zestawu umiejętności do zaktualizowania identyfikatora URI żądania.
POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?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 zestawu umiejętności | Wymagane. Identyfikator URI żądania określa nazwę zestawu umiejętności do zresetowania. |
| api-version | Wymagane. Bieżąca wersja zapoznawcza to 2023-07-01-Preview. 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 resetowania 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
Treść żądania jest tablicą nazw umiejętności.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Reakcja
Kod stanu: 204 Brak zawartości dla pomyślnej odpowiedzi.