Gestione degli errori in Amazon CloudSearch - Amazon CloudSearch

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:

  • I codici di stato 2xx indicano che la richiesta del client è stata elaborata correttamente.

  • I codici di stato 4xx indicano che si è verificato un problema con la richiesta del client. Errori di richiesta comuni includono fornire credenziali non valide e omettere i parametri richiesti. Quando ricevi un errore 4xx, devi correggere il problema e inviare nuovamente una richiesta client formulata correttamente.

  • I codici di stato 5xx indicano che si è verificato un errore del server durante l'elaborazione della richiesta. Gli errori del server sono in genere transitori e sono spesso il risultato di timeout del server, throttling o limitazioni della capacità. Consigliamo di intercettare tutti gli errori 5xx e di fare nuovi tentativi.

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.