Uppdatera datakälla (REST API för Azure AI Search)
Skriver över en befintlig datakällas definition med en reviderad 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-parametrar
Parameter | Beskrivning |
---|---|
tjänstnamn | Krävs. Ange det unika, användardefinierade namnet på söktjänsten. |
datakällans namn | Krävs. Begärande-URI anger namnet på den datakälla som ska uppdateras. |
api-version | Krävs. Den aktuella stabila versionen är api-version=2020-06-30 . Se API-versioner för fler versioner. |
Rubriker för begäran
I följande tabell beskrivs nödvändiga och valfria begärandehuvuden.
Fält | Description |
---|---|
Content-Type | Krävs. Ange detta till application/json |
api-key | Valfritt om du använder Azure-roller och en ägartoken anges på begäran, annars krävs en nyckel. En API-nyckel är en unik, systemgenererad sträng som autentiserar begäran till söktjänsten. Uppdateringsbegäranden måste innehålla en api-key rubrik inställd på din administratörsnyckel (till skillnad från en frågenyckel). Mer information finns i Ansluta till Azure AI Search med nyckelautentisering . |
Begärandetext
Syntaxen för begärandetexten är densamma som för Skapa datakälla.
När du uppdaterar en befintlig datakälla ersätts hela definitionen med innehållet i begärandetexten. I allmänhet är det bästa mönstret att använda för uppdateringar att hämta datakällans definition med en GET, ändra den och sedan uppdatera den med PUT.
Svarsåtgärder
För en lyckad begäran: 201 Skapades om en ny datakälla skapades och 204 Inget innehåll om en befintlig datakälla uppdaterades
Anteckning
Vissa egenskaper kan inte uppdateras på en befintlig datakälla. Du kan till exempel inte ändra typen av en befintlig datakälla.