Aktualizace zdroje dat (rozhraní REST API služby Azure AI Search)
Přepíše existující definici zdroje dat upravenou verzí.
PUT https://[service name].search.windows.net/datasources/[data source name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
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 zdroje dat | Povinná hodnota. Identifikátor URI požadavku určuje název zdroje dat, 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 Vytvořit zdroj dat.
Při aktualizaci existujícího zdroje dat se celá definice nahradí obsahem textu požadavku. Obecně platí, že nejlepší způsob, jak použít pro aktualizace, je načíst definici zdroje dat pomocí GET, upravit ji a pak ji aktualizovat pomocí PUT.
Odpověď
Pro úspěšný požadavek: 201 Vytvořeno, pokud byl vytvořen nový zdroj dat, a 204 Žádný obsah, pokud se aktualizoval existující zdroj dat.
Poznámka
Některé vlastnosti nelze aktualizovat u existujícího zdroje dat. Nemůžete například změnit typ existujícího zdroje dat.