Condividi tramite

Codici di stato HTTP (Ricerca intelligenza artificiale di Azure)

  • Articolo

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 Operazione riuscita in GET, PUT o POST. Restituito per una risposta con esito positivo.
201 Creato Operazione riuscita in PUT o POST. Oggetto creato correttamente.
202 Accettato Operazione riuscita in PUT o POST. Questo codice di stato viene restituito per le richieste dell'indicizzatore di esecuzione.
204 No Content Operazione riuscita in PUT o POST. Aggiornamento riuscito, ma non sono presenti informazioni da restituire nella risposta.
207 Multi-Status Esito positivo parziale per PUT o POST. Alcuni documenti hanno avuto esito positivo, ma almeno un errore.
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.
401 Non autorizzato Restituito quando mancano le credenziali. Se si usa il controllo degli accessi in base al ruolo, all'utente o al servizio di ricerca manca un'assegnazione di ruolo. Per problemi di accesso a Ricerca di intelligenza artificiale di Azure, vedere Connettersi a Ricerca di intelligenza artificiale di Azure usando i ruoli. Per altre informazioni sulle connessioni di ricerca ad altre risorse, vedere Configurare un servizio di ricerca per la connessione tramite un'identità gestita.
403 Vietato Restituito quando l'autorizzazione non riesce.
404 Non trovato Restituito quando una risorsa non esiste nel server.
Metodo 405 non supportato Restituito quando il servizio riconosce un metodo 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=2024-07-01.
409 - Conflitto Restituito quando le operazioni di scrittura sono in conflitto. Questo codice di stato viene restituito per gli aggiornamenti delle risorse o durante l'indicizzazione quando due processi tentano di aggiornare contemporaneamente lo stesso documento. 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 di intelligenza artificiale di Azure.
412 Precondizione non riuscita Restituito quando una condizione di If-Match o If-None-Match dell'intestazione restituisce false. Associato all'uso del controllo della concorrenza ottimistica quando si inviano richieste HTTP per definizioni di indice, indicizzatori, set di competenze o origini dati.
429 - Numero eccessivo di richieste Se si ottiene questo codice di stato durante la creazione dell'oggetto, significa che è consentito il numero massimo di oggetti consentiti per il livello di servizio. Se viene visualizzato questo codice di errore in un indice attivo, in genere significa che l'archiviazione è insufficiente. Quando si avvicinano i limiti di archiviazione, il servizio può entrare in uno stato in cui non è possibile aggiungere o aggiornare fino a quando non si eliminano alcuni documenti. Per altre informazioni, vedere Pianificare e gestire la capacità se si vuole più spazio di archiviazione o Aggiornare il contenuto se si vuole liberare spazio eliminando i documenti.
499 Richiesta chiusa client Questo codice di stato 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 sul lato servizio o che il client non esiste più, viene registrato un 499.
502 Gateway non valido Questo codice di stato si verifica quando si immette HTTP anziché HTTPS nella connessione.
503 Servizio non disponibile Questo codice di stato indica che il sistema è sottoposto a carico elevato e che la richiesta non può essere elaborata. Le mitigazioni includono l'aggiunta di tempi di attesa a qualsiasi logica di ripetizione dei tentativi o all'aumento della capacità. I servizi più recenti sono dotati di maggiore potenza di archiviazione e calcolo automaticamente. Per altre informazioni sull'ottimizzazione delle prestazioni, vedere Analizzare le prestazioni in Ricerca di intelligenza artificiale di Azure.
504: Timeout del gateway Ricerca di 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.

Vedere anche