Update Indexer (API REST di Ricerca intelligenza artificiale di Azure)
È possibile aggiornare una definizione dell'indicizzatore esistente usando una richiesta HTTP PUT. Specificare il nome dell'indicizzatore da aggiornare nell'URI della richiesta:
PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
L'aggiornamento di una definizione dell'indicizzatore non viene eseguito automaticamente, ma a seconda delle modifiche e dell'origine dati associata, potrebbe essere necessaria una reimpostazione e una ripetizione.
Parametri dell'URI
| Parametro | Descrizione |
|---|---|
| nome servizio | Obbligatorio. Impostare questo valore sul nome univoco definito dall'utente del servizio di ricerca. |
| nome indicizzatore | Obbligatorio. L'URI della richiesta specifica il nome dell'indicizzatore da aggiornare. |
| api-version | Obbligatorio. La versione stabile corrente è api-version=2020-06-30. Per altre versioni, vedere Versioni API . |
Intestazioni richiesta
La tabella seguente descrive le intestazioni della richiesta obbligatorie e facoltative.
| Campi | Descrizione |
|---|---|
| Content-Type | Obbligatorio. Impostare il valore su application/json |
| api-key | Facoltativo se si usano ruoli di Azure e viene fornito un token di connessione nella richiesta, altrimenti è necessaria una chiave. Una chiave API è una stringa univoca generata dal sistema che autentica la richiesta al servizio di ricerca. Le richieste di aggiornamento devono includere un'intestazione api-key impostata sulla chiave di amministrazione anziché su una chiave di query. Per informazioni dettagliate, vedere Connettersi a Ricerca intelligenza artificiale di Azure usando l'autenticazione delle chiavi . |
Corpo della richiesta
La sintassi del corpo della richiesta è uguale a quella di Create Indexer.
Quando si aggiorna un indicizzatore esistente, l'intera definizione viene sostituita con il contenuto del corpo della richiesta. In generale, il modello migliore da usare per gli aggiornamenti consiste nel recuperare la definizione dell'indicizzatore con un get, modificarlo e quindi aggiornarlo con PUT.
Risposta
Se la richiesta ha esito positivo, viene restituito il codice di stato 201 - Creato se è stato creato un nuovo indicizzatore, e il codice di stato 204 - Nessun contenuto se è stato aggiornato un indicizzatore esistente.