Zurücksetzen von Fähigkeiten (Vorschau-REST-API)
gilt für: 2023-07-01-Preview. Diese Version wird nicht mehr unterstützt. Upgrade sofort auf eine neuere Version.
Wichtig
2023-07-01-Preview (keine Änderungen).
2021-04-30-Preview (keine Änderungen).
2020-06-30-Preview fügt die API hinzu. Es unterstützt zwischengespeicherte Anreicherungen und Zurücksetzungsszenarien.
Die Zurücksetzen von Fähigkeiten Anforderung verarbeitet selektiv eine oder mehrere Fähigkeiten bei der nächsten Indizierungsausführung. Für Indexer, die das Zwischenspeichern aktiviert haben, können Sie explizit die Verarbeitung für Qualifikationsupdates anfordern, die der Indexer nicht erkennen kann. Wenn Sie z. B. externe Änderungen vornehmen, z. B. Überarbeitungen an einer benutzerdefinierten Fähigkeit, können Sie diese API verwenden, um die Fähigkeit erneut auszuführen. Ausgaben, z. B. ein Wissensspeicher oder Suchindex, werden mit wiederverwendbaren Daten aus dem Cache und neuen Inhalten pro aktualisierter Fähigkeit aktualisiert.
Sie können ein vorhandenes Skillset mithilfe eines HTTP POST zurücksetzen und den Namen des Skillsets angeben, der für den Anforderungs-URI aktualisiert werden soll.
POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
URI-Parameter
| Parameter | Beschreibung |
|---|---|
| Dienstname | Erforderlich. Legen Sie dies auf den eindeutigen, benutzerdefinierten Namen Ihres Suchdiensts fest. |
| Skillset-Name | Erforderlich. Der Anforderungs-URI gibt den Namen des zurückzusetzenden Skillsets an. |
| API-Version | Erforderlich. Weitere Versionen finden Sie unter API-Versionen. |
Anforderungsheader
In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader beschrieben.
| Felder | Beschreibung |
|---|---|
| Inhaltstyp | Erforderlich. Legen Sie dies auf application/json fest. |
| API-Schlüssel | Optional, wenn Sie Azure-Rollen verwenden und ein Bearertoken für die Anforderung bereitgestellt wird, andernfalls ist ein Schlüssel erforderlich. Ein API-Schlüssel ist eine eindeutige vom System generierte Zeichenfolge, die die Anforderung an Ihren Suchdienst authentifiziert. Zurücksetzungsanforderungen müssen einen api-key Header enthalten, der auf Ihren Administratorschlüssel festgelegt ist (im Gegensatz zu einem Abfrageschlüssel). Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Azure AI Search mithilfe der Schlüsselauthentifizierung. |
Anforderungstext
Der Textkörper der Anforderung ist eine Reihe von Qualifikationsnamen.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Antwort
Statuscode: 204 Kein Inhalt für eine erfolgreiche Antwort.