Alaphelyzetbe állítási készségek (REST API előzetes verziója)
A következővonatkozik: 2023-07-01-Preview. Ez a verzió már nem támogatott. Frissítés azonnal egy újabb verzióra.
Fontos
2023-07-01-Preview (nincs változás).
2021-04-30-Preview (nincs változás).
A 2020-06-30-Preview hozzáadja az API-t. Támogatja gyorsítótárazott bővítési és visszaállítási forgatókönyveket.
A Készségek alaphelyzetbe állítása kérés szelektíven dolgoz fel egy vagy több készséget a következő indexelő futtatásakor. A gyorsítótárazással rendelkező indexelők esetében explicit módon kérheti a képességfrissítések feldolgozását, amelyeket az indexelő nem tud észlelni. Ha például külső módosításokat hajt végre, például egy egyéni képesség módosításait, akkor ezzel az API-val újrafuttathatja a készséget. A kimenetek, például a tudástár vagy a keresési index a gyorsítótárból származó újrafelhasználható adatokkal és a frissített képesség szerint új tartalommal frissülnek.
Egy meglévő képességkészlet et egy HTTP POST használatával állíthat vissza, megadva annak a képességkészletnek a nevét, amely frissíthető a kérelem URI-ján.
POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
URI-paraméterek
| Paraméter | Leírás |
|---|---|
| szolgáltatásnév | Szükséges. Állítsa be ezt a keresési szolgáltatás egyedi, felhasználó által megadott nevére. |
| készségkészlet neve | Szükséges. A kérés URI-ja megadja az alaphelyzetbe állítani kívánt képességkészlet nevét. |
| api-verzió | Szükséges. További verziókért lásd API-verziókat. |
Kérelemfejlécek
Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.
| Mezők | Leírás |
|---|---|
| Tartalomtípus | Szükséges. Állítsa be ezt a beállítást application/json |
| api-key | Nem kötelező, ha Azure-szerepköröket használ, és egy tulajdonosi jogkivonatot ad meg a kéréshez, ellenkező esetben kulcsra van szükség. Az API-kulcs egy egyedi, rendszer által generált sztring, amely hitelesíti a keresési szolgáltatásnak küldött kérést. Az alaphelyzetbe állítási kérelmeknek tartalmazniuk kell egy api-key fejlécet, amely a rendszergazdai kulcsra van állítva (a lekérdezési kulccsal szemben). A részletekért lásd: Csatlakozás az Azure AI Search szolgáltatáshoz kulcshitelesítési használatával. |
Kérelem törzse
A kérés törzse a képességnevek tömbje.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Válasz
Állapotkód: 204 Nincs tartalom a sikeres válaszhoz.