Alaphelyzetbe állítási képességek (ELŐZETES REST API)
A következőre vonatkozik: 2023-07-01-Preview, 2021-04-30-Preview, 2020-06-30-Preview
Fontos
2023-07-01-Preview (nincs változás).
2021-04-30-Preview (nincs változás).
2020-06-30-Preview hozzáadja az API-t. Támogatja a gyorsítótárazott bővítéseket és az alaphelyzetbe á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épességet a következő indexelő futtatásakor. Olyan indexelők esetében, amelyeken engedélyezve van a gyorsítótárazás, 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, ezzel az API-val újrafuttathatja a képességet. Az olyan kimenetek, mint 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égcsoportot egy HTTP POST használatával alaphelyzetbe állíthat, és megadhatja annak a képességcsoportnak 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 | Kötelező. Állítsa be ezt a keresési szolgáltatás egyedi, felhasználó által definiált nevére. |
| képességkészlet neve | Kötelező. A kérés URI-ja megadja az alaphelyzetbe állítani kívánt képességcsoport nevét. |
| api-verzió | Kötelező. Az aktuális előzetes verzió: 2023-07-01-Preview. További verziókért lásd: API-verziók . |
Kérelemfejlécek
Az alábbi táblázat a szükséges és nem kötelező kérésfejléceket ismerteti.
| Mezők | Description |
|---|---|
| Content-Type | Kötelező. Állítsa a következőre: 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 kérést a keresési szolgáltatásnak. Az alaphelyzetbe állítási kérelmeknek tartalmazniuk kell egy api-key fejlécet a rendszergazdai kulcshoz (nem lekérdezési kulcshoz). A részletekért lásd: Csatlakozás az Azure AI Search szolgáltatáshoz kulcshitelesítés használatával . |
Kérelem törzse
A kérelem törzse a képességnevek tömbje.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Reagálás
Állapotkód: 204 Nincs tartalom a sikeres válaszhoz.