Query Keys - Delete
Elimina la chiave di query specificata. A differenza delle chiavi di amministrazione, le chiavi di query non vengono rigenerate. Il processo di rigenerazione di una chiave di query consiste nell'eliminare e quindi ricrearlo. Restituisce 200 (OK) in caso di cancellazione con successo, 204 (Nessun contenuto) se il servizio esiste ma le chiavi di query non sono state trovate, o 404 (Non trovato) se il servizio non viene trovato. NOTA: Il comportamento di restituzione del 404 è incoerente con le linee guida ARM. I clienti dovrebbero aspettarsi una risposta 204 nelle versioni future ed evitare nuove dipendenze dalla risposta 404.
DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/deleteQueryKey/{key}?api-version=2025-05-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
key
|
path | True |
string |
Chiave di query da eliminare. Le chiavi di query vengono identificate in base al valore, non in base al nome. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
search
|
path | True |
string pattern: ^(?=.{2,60}$)[a-z0-9][a-z0-9]+(-[a-z0-9]+)*$ |
Nome del servizio Ricerca intelligenza artificiale di Azure associato al gruppo di risorse specificato. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Intestazione della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
Valore GUID generato dal client che identifica questa richiesta. Se specificato, verrà incluso nelle informazioni di risposta come modo per tenere traccia della richiesta. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
La richiesta ha avuto esito positivo. |
|
| 204 No Content |
Non è disponibile alcun contenuto da inviare per questa richiesta, ma le intestazioni possono essere utili. |
|
| 404 Not Found |
Il server non riesce a trovare la risorsa richiesta. |
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
SearchDeleteQueryKey
Esempio di richiesta
Risposta di esempio
Definizioni
| Nome | Descrizione |
|---|---|
|
Cloud |
Contiene informazioni su un errore dell'API. |
|
Cloud |
Descrive un particolare errore dell'API con un codice di errore e un messaggio. |
CloudError
Contiene informazioni su un errore dell'API.
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Descrive un particolare errore dell'API con un codice di errore e un messaggio. |
|
| message |
string |
Breve descrizione dell'errore che indica cosa è andato storto (per informazioni dettagliate/debug fare riferimento alla proprietà 'error.message'). |
CloudErrorBody
Descrive un particolare errore dell'API con un codice di errore e un messaggio.
| Nome | Tipo | Descrizione |
|---|---|---|
| code |
string |
Codice di errore che descrive più precisamente la condizione di errore rispetto a un codice di stato HTTP. Può essere usato per gestire casi di errore specifici a livello di codice. |
| details |
Contiene errori annidati correlati a questo errore. |
|
| message |
string |
Messaggio che descrive l'errore in dettaglio e fornisce informazioni di debug. |
| target |
string |
Destinazione dell'errore specifico, ad esempio il nome della proprietà in errore. |