Datenquelle aktualisieren (Azure Cognitive Search REST-API)

Artikel
01/10/2023
2 Minuten Lesedauer

Ü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 Erforderlich. api-key wird zum Authentifizieren der Anforderung beim Search-Dienst verwendet. Es handelt sich um einen für Ihren Dienst eindeutigen Zeichenfolgewert. Updateanforderungen müssen einen api-key Header enthalten, der auf Ihren Administratorschlüssel (im Gegensatz zu einem Abfrageschlüssel) festgelegt ist. Sie finden den API-Schlüssel in Ihrem Suchdienstdashboard im Azure-Portal.

Felder	BESCHREIBUNG
Content-Type	Erforderlich. Auf `application/json`
api-key	Erforderlich. `api-key` wird zum Authentifizieren der Anforderung beim Search-Dienst verwendet. Es handelt sich um einen für Ihren Dienst eindeutigen Zeichenfolgewert. Updateanforderungen müssen einen `api-key` Header enthalten, der auf Ihren Administratorschlüssel (im Gegensatz zu einem Abfrageschlüssel) festgelegt ist. Sie finden den API-Schlüssel in Ihrem Suchdienstdashboard im Azure-Portal.

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.