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.

Lásd még