Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Gestione degli errori in Amazon CloudSearch

Questa sezione fornisce informazioni su come gestire gli errori durante l'interazione CloudSearch programmatica con Amazon. Per informazioni sui codici di errore specifici restituiti dai CloudSearch servizi Amazon, consulta:

Tipi di errore in Amazon CloudSearch

I codici di stato HTTP restituiti da Amazon CloudSearch APIs indicano se la richiesta è stata completata correttamente o se si è verificato un errore del client o del server durante l'elaborazione della richiesta:

Per ogni richiesta viene restituito un codice di stato HTTP. Inoltre, il corpo della risposta fornisce ulteriori avvertenze e informazioni di errore.

I messaggi in una risposta search indicano il livello di gravità, il codice di avvertenza o di errore e una descrizione del problema con la richiesta di ricerca. Per un elenco di avvisi ed errori che possono essere restituiti dal servizio di ricerca, vedi Proprietà della risposta della ricerca (JSON) o Elementi della risposta di ricerca (XML).

Gli errori e gli avvisi in una risposta documents/batch forniscono informazioni sulle analisi e sui problemi di convalida rilevati durante l'elaborazione dei dati del documento. Per ulteriori informazioni, consulta Risposta documents/batch (JSON) o Risposta documents/batch (XML).

Gli errori restituiti in una risposta del servizio di configurazione forniscono informazioni su ciò che ha determinato la restituzione di un codice di stato 4xx o 5xx. Per informazioni sugli errori comuni che tutte le operazioni utilizzano, vedi Errori comuni. Gli errori specifici delle operazioni sono elencati negli argomenti dell'operazione nella Riferimento all'API di configurazione per Amazon CloudSearch .

Riprovare le richieste in Amazon CloudSearch

Per il buon funzionamento dell'applicazione, devi integrare la logica che permette di intercettare gli errori e rispondere in modo adeguato. Un approccio tipico consiste nell'implementare la tua richiesta all'interno di un blocco try o di un'istruzione if-then.

Consigliamo di intercettare tutti gli errori del server (5xx) e di fare nuovi tentativi. Poiché gli errori possono essere generati ovunque all'interno della pipeline della richiesta, è necessario implementare un fallback per gli errori 5xx imprevisti in aggiunta a eventuali gestioni speciali per codici di stato specifici.

Gli errori 507 e 509 in genere indicano che il servizio di ricerca è sovraccarico. Ciò può essere dovuto al volume o alla complessità delle richieste di ricerca che stai inviando. Amazon CloudSearch normalmente si ridimensiona automaticamente per gestire il carico. Poiché la distribuzione di istanze di ricerca aggiuntive richiede del tempo, consigliamo di utilizzare una politica di backoff retry esponenziale per ridurre temporaneamente la frequenza delle richieste e ridurre al minimo gli errori. Per ulteriori informazioni, consulta Error Retries e Exponential Backoff.

Alcuni modelli di utilizzo, come l'invio di query di ricerca complesse a un'unica istanza di ricerca di piccole dimensioni, possono talvolta causare timeout senza attivare il ridimensionamento automatico. Se riscontri ripetutamente un tasso di errore elevato, puoi richiedere esplicitamente capacità aggiuntiva tramite il modulo Amazon CloudSearch Service Limit Request.

Gli errori del client (4xx) in genere indicano che è necessario modificare la richiesta per correggere il problema: è probabile che sia sufficiente riprovare la stessa richiesta per ottenere lo stesso errore. 409 errori restituiti dal servizio di configurazione possono indicare che la richiesta è stata rifiutata perché è stato raggiunto un limite di risorse. Per ulteriori informazioni, consulta Limiti.