Nell'integrazione di Apigee, gli errori potrebbero verificarsi durante i test e la pubblicazione di un'integrazione o durante l'esecuzione di un'integrazione. Questi errori possono verificarsi a causa di vari problemi lato client e lato server e sono classificati in linea generale come segue:
- Errori permanenti: tutti gli errori lato client, ad esempio errori di autenticazione e di convalida dei dati, sono considerati errori permanenti. Gli errori permanenti causano errori permanenti delle attività.
- Errori temporanei:tutti gli errori lato server, ad esempio HTTP 503 (servizio non disponibile), HTTP 400 (richiesta errata), sono considerati errori temporanei. Gli errori temporanei causano errori temporanei delle attività.
I messaggi di errore vengono visualizzati nelle seguenti posizioni:
- Pagina Log di esecuzione: mostra gli errori riscontrati durante l'esecuzione di un'integrazione. Ogni esecuzione di un'integrazione ha una voce di log separata. Per informazioni sulla pagina dei log di esecuzione, consulta Log di esecuzione.
- Pagina Editor dell'integrazione: mostra gli errori riscontrati quando pubblichi un'integrazione. Gli errori vengono visualizzati nella parte inferiore della pagina dell'editor delle integrazioni. Per informazioni sulla pagina Editor dell'integrazione, vedi Editor dell'integrazione.
Per informazioni sull'elenco dei codici di errore che possono essere visualizzati, vedi Codici di errore.
Metodi di gestione degli errori
Apigee Integration offre diversi metodi di gestione degli errori per rispondere e recuperare gli errori che si verificano durante la creazione, il test, la pubblicazione o l'esecuzione delle integrazioni. Puoi utilizzare i metodi di gestione degli errori per l'esecuzione dell'integrazione sia sincrona che asincrona:
-
Esecuzioni sincrone: in modalità sincrona, il risultato dell'esecuzione dell'integrazione è disponibile subito dopo l'esecuzione dell'integrazione. La modalità sincrona è utile negli scenari in cui vuoi ottenere il risultato dell'esecuzione subito dopo l'esecuzione dell'integrazione. I trigger eseguono l'integrazione in modalità sincrona come segue:
- Testare o pubblicare un'integrazione
- Chiamare l'API
projects.locations.integrations.execute - Chiamare l'integrazione da un'integrazione secondaria in modalità sincrona
-
Esecuzioni asincrone: le esecuzioni asincrone utilizzano il modello Fire and delete. La modalità asincrona è utile negli scenari in cui l'esecuzione delle integrazioni può richiedere molto tempo o in cui il risultato dell'esecuzione non è richiesto subito dopo l'esecuzione dell'integrazione. Gli attivatori che eseguono l'integrazione in modalità asincrona includono quanto segue:
- Tutte le esecuzioni non sincrone vengono eseguite in modalità asincrona. Alcune delle modalità comuni di modalità asincrona includono, a titolo esemplificativo:
- Anche le esecuzioni riprese da una sospensione o da un'attività di approvazione vengono eseguite in modalità sincrona, anche se l'esecuzione iniziale era sincrona.
Apigee Integration supporta i seguenti metodi di gestione degli errori per generare, individuare, riprovare e personalizzare gli errori riscontrati nell'integrazione:
Codici di errore
La tabella seguente descrive gli errori che potresti riscontrare e le relative cause. L'Apigee Integration utilizza i codici di errore canonici definiti in google.rpc.Code.
Per informazioni sugli errori di Apigee Integration e sulle diverse strategie di gestione degli errori, consulta Errori e gestione degli errori.
| Tipo di eccezione standard | Codice canonico | Codice HTTP | Descrizione |
|---|---|---|---|
| FailedPreconditionException | FAILED_PRECONDITION |
400 | La richiesta non può essere eseguita nello stato attuale del sistema. |
| BadRequestException | INVALID_ARGUMENT |
400 | Il client ha specificato un argomento non valido. Per ulteriori informazioni, consulta il messaggio e i dettagli dell'errore. |
| UnauthenticatedException | UNAUTHENTICATED |
401 | La mancata autenticazione della richiesta è dovuta a un token OAuth mancante, non valido o scaduto. |
| ForbiddenException | PERMISSION_DENIED |
403 | Il client non dispone di autorizzazioni sufficienti. Ciò può accadere se il token OAuth non ha gli ambiti corretti, il client non dispone delle autorizzazioni richieste o l'API non è stata abilitata. |
| NotFoundException | NOT_FOUND |
404 | Impossibile trovare una risorsa specificata. |
| AlreadyExistsException | ALREADY_EXISTS |
409 | La risorsa che un client ha cercato di creare esiste già. |
| InternalError | INTERNAL |
500 | Errore interno del server. In genere si tratta di un bug del server. Questo può accadere se alcune attività o attivatori non sono configurati correttamente. |
| UnimplementedException | UNIMPLEMENTED |
501 | Metodo API non implementato dal server. |
| ServiceUnavailableException | UNAVAILABLE |
503 | Servizio non disponibile. In genere il server non è attivo. |
| AbortedException | ABORTED |
409 | Le dimensioni della risposta sono troppo grandi. |