Uppdatera indexeraren (REST API för Azure AI Search)
Du kan uppdatera en befintlig indexeraredefinition med hjälp av en HTTP PUT-begäran. Ange namnet på indexeraren som ska uppdateras på begärande-URI:n:
PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
När du uppdaterar en indexerardefinition körs den inte automatiskt, men beroende på dina ändringar och den associerade datakällan kan en återställning och omkörning krävas.
URI-parametrar
Parameter | Beskrivning |
---|---|
tjänstnamn | Krävs. Ange det unika, användardefinierade namnet på söktjänsten. |
indexerarens namn | Krävs. Begärande-URI anger namnet på indexeraren som ska uppdateras. |
api-version | Krävs. Den aktuella stabila versionen är api-version=2020-06-30 . Fler versioner finns i API-versioner . |
Rubriker för begäran
I följande tabell beskrivs de obligatoriska och valfria begärandehuvudena.
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 i 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 som är 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 samma som för Skapa indexerare.
När du uppdaterar en befintlig indexerare 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 indexerarens definition med en GET, ändra den och sedan uppdatera den med PUT.
Svarsåtgärder
För en lyckad begäran: 201 Skapad om en ny indexerare skapades och 204 Inget innehåll om en befintlig indexerare uppdaterades.