Aktualisieren des Indexers (Azure AI Search-REST-API)
Sie können eine vorhandene Indexerdefinition mithilfe einer HTTP PUT-Anforderung aktualisieren. Geben Sie den Namen des Indexers an, der für den Anforderungs-URI aktualisiert werden soll:
PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Das Aktualisieren einer Indexerdefinition wird nicht automatisch ausgeführt, aber abhängig von Ihren Änderungen und der zugeordneten Datenquelle ist möglicherweise ein Zurücksetzen und eine erneute Ausführung erforderlich.
URI-Parameter
Parameter | BESCHREIBUNG |
---|---|
Dienstname | Erforderlich. Legen Sie dies auf den eindeutigen, benutzerdefinierten Namen Ihres Suchdiensts fest. |
Indexername | Erforderlich. Der Anforderungs-URI gibt den Namen des zu aktualisierenden Indexers an. |
api-version | Erforderlich. Die aktuelle stabile Version ist api-version=2020-06-30 . 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 in der Anforderung ein Bearertoken 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. Updateanforderungen 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
Die Syntax des Anforderungstexts ist identisch mit der syntax für Create Indexer.
Beim Aktualisieren eines vorhandenen Indexers wird die gesamte Definition durch den Inhalt des Anforderungstexts ersetzt. Im Allgemeinen besteht das beste Muster für Updates darin, die Indexerdefinition mit einem GET abzurufen, zu ändern und dann mit PUT zu aktualisieren.
Antwort
Bei erfolgreicher Anforderung: "201 Erstellt", wenn ein neuer Indexer erstellt wurde; "204 Kein Inhalt", wenn eine vorhandener Indexer aktualisiert wurde.