Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Sovrascrive una definizione di mappa sinonimo esistente con una versione modificata.
PUT https://[service name].search.windows.net/synonymmaps/[synonymmap name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
Parametri dell'URI
| Parametro | Descrizione |
|---|---|
| nome servizio | Obbligatorio. Impostare questo valore sul nome univoco definito dall'utente del servizio di ricerca. |
| nome mappa sinonimo | Obbligatorio. L'URI della richiesta specifica il nome della mappa sinonimo 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 Synonym Map.
Quando si aggiorna una mappa sinonimo 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 con un GET, modificarlo e quindi aggiornarlo con PUT.
Risposta
Per una richiesta riuscita, "201 Create" se è stata creata una nuova mappa sinonimia e "204 No Content" se è stata aggiornata una mappa sinonimo esistente
Per impostazione predefinita, il corpo della risposta è vuoto. Tuttavia, se l'intestazione della Prefer richiesta è impostata su return=representation, il corpo della risposta conterrà il codice JSON per la mappa sinonimia aggiornata o creata. In questo caso, il codice di stato dell'esito positivo sarà "201 Create" se è stata creata una nuova mappa sinonimia e "200 OK" se è stata aggiornata una mappa sinonimia esistente.