Skills zurücksetzen (Vorschau-REST-API)
Gilt für: 2023-07-01-Preview, 2021-04-30-Preview, 2020-06-30-Preview
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 Anforderung "Skills zurücksetzen" verarbeitet selektiv eine oder mehrere Skills bei der nächsten Indexerausführung. Bei Indexern, für die das Zwischenspeichern aktiviert ist, können Sie explizit die Verarbeitung für Qualifikationsupdates anfordern, die der Indexer nicht erkennen kann. Wenn Sie z. B. externe Änderungen wie Überarbeitungen an einer benutzerdefinierten Qualifikation vornehmen, können Sie diese API verwenden, um die Qualifikation erneut auszuführen. Ausgaben, wie z. B. ein Wissensspeicher oder ein Suchindex, werden mit wiederverwendbaren Daten aus dem Cache und neuen Inhalten gemäß der aktualisierten Qualifikation aktualisiert.
Sie können ein vorhandenes Skillset mithilfe eines HTTP POST zurücksetzen, indem Sie den Namen des Skillsets angeben, das 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. |
| Skillsetname | Erforderlich. Der Anforderungs-URI gibt den Namen des zurückzusetzenden Skillsets an. |
| api-version | Erforderlich. Die aktuelle Vorschauversion ist 2023-07-01-Preview. Weitere Versionen finden Sie unter API-Versionen . |
Anforderungsheader
Die folgende Tabelle beschreibt die erforderlichen und optionalen Anforderungsheader.
| Felder | BESCHREIBUNG |
|---|---|
| Content-Type | Erforderlich. Auf application/json |
| api-key | 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 bei Ihrem Suchdienst authentifiziert. Zurücksetzungsanforderungen müssen einen api-key Header enthalten, der auf Ihren Administratorschlüssel (im Gegensatz zu einem Abfrageschlüssel) festgelegt ist. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit Azure AI Search mithilfe der Schlüsselauthentifizierung . |
Anforderungstext
Bei dem Anforderungstext handelt es sich um ein Array von Qualifikationsnamen.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
Antwort
Statuscode "204 Kein Inhalt" bei erfolgreicher Antwort.