Vaardigheden opnieuw instellen (preview-REST API)
Van toepassing op: 2023-07-01-Preview, 2021-04-30-Preview, 2020-06-30-Preview
Belangrijk
2023-07-01-Preview (geen wijzigingen).
2021-04-30-Preview (geen wijzigingen).
2020-06-30-Preview voegt de API toe. Het ondersteunt verrijkingen in de cache en scenario's voor opnieuw instellen.
De aanvraag Vaardigheden opnieuw instellen verwerkt selectief een of meer vaardigheden bij de volgende indexeerfunctieuitvoering. Voor indexeerfuncties waarvoor caching is ingeschakeld, kunt u expliciet verwerking aanvragen voor vaardigheidsupdates die de indexeerfunctie niet kan detecteren. Als u bijvoorbeeld externe wijzigingen aanbrengt, zoals revisies in een aangepaste vaardigheid, kunt u deze API gebruiken om de vaardigheid opnieuw uit te voeren. Uitvoer, zoals een kennisarchief of zoekindex, wordt vernieuwd met herbruikbare gegevens uit de cache en nieuwe inhoud volgens de bijgewerkte vaardigheid.
U kunt een bestaande vaardighedenset opnieuw instellen met behulp van een HTTP POST, waarbij u de naam opgeeft van de vaardighedenset die moet worden bijgewerkt voor de aanvraag-URI.
POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
URI-parameters
| Parameter | Beschrijving |
|---|---|
| servicenaam | Vereist. Stel deze in op de unieke, door de gebruiker gedefinieerde naam van uw zoekservice. |
| naam van vaardighedenset | Vereist. De aanvraag-URI geeft de naam op van de vaardighedenset die opnieuw moet worden ingesteld. |
| api-versie | Vereist. De huidige preview-versie is 2023-07-01-Preview. Zie API-versies voor meer versies. |
Aanvraagheaders
In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.
| Velden | Description |
|---|---|
| Content-Type | Vereist. Stel dit in op application/json |
| api-sleutel | Optioneel als u Azure-rollen gebruikt en er een bearer-token wordt opgegeven voor de aanvraag, anders is een sleutel vereist. Een API-sleutel is een unieke, door het systeem gegenereerde tekenreeks die de aanvraag verifieert bij uw zoekservice. Aanvragen voor opnieuw instellen moeten een api-key header bevatten die is ingesteld op uw beheerderssleutel (in plaats van een querysleutel). Zie Verbinding maken met Azure AI Search met behulp van sleutelverificatie voor meer informatie. |
Aanvraagbody
De hoofdtekst van de aanvraag is een matrix van vaardigheidsnamen.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Antwoord
Statuscode: 204 Geen inhoud voor een geslaagd antwoord.