In Apigee Integration können Fehler beim Testen und Veröffentlichen einer Integration oder während der Ausführung einer Integration auftreten. 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 des Integrationseditors finden Sie unter Integrationseditor.
Eine Liste der möglichen Fehlercodes finden Sie unter Fehlercodes.
Methoden zur Fehlerbehandlung
Apigee Integration bietet mehrere Methoden zur Fehlerbehandlung, um auf die Fehler zu reagieren, die beim Erstellen, Testen, Veröffentlichen oder Ausführen von Integrationen auftreten. Sie können Fehlerbehandlungsmethoden für den synchronen und den asynchronen Modus der Integrationsausführung verwenden:
-
Synchrone Ausführungen: Im synchronen Modus ist das Ausführungsergebnis der Integration kurz nach der Ausführung der Integration verfügbar. Der synchrone Modus ist in Szenarien nützlich, in denen Sie das Ausführungsergebnis unmittelbar nach der Ausführung der Integration wünschen. Trigger führen die Integration im synchronen Modus aus:
- Integration testen oder veröffentlichen
projects.locations.integrations.executeAPI aufrufen- Integration aus einer Subintegration im synchronen Modus aufrufen
-
Asynchrone Ausführungen: Asynchrone Ausführungen verwenden das Fire-and-Forget-Modell. Der asynchrone Modus eignet sich für Szenarien, in denen Integrationen sehr lange dauern können oder das Ausführungsergebnis nicht unmittelbar nach Ausführung 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. Einige der gängigen asynchronen Modus sind unter anderem:
- Ausführungen, die von einer Sperrung oder einer Genehmigungsaufgabe fortgesetzt werden, werden ebenfalls im asynchronen Modus ausgeführt, selbst wenn die anfängliche Ausführung im synchronen Modus war.
Apigee Integration unterstützt die folgenden Methoden zur Fehlerbehandlung, um die in Ihrer Integration aufgetretenen Fehler auszugeben, abzufangen, zu wiederholen und anzupassen:
Fehlercodes
In der folgenden Tabelle werden die möglichen Fehler und die zugehörigen Ursachen beschrieben. Apigee Integration verwendet die in google.rpc.Code definierten kanonischen Fehlercodes.
Informationen zu Fehlern in Apigee Integration und verschiedenen Strategien zur Fehlerbehandlung 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ß. |