Consulta i connettori supportati per Application Integration.

Errori e gestione degli errori

In Application Integration, potrebbero verificarsi errori durante il 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 generalmente classificati come segue:

• Errori permanenti: tutti gli errori lato client, quali errori di autenticazione ed errori 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) e HTTP 400 (richiesta non valida), sono considerati errori temporanei. Gli errori temporanei causano errori temporanei delle attività.

I messaggi di errore vengono visualizzati nelle seguenti posizioni:

• Pagina dei 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 integrazioni: mostra gli errori riscontrati durante la pubblicazione di un'integrazione. Gli errori vengono visualizzati nella parte inferiore della pagina dell'editor delle integrazioni. Per informazioni sulla pagina dell'editor di integrazione, consulta Editor di integrazione.

Per informazioni sull'elenco dei codici di errore che potresti riscontrare, consulta Codici di errore.

Metodi di gestione degli errori

Application 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 sia per la modalità sincrona che per la modalità asincrona di esecuzione dell'integrazione:

• 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 che il risultato dell'esecuzione sia immediatamente dopo l'integrazione. I trigger che eseguono l'integrazione in modalità sincrona includono quanto segue:
  • Testare o pubblicare un'integrazione
  • Chiama l'API projects.locations.integrations.execute
  • Chiama l'integrazione da una integrazione secondaria in modalità sincrona
• Esecuzioni asincrone: le esecuzioni asincrone utilizzano il modello Fire and Delete. La modalità asincrona è utile in scenari in cui l'esecuzione delle integrazioni può richiedere molto tempo o 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 della modalità asincrona comune includono, a titolo esemplificativo:
    • Pianifica trigger
    • Trigger di Cloud Scheduler
    • Trigger di Cloud Pub/Sub
    • Trigger di Salesforce
    • Chiama l'API projects.locations.integrations.schedule
  • Anche le esecuzioni riprese da una sospensione o da un'attività di approvazione vengono eseguite in modalità asincrona, anche se l'esecuzione iniziale era in modalità sincrona.

Application Integration supporta i seguenti metodi di gestione degli errori per generare, rilevare, riprovare e personalizzare gli errori riscontrati nell'integrazione:

• Strategie di gestione degli errori
• Strumento di rilevamento degli errori

Codici di errore

La tabella seguente descrive gli errori che potresti riscontrare e le relative cause. Application Integration utilizza i codici di errore canonici definiti in google.rpc.Code.

Per informazioni sugli errori di Application 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, controlla 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. Questo 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 un bug del server. Questo può accadere se le attività o gli 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.