Gegevensbron bijwerken (Azure AI Search REST API)
Hiermee overschrijft u een bestaande gegevensbrondefinitie met een herziene versie.
PUT https://[service name].search.windows.net/datasources/[data source name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
URI-parameters
Parameter | Beschrijving |
---|---|
servicenaam | Vereist. Stel deze in op de unieke, door de gebruiker gedefinieerde naam van uw zoekservice. |
naam van gegevensbron | Vereist. De aanvraag-URI geeft de naam op van de gegevensbron die moet worden bijgewerkt. |
api-versie | Vereist. De huidige stabiele versie is api-version=2020-06-30 . Zie API-versies voor meer versies. |
Aanvraagheaders
In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.
Velden | Description |
---|---|
Content-Type | Vereist. Stel dit in op application/json |
api-sleutel | Optioneel als u Azure-rollen gebruikt en er een bearer-token wordt opgegeven voor de aanvraag, anders is een sleutel vereist. Een API-sleutel is een unieke, door het systeem gegenereerde tekenreeks die de aanvraag verifieert bij uw zoekservice. Bijwerkaanvragen moeten een api-key header bevatten die is ingesteld op uw beheerderssleutel (in plaats van een querysleutel). Zie Verbinding maken met Azure AI Search met behulp van sleutelverificatie voor meer informatie. |
Aanvraagbody
De syntaxis van de aanvraagtekst is hetzelfde als voor Gegevensbron maken.
Bij het bijwerken van een bestaande gegevensbron wordt de volledige definitie vervangen door de inhoud van de aanvraagbody. Over het algemeen is het beste patroon voor updates om de definitie van de gegevensbron op te halen met een GET, deze te wijzigen en vervolgens bij te werken met PUT.
Antwoord
Voor een geslaagde aanvraag: 201 Gemaakt als er een nieuwe gegevensbron is gemaakt en 204 Geen inhoud als een bestaande gegevensbron is bijgewerkt
Notitie
Sommige eigenschappen kunnen niet worden bijgewerkt voor een bestaande gegevensbron. U kunt bijvoorbeeld het type van een bestaande gegevensbron niet wijzigen.