Condividi tramite


Codici di stato HTTP (Ricerca intelligenza artificiale di Azure)

Questa pagina descrive i codici di stato HTTP restituiti di frequente quando si usa l'API Ricerca intelligenza artificiale di Azure.

Codici di stato HTTP comuni

Codice Descrizione
200 - OK Esito positivo per GET, PUT o POST. Restituito per una risposta riuscita. Durante l'indicizzazione, questo codice indica che tutti gli elementi sono stati archiviati in modo permanente e inizieranno a essere indicizzati. L'indicizzazione viene eseguita in background e rende i nuovi documenti queryabili e ricercabili pochi secondi dopo il completamento dell'operazione di indicizzazione.
201 Creato Esito positivo per PUT o POST. Oggetto creato o aggiornato correttamente.
204 Accepted Esito positivo per PUT o POST. Caricamento corretto di indice o documenti.
207 Multi-Status Esito parzialmente positivo per PUT o POST. Alcuni documenti hanno avuto esito positivo, ma almeno uno ha avuto esito negativo.
400 - Richiesta non valida Restituito quando si verifica un errore nell'URI della richiesta, nelle intestazioni o nel corpo. Il corpo della risposta contiene un messaggio di errore che spiega qual è il problema specifico.
403 - Accesso negato Restituito quando si passa un valore api-key non valido.
404 - Non trovato Restituito quando una risorsa non esiste nel server. Se si gestisce o si esegue una query su un indice, controllare la sintassi e verificare che il nome dell'indice sia specificato correttamente.
Metodo 405 non supportato Restituito quando la richiesta specifica un metodo riconosciuto, ma non supportato. Se si esegue una query su un indice, la formulazione di tale richiesta include l'endpoint, la raccolta e l'indice degli indici e la raccolta docs e il metodo di ricerca , ad esempio https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30.
409 - Conflitto Restituito quando le operazioni di scrittura sono in conflitto. Questo errore viene restituito per gli aggiornamenti delle risorse o durante l'indicizzazione quando due processi tentano di aggiornare lo stesso documento contemporaneamente. Ricerca di intelligenza artificiale di Azure offre la gestione della concorrenza per gli aggiornamenti delle risorse. Per altre informazioni, vedere Come gestire la concorrenza in Ricerca intelligenza artificiale di Azure.
412 - Condizione preliminare non riuscita Restituito quando una If-Match o la condizione dell'intestazione If-None-Match restituisce false. Associato all'uso del controllo della concorrenza ottimistica durante l'invio di richieste HTTP per definizioni di indice, indicizzatori o origini dati.
429 - Numero eccessivo di richieste Se questo errore si verifica durante il tentativo di creazione di un indice, significa che è già disponibile il numero massimo di indici consentiti per il piano tariffario. Un conteggio degli indici archiviati in Ricerca intelligenza artificiale di Azure è visibile nel dashboard del servizio di ricerca nel portale di Azure. Per visualizzare gli indici in base al nome, selezionare il riquadro Indice . In alternativa, è anche possibile ottenere un elenco degli indici in base al nome usando l'operazione Elenca indici . Per informazioni dettagliate, vedere Elencare gli indici .

Se questo errore si verifica durante il caricamento del documento, indica che è stata superata la quota per il numero di documenti per indice. È necessario creare un nuovo indice o effettuare l'aggiornamento per ottenere limiti di capacità più elevati.
499 Richiesta chiusa del client Questo errore non viene mai restituito in una risposta, ma potrebbe essere visualizzato nelle voci di log registrate dall'analisi del traffico di ricerca e da Monitoraggio di Azure. Indica che un client ha chiuso la connessione prima che venga restituita una risposta dal servizio. Quando Ricerca intelligenza artificiale di Azure rileva un annullamento non richiesto dal codice lato servizio o che il client non esiste più, viene registrato un errore 499.
502 - Gateway non valido Questo errore si verifica quando si immette HTTP invece di HTTPS nella connessione.
503 - Servizio non disponibile Questo errore indica che il sistema è sovraccarico e non può elaborare la richiesta in questo momento. Importante: In questo caso, è consigliabile ripristinare il codice client e attendere prima di riprovare. Il sistema avrà così tempo per recuperare, aumentando le probabilità che le future richieste siano soddisfatte. La ripetizione rapida delle richieste prolungherà semplicemente il tempo necessario per risolvere la situazione. Per altre informazioni sulla limitazione e su come evitare questa condizione, vedere Analizzare le prestazioni .
504: Timeout del gateway Ricerca intelligenza artificiale di Azure è in ascolto sulla porta HTTPS 443. Se l'URL del servizio di ricerca contiene HTTP anziché HTTPS, viene restituito un codice di stato 504.

Vedi anche