Indexelő frissítése (Azure AI Search REST API)
Egy meglévő indexelődefiníciót HTTP PUT kéréssel frissíthet. Adja meg a kérelem URI-ján frissíteni kívánt indexelő nevét:
PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Az indexelődefiníció frissítése nem futtatja automatikusan, de a módosításoktól és a hozzá tartozó adatforrástól függően szükség lehet egy alaphelyzetbe állításra és újrafuttatásra.
URI-paraméterek
Paraméter | Leírás |
---|---|
szolgáltatásnév | Kötelező. Állítsa be ezt a keresési szolgáltatás egyedi, felhasználó által definiált nevére. |
indexelő neve | Kötelező. A kérelem URI-ja megadja a frissíteni kívánt indexelő nevét. |
api-verzió | Kötelező. A jelenlegi stabil verzió a következő api-version=2020-06-30 : . További verziókért lásd: API-verziók . |
Kérelemfejlécek
Az alábbi táblázat a szükséges és nem kötelező kérésfejléceket ismerteti.
Mezők | Description |
---|---|
Content-Type | Kötelező. Állítsa a következőre: application/json |
api-key | Nem kötelező , ha Azure-szerepköröket használ, és egy tulajdonosi jogkivonatot ad meg a kéréshez, ellenkező esetben kulcsra van szükség. Az API-kulcs egy egyedi, rendszer által generált sztring, amely hitelesíti a kérést a keresési szolgáltatásnak. A frissítési kérelmeknek tartalmazniuk kell egy api-key , a rendszergazdai kulcsra beállított fejlécet (a lekérdezési kulcs helyett). A részletekért lásd: Csatlakozás az Azure AI Search szolgáltatáshoz kulcshitelesítés használatával . |
Kérelem törzse
A kérelemtörzs szintaxisa megegyezik az Indexelő létrehozása szintaxisával.
Meglévő indexelő frissítésekor a rendszer a teljes definíciót a kérelemtörzs tartalmára cseréli. A frissítésekhez általában az a legjobb módszer, ha lekéri az indexelő definícióját egy GET paranccsal, módosítja, majd a PUT paranccsal frissíti.
Reagálás
Sikeres kérés esetén: 201 Új indexelő létrehozása esetén létrehozva, és 204 Nincs tartalom, ha egy meglévő indexelő frissült.