Aktualizace indexeru (rozhraní REST API služby Azure AI Search)

  • Článek

Existující definici indexeru můžete aktualizovat pomocí požadavku HTTP PUT. Zadejte název indexeru, který se má aktualizovat v identifikátoru URI požadavku:

PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]  
    Content-Type: application/json  
    api-key: [admin key]

Aktualizace definice indexeru nespustí automaticky, ale v závislosti na vašich úpravách a přidruženém zdroji dat může být nutné resetovat a znovu spustit.

Parametry identifikátoru URI

Parametr Popis
název služby Povinná hodnota. Nastavte ho na jedinečný uživatelsky definovaný název vaší vyhledávací služby.
název indexeru Povinná hodnota. Identifikátor URI požadavku určuje název indexeru, který se má aktualizovat.
verze-api Povinná hodnota. Aktuální stabilní verze je api-version=2020-06-30. Další verze najdete v tématu Verze rozhraní API .

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Pole Description
Typ obsahu Povinná hodnota. Nastavte tuto možnost na application/json
api-key Volitelné, pokud používáte role Azure a v požadavku je k dispozici nosný token, jinak se vyžaduje klíč. Klíč api-key je jedinečný systémově vygenerovaný řetězec, který ověřuje požadavek pro vaši vyhledávací službu. Žádosti o aktualizaci musí obsahovat hlavičku nastavenou api-key na klíč správce (na rozdíl od klíče dotazu). Podrobnosti najdete v tématu Připojení ke službě Azure AI Search pomocí ověřování pomocí klíče .

Text požadavku

Syntaxe textu požadavku je stejná jako u příkazu Create Indexer.

Při aktualizaci existujícího indexeru se celá definice nahradí obsahem textu požadavku. Obecně platí, že nejlepší způsob, jak použít pro aktualizace, je načíst definici indexeru pomocí get, upravit ji a pak ji aktualizovat pomocí PUT.

Odpověď

Pro úspěšný požadavek: 201 Vytvořeno, pokud byl vytvořen nový indexer, a 204 Žádný obsah, pokud byl aktualizován existující indexer.

Viz také