Informationen zu den unterstützten Connectors für Application Integration.

Fehler und Fehlerbehebung

In Application Integration können Fehler auftreten, wenn Sie eine Integration testen und veröffentlichen oder während der Ausführung einer Integration. Diese Fehler können aufgrund verschiedener clientseitiger und serverseitiger Probleme auftreten und sind grob klassifiziert:

• Permanente Fehler: Alle clientseitigen Fehler wie Authentifizierungsfehler oder Datenvalidierungsfehler werden als permanente Fehler betrachtet. Permanente Fehler führen zu permanenten Aufgabenfehlern.
• Temporäre Fehler: Alle serverseitigen Fehler wie HTTP 503 (Dienst nicht verfügbar), HTTP 400 (Fehlerhafte Anfrage) werden als temporäre Fehler betrachtet. Temporäre Fehler führen zu vorübergehenden Aufgabenfehlern.

Fehlermeldungen werden an den folgenden Stellen angezeigt:

• Seite Ausführungslogs: Zeigt Fehler an, die während der Ausführung einer Integration aufgetreten sind. Jede Ausführung einer Integration hat einen separaten Logeintrag. Informationen zur Seite mit den Ausführungslogs finden Sie unter Ausführungslogs.
• Seite Integrationseditor: Zeigt Fehler an, die beim Veröffentlichen einer Integration aufgetreten sind. Die Fehler werden unten auf der Seite "Integrationseditor" angezeigt. Informationen zur Seite für den Integrationseditor findest du unter Integrationseditor.

Eine Liste der möglichen Fehlercodes finden Sie unter Fehlercodes.

Methoden zur Fehlerbehandlung

Application Integration bietet mehrere Methoden zur Fehlerbehandlung, um Fehler zu beheben, die beim Erstellen, Testen, Veröffentlichen oder Ausführen von Integrationen auftreten. Sie können Fehlerbehandlungsmethoden sowohl für den synchronen als auch für den asynchronen Modus der Integrationsausführung verwenden:

• Synchrone Ausführungen:Im synchronen Modus ist das Ergebnis der Ausführung kurz nach der Integration verfügbar. Der synchrone Modus ist hilfreich in Szenarien, in denen das Ausführungsergebnis sofort nach der Integration zurückgegeben werden soll. Zu den Triggern, die die Integration im synchronen Modus ausführen, gehören:
  • Integration testen oder veröffentlichen
  • projects.locations.integrations.execute API aufrufen
  • Rufen Sie die Integration von einer Unterintegration im synchronen Modus auf.
• Asynchrone Ausführungen:Bei asynchronen Ausführungen wird das Fire-and-Forget-Modell verwendet. Der asynchrone Modus ist hilfreich, wenn die Ausführung von Integrationen lange dauern kann oder das Ausführungsergebnis nicht sofort nach der Integration erforderlich ist. Zu den Triggern, die die Integration im asynchronen Modus ausführen, gehören:
  • Alle nicht synchronen Ausführungen werden im asynchronen Modus ausgeführt. Zu den gängigen asynchronen Modi gehören unter anderem:
    • Schedule-Trigger
    • Cloud Scheduler-Trigger
    • Cloud Pub/Sub-Trigger
    • Salesforce-Trigger
    • projects.locations.integrations.schedule API aufrufen
  • Ausführungen, die nach einer Sperrung oder Genehmigungsaufgabe fortgesetzt werden, werden auch im synchronen Modus ausgeführt, selbst wenn die anfängliche Ausführung im synchronen Modus erfolgt ist.

Application Integration unterstützt die folgenden Fehlerbehandlungsmethoden zum Auslösen, Abfangen, Wiederholen und Anpassen der Fehler in der Integration:

• Strategien zur Fehlerbehandlung
• Fehlererfassung

Fehlercodes

In der folgenden Tabelle werden die möglichen Fehler und die zugehörigen Ursachen beschrieben. Application Integration verwendet die in google.rpc.Code definierten kanonischen Fehlercodes.

Informationen zu Application Integration-Fehlern und verschiedenen Fehlerbehandlungsstrategien finden Sie unter Fehler und Fehlerbehandlung.

Standardausnahmetyp	Kanonischer Code	HTTP-Code	Beschreibung
FailedPreconditionException	FAILED_PRECONDITION	400	Die Anfrage kann im aktuellen Systemzustand nicht ausgeführt werden.
BadRequestException	INVALID_ARGUMENT	400	Der Client hat ein ungültiges Argument angegeben. Weitere Informationen finden Sie in der Fehlermeldung und den Fehlerdetails.
UnauthenticatedException	UNAUTHENTICATED	401	Die Anfrage konnte aufgrund eines fehlenden, ungültigen oder abgelaufenen OAuth-Tokens nicht authentifiziert werden.
ForbiddenException	PERMISSION_DENIED	403	Der Client verfügt nicht über die erforderliche Berechtigung. Dies kann passieren, wenn das OAuth-Token nicht über die richtigen Bereiche verfügt, der Client nicht die erforderlichen Berechtigungen hat oder die API nicht aktiviert wurde.
NotFoundException	NOT_FOUND	404	Eine angegebene Ressource wurde nicht gefunden.
AlreadyExistsException	ALREADY_EXISTS	409	Die von einem Client zu erstellende Ressource ist bereits vorhanden.
InternalError	INTERNAL	500	Interner Serverfehler. In der Regel ein Serverprogrammfehler. Das kann passieren, wenn eine der Aufgaben oder Trigger falsch konfiguriert ist.
UnimplementedException	UNIMPLEMENTED	501	Die API-Methode wurde vom Server nicht implementiert.
ServiceUnavailableException	UNAVAILABLE	503	Dienst nicht verfügbar. In der Regel ist der Server ausgefallen.
AbortedException	ABORTED	409	Die Antwort ist zu groß.