Uppdatera indexeraren (REST API för Azure AI Search)

  • Artikel

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.

Se även