Oracle Cloud Infrastructure - Dokumentation

API-Gateway-Fehler beheben

Erfahren Sie, wie Sie Probleme mit API Gateway und mögliche Lösungen für häufige Probleme beheben können.

In diesem Thema werden allgemeine Probleme im Zusammenhang mit dem API-GatewayService behandelt, und es wird erläutert, wie Sie diese lösen können.

Die Themen in diesem Thema sind in folgende allgemeine Kategorien unterteilt:

Probleme beim Erstellen von API-Gateways

Fehlermeldung oder Beschreibung Weitere Informationen
Erstellen eines neuen API-Gateways bleibt im Status "Wird erstellt" hängen oder ist nicht erfolgreich. Erstellen eines neuen API-Gateways bleibt im Status "Wird erstellt" hängen oder ist nicht erfolgreich
VNIC attachment failed due to the limit for number of private IP addresses for this subnet Beim Erstellen eines neuen API-Gateways wird die Meldung "VNIC attachment failed due to the limit for number of private IP addresses for this subnet" zurückgegeben
The limit for number of private IP addresses for this subnet has been exceeded Beim Erstellen eines neuen API-Gateways wird die Meldung "The limit for number of private IP addresses for this subnet has been exceeded" zurückgegeben
The limit for number of public IP addresses for this compartment has been exceeded Beim Erstellen eines neuen öffentlichen API-Gateways wird die Meldung "The limit for number of public IP addresses for this compartment has been exceeded" zurückgegeben
Work request was cancelled Beim Erstellen eines neuen API-Gateways wird die Meldung "Work request was cancelled" zurückgegeben
An unexpected error occurred. Contact Oracle Support for assistance. Beim Erstellen eines neuen API-Gateways wird die Meldung "An unexpected error occurred. Contact Oracle Support for assistance" zurückgegeben
Unknown resource <subnet-ocid>, make sure subnet exists, the user can access the subnet and it is in the same region where the gateway will be created Beim Erstellen eines neuen API-Gateways wird die Meldung "Unknown resource <subnet-ocid>, make sure subnet exists,..." und ein 400-Fehler zurückgegeben

Probleme beim Erstellen von API-Deployments

Fehler beim Sperren von API-Deployments:

Fehlermeldung oder Beschreibung Weitere Informationen
Erstellen eines neuen API-Deployments bleibt im Status "Wird erstellt" hängen oder ist nicht erfolgreich. Erstellen eines neuen API-Deployments bleibt im Status "Wird erstellt" hängen oder ist nicht erfolgreich

"Fehlerhafte Anforderung" HTTP-4xx-Fehler im Zusammenhang mit der mTLS-Konfiguration:

Fehlermeldung oder Beschreibung Weitere Informationen
Cannot enable mutual TLS because custom CA Bundles are not added to the Gateway. Please add a custom CA Bundle and try again. Das Erstellen eines neuen API-Deployments ist nicht erfolgreich. "Gegenseitige TLS kann nicht aktiviert werden, weil dem Gateway keine benutzerdefinierten CA-Bundles hinzugefügt werden. Fügen Sie ein benutzerdefiniertes CA-Bundle hinzu, und versuchen Sie es erneut."
Duplicate SAN or CN values passed in input. Erstellen eines neuen API-Deployments nicht erfolgreich mit Meldung "Doppelte SAN- oder CN-Werte in Eingabe übergeben"
Too many value, must not have more than 10 values. Erstellen eines neuen API-Deployments nicht erfolgreich mit Meldung "Zu viele Werte, dürfen nicht mehr als 10 Werte enthalten"
Length of SAN or CN string should be less than 256 characters. Das Erstellen eines neuen API-Deployments ist nicht erfolgreich. Die Meldung "Länge der SAN- oder CN-Zeichenfolge muss kleiner als 256 Zeichen sein"
Invalid format for SAN or CN. Erstellen eines neuen API-Deployments nicht erfolgreich mit "Ungültiges Format für SAN oder CN"

Probleme beim Aufrufen von APIs

Prüfen Sie die Aufrufinformationen mit API Gateway-Logs. Der Oracle Cloud Infrastructure Logging-Service ist die Standardoption und die empfohlene Option für den Zugriff auf, die Suche und das Speichern von API-Gateway-Logs. Weitere Informationen finden Sie unter Logging zu API-Deployments hinzufügen.

Verwenden Sie die Fehlermeldungen aus den Logs und die folgenden Informationen, um Aufrufprobleme zu lösen.

HTTP-5xx-Fehler: API-Deployment erfolgreich erstellt, aber Anforderungen nicht erfolgreich:

Fehlermeldung oder Beschreibung Weitere Informationen
failed to parse pem cert chain, im Log dargestellt. Der Aufruf des API-Deployments ist mit einem HTTP-5xx-Fehler nicht erfolgreich, und der Fehler "pem cert chain konnte nicht geparst werden" wird in das Log ausgegeben
Client CA Bundle not present, im Log dargestellt. Der Aufruf des API-Deployments ist mit einem HTTP-5xx-Fehler nicht erfolgreich, und ein Fehler "Client-CA-Bundle nicht vorhanden" wird in das Log ausgegeben
Error in client certificate verification, im Log dargestellt. Der Aufruf des API-Deployments ist mit einem HTTP-5xx-Fehler nicht erfolgreich, und der Fehler "Fehler bei der Verifizierung des Clientzertifikats" wird in das Log ausgegeben
503: Service Unavailable Der Aufruf des API-Deployments ist mit der Meldung "Service nicht verfügbar" und einem 503-Fehler nicht erfolgreich

HTTP-4xx-Fehler: API-Deployment erfolgreich erstellt, aber Anforderungen nicht erfolgreich:

Fehlermeldung oder Beschreibung Weitere Informationen
Client certificate is invalid for this gateway., im Log dargestellt. Der Aufruf des API-Deployments ist mit einem HTTP-4xx-Fehler nicht erfolgreich, und der Fehler "Clientzertifikat ist für dieses Gateway ungültig" wird in das Log ausgegeben
SAN validation failure, im Log dargestellt. Der Aufruf des API-Deployments ist mit einem HTTP-4xx-Fehler nicht erfolgreich, und es wird ein Fehler "SAN-Validierungsfehler" in das Log ausgegeben

Verschiedene Fehler beim Aufrufen von APIs

Fehlermeldung oder Beschreibung Weitere Informationen
Base 64 Certificate Size greater than 8KB, im Log dargestellt. Das API-Deployment wurde erfolgreich aufgerufen. Es wird jedoch eine Warnung "Basis-64-Zertifikatgröße größer als 8 KB" in das Log ausgegeben

Probleme, die sich auf API-Gateways auswirken

Fehlermeldung oder Beschreibung Weitere Informationen
Wenn Sie ein definiertes Tag ändern, wird ein API-Gateway in den Status "Nicht erfolgreich" versetzt. Durch das Ändern eines definierten Tags wird ein API-Gateway in einen nicht erfolgreichen Status versetzt