Datenquelle aktualisieren (Azure AI Search-REST-API)
Überschreibt eine vorhandene Datenquellendefinition mit einer überarbeiteten Version.
PUT https://[service name].search.windows.net/datasources/[data source name]?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. |
| Datenquellenname (data source name) | Erforderlich. Der Anforderungs-URI gibt den Namen der zu aktualisierenden Datenquelle 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 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. 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 Data Source.
Beim Aktualisieren einer vorhandenen Datenquelle wird die gesamte Definition durch den Inhalt des Anforderungstexts ersetzt. Im Allgemeinen besteht das beste Muster für Updates darin, die Datenquellendefinition mit einem GET abzurufen, sie zu ändern und sie dann mit PUT zu aktualisieren.
Antwort
Für eine erfolgreiche Anforderung: 201 Erstellt, wenn eine neue Datenquelle erstellt wurde, und 204 Kein Inhalt, wenn eine vorhandene Datenquelle aktualisiert wurde
Hinweis
Manche Eigenschaften vorhandener Datenquellen können nicht aktualisiert werden. Sie können z. B. nicht den Typ einer vorhandenen Datenquelle ändern.