API-Fehler
Von allen Services zurückgegebene häufige Fehler
In der folgenden Tabelle werden die häufigen Fehler aufgeführt, die von allen Services für Oracle Cloud Infrastructure zurückgegeben werden.
| HTTP-Statuscode | Fehlercode | Beschreibung | Wiederholung |
|---|---|---|---|
| 400 | CannotParseRequest |
Die Anforderung ist falsch formatiert. | Nein |
| 400 | InvalidParameter
|
Ein Parameter ist ungültig oder falsch formatiert. | Nein |
| 400 | LimitExceeded
|
Diese Anforderung überschreitet das von Oracle definierte Limit für diesen Mandanten und Ressourcentyp. | Nein |
| 400 | MissingParameter
|
Ein erforderlicher Parameter fehlt. | Nein |
| 400 | QuotaExceeded
|
Diese Anforderung überschreitet die vom Administrator definierte Quota für dieses Compartment und diese Ressource. | Nein |
| 400 | RelatedResourceNot AuthorizedOrNotFound
|
Eine im Text der Anforderung angegebene Ressource wurde nicht gefunden, oder Sie haben keine Zugriffsberechtigung für diese Ressource. |
Nein |
| 401 | NotAuthenticated
|
Die erforderlichen Authentifizierungsinformationen wurden nicht angegeben oder waren falsch. |
Nein |
| 403 | NotAllowed
|
Dieser Vorgang muss an die Hauptregion weitergeleitet werden. | Nein |
| 403 | NotAuthorized
|
Sie sind nicht berechtigt, ein oder mehrere der Felder zu aktualisieren, die in dieser Anforderung enthalten sind. | Nein |
| 403 | SignUpRequired
|
Dieser Vorgang erfordert ein Opt-in, bevor er aufgerufen werden kann. | Nein |
| 404 | InvalidParameter |
Eine dynamische Pfadkomponente ist ungültig oder syntaktisch gültig, ist jedoch nicht zulässig. | Nein |
| 404 | NotAuthorizedOrNotFound
|
Eine Ressource, die über die URI (Pfad- oder Abfrageparameter) der Anforderung angegeben wurde, wurde nicht gefunden, oder Sie haben keine Zugriffsberechtigung für diese Ressource. Weitere Informationen finden Sie unter HTML-Statuscode 404. | Nein |
| 404 | NotFound
|
In dem URI-Pfad und der HTTP-Methode, die Sie in der Anforderung angegeben haben, wird kein Vorgang unterstützt. | Nein |
| 404 | NamespaceNotFound
|
Sie haben keine Berechtigung zum Ausführen dieser Anforderung, oder die angeforderte Ressource wurde nicht gefunden. | Nein |
| 405 | MethodNotAllowed
|
Die Zielressource unterstützt die HTTP-Methode nicht. | Nein |
| 409 | Conflict
|
Der angeforderte Status für die Ressource steht mit dem aktuellen Status in Konflikt. Dieser Status ist nicht transient. | Nein |
| 409 | ExternalServerIncorrectState
|
Der Server befindet sich in einem falschen Status und hat ein Timeout, hat eine ungültige Antwort zurückgegeben oder ist nicht erreichbar. | Ja, mit Backoff Lesen Sie in der Fehlerbeschreibung nach, welche Maßnahmen erforderlich sind, bevor Sie es erneut versuchen. |
| 409 | IncorrectState
|
Der angeforderte Status für die Ressource steht mit dem aktuellen Status in Konflikt, die Ressource wird aber nach einem gewissen Zeitraum den korrekten Status haben. | Ja, mit Backoff Lesen Sie in der Fehlerbeschreibung nach, welche Maßnahmen erforderlich sind, bevor Sie es erneut versuchen. |
| 409 | InvalidatedRetryToken
|
Das angegebene Wiederholungstoken wurde in einer früheren Anforderung verwendet, die zu einer Systemaktualisierung geführt hat. Das Token ist jedoch durch einen nachfolgenden Vorgang ungültig geworden. Dies kann beispielsweise passieren, wenn eine Entity, die mit demselben Token erstellt wurde, seither gelöscht wurde. Wenn die mit dieser Anforderung verknüpfte Systemstatusänderung erneut ausgeführt werden soll, wiederholen Sie sie mit einem anderen Token. | Nein |
| 409 | NotAuthorizedOrResourceAlreadyExists
|
Sie haben keine Berechtigung zum Ausführen dieser Anforderung, oder die Ressource, die Sie erstellen möchten, ist bereits vorhanden. Dieser Fehlercode wird nur von create-Vorgängen anstelle des allgemeineren NotAuthorizedOrNotFound-Fehlercodes zurückgegeben. |
Nein |
| 412 | NoEtagMatch
|
Das in der Anforderung angegebene Entitytag stimmt nicht mit dem Entitytag für die Ressource überein. | Nein |
| 413 | PayloadTooLarge
|
Die Anforderungsentity ist größer als die vom Server definierten Limits. | Nein |
| 422 | UnprocessableEntity
|
Die Payload ist syntaktisch korrekt, aber semantisch ungültig. | Nein |
| 429 | TooManyRequests
|
Sie haben zu viele Anforderungen an die Oracle Cloud Infrastructure-APIs in einem zu kurzen Zeitraum ausgegeben. | Ja, mit Backoff |
| 431 | RequestHeaderFieldsTooLarge
|
Die HTTP-Header der Anforderung sind zu lang. Die Anforderung kann erneut übermittelt werden, nachdem die Größe der Anforderungsheader reduziert wurde. | Nein |
| 500 | InternalServerError
|
Ein interner Serverfehler ist aufgetreten. | Ja, mit Backoff |
| 501 | MethodNotImplemented
|
Das HTTP-Anforderungsziel erkennt die HTTP-Methode nicht. | Nein |
| 503 | ExternalServerUnreachable
|
Es konnte keine Verbindung zu einem externen System hergestellt werden, das zur Erfüllung der Anforderung erforderlich ist. | Ja, mit Backoff |
| 503 | ExternalServerTimeout
|
Bei einer Verbindung mit einem externen System, das zur Erfüllung der Anforderung erforderlich ist, ist ein Timeout aufgetreten, bevor eine Antwort empfangen wurde. | Ja, mit Backoff |
| 503 | ExternalServerInvalidResponse
|
Eine Verbindung mit einem externen System, das zur Erfüllung der Anforderung erforderlich ist, hat zu einer nicht akzeptablen Antwort geführt. | Ja, mit Backoff |
| 503 | ServiceUnavailable
|
Der Service ist derzeit nicht verfügbar. | Ja, mit Backoff |
API-Fehlerdetails und Fehlerbehebung
Dieser Abschnitt enthält detaillierte Informationen und Vorschläge zur Fehlerbehebung für HTTP-Statusfehlercodes.
Fehler - HTTP-Statuscode 400
InvalidParameter
Beschreibung
Ein Parameterwert ist ungültig oder falsch formatiert.
Fehlerbehebung
- Informationen zum Vorgang finden Sie in der REST-API-Dokumentation. Prüfen Sie die Parameter in der Anforderung auf Tippfehler oder falsche Formate, und korrigieren Sie die Anforderung.
MissingParameter
Beschreibung
Ein erforderlicher Parameter fehlt
Fehlerbehebung
- In der Anforderung fehlt ein erforderlicher Parameter für diese API. Informationen zum Vorgang finden Sie in der REST-API-Dokumentation. Korrigieren Sie die Anforderung.
QuotaExceeded
Beschreibung
Diese Anforderung überschreitet die vom Administrator definierte Quota für dieses Compartment und diese Ressource.
Fehlerbehebung
- Die vom Administrator definierte Quota für dieses Compartment für diese Ressource wird durch die Ausführung dieser Anforderung überschritten. Prüfen Sie die Ressourcen-Quota, und beantragen Sie gegebenenfalls eine Erhöhung der Quota, oder bereinigen Sie nicht verwendete Ressourcen. Weitere Informationen zu Quotas finden Sie unter Compartment-Quotas - Überblick.
LimitExceeded
Beschreibung
Diese Anforderung überschreitet das von Oracle definierte Limit für diesen Mandanten und Ressourcentyp.
Fehlerbehebung
Das von Oracle definierte Limit für diesen Mandanten für diesen Ressourcentyp wird durch die Ausführung dieser Anforderung überschritten. Prüfen Sie das Limit auf Mandantenebene für diese Ressource, und beantragen Sie eine Erhöhung des Limits für den Mandanten, oder bereinigen Sie nicht verwendete Ressourcen, und senden Sie die Anforderung erneut. Weitere Informationen zu Ihren OCI-Servicelimits und zur Beantragung einer Limiterhöhung finden Sie unter Servicelimits.CannotParseRequest
Beschreibung
Die Anforderung ist falsch formatiert.
Fehlerbehebung
Für die meisten Vorgänge, die einen Text verwenden, muss die Anforderung als JSON formatiert sein. In der REST-API-Dokumentation finden Sie Informationen dazu, ob der Vorgang JSON akzeptiert. Wenn ja, bestätigen Sie, dass Sie eine gültige JSON im Anforderungsbody übergeben.InvalidStorageTier
Beschreibung
Die Anforderung verwendet eine ungültige Storage Tier.
Fehlerbehebung
Der angegebene storageTier-Parameter ist nicht korrekt. Informationen zum Vorgang finden Sie in der REST-API-Dokumentation. Korrigieren Sie die Anforderung.Fehler - HTTP-Statuscode 401
NotAuthenticated
Beschreibung
Die erforderlichen Authentifizierungsinformationen wurden nicht angegeben oder waren falsch.
Fehlerbehebung
Dieser Fehlercode kann aus mehreren Gründen ausgelöst werden:
- Fehlende oder falsche Authentifizierungsinformationen.
- Stellen Sie sicher, dass alle erforderlichen Informationen (Mandanten-OCID, Benutzer-OCID, Fingerprint und Private Key) angegeben und korrekt sind.
- Stellen Sie sicher, dass
private_key_pathauf Ihren Private Key und nicht auf den entsprechenden Public Key verweist - Stellen Sie sicher, dass die verwendeten Public/Private-Key-Paare das richtige Format aufweisen.
- Stellen Sie sicher, dass der Benutzeraccount zu einer Gruppe mit den entsprechenden Berechtigungen gehört, um die Aktionen im gewünschten Plan auszuführen
- Stellen Sie sicher, dass Ihr Mandant die Region abonniert hat, die in Ihrem Plan als Ziel festgelegt ist.
- Stellen Sie sicher, dass der dem Fingerprint entsprechende Public Key für den Benutzer hochgeladen wurde, in dessen Namen Sie die Anforderung stellen. Weitere Informationen finden Sie unter Erforderliche Schlüssel und OCIDs.
- Clock Skew. Dieser Statuscode wird zurückgegeben, wenn eine Clock Skew des Clients von mehr als fünf (5) Minuten gegenüber dem Server besteht. Weitere Informationen finden Sie unter Maximal zulässige Client-Clock Skew.
- Signaturfehler bei API-Anforderung. Dieser Statuscode wird zurückgegeben, wenn erforderliche Informationen fehlen oder im Autorisierungsheader falsch formatiert sind. Weitere Informationen finden Sie unter Anforderungssignaturen.
Fehler - HTTP-Statuscode 403
SignUpRequired
Beschreibung
Dieser Vorgang erfordert ein Opt-in, bevor er aufgerufen werden kann.
Fehlerbehebung
Stellen Sie sicher, dass der Benutzer für dieses Feature registriert ist. Wenn nicht, wenden Sie sich an den Support, und registrieren Sie sich für diesen Service.NotAllowed
Beschreibung
Dieser Vorgang muss an die Hauptregion weitergeleitet werden.
Fehlerbehebung
Dieser Vorgang muss an die Hauptregion weitergeleitet werden. Aktualisieren Sie den Quellcode, um die korrekten Regionsinformationen anzugeben.NotAuthorized
Beschreibung
Sie sind nicht berechtigt, ein oder mehrere der Felder zu aktualisieren, die in dieser Anforderung enthalten sind.
Fehlerbehebung
Prüfen Sie die Anforderung, und entfernen Sie nicht autorisierte Felder. Weitere Informationen zu Berechtigungen finden Sie unter Policy-Referenz.Fehler - HTTP-Statuscode 404
NamespaceNotFound
Beschreibung
Eine Ressource, die über die URI (Pfad- oder Abfrageparameter) der Anforderung angegeben wurde, wurde nicht gefunden, oder Sie haben keine Zugriffsberechtigung für diese Ressource.
Fehlerbehebung
Die Ressource wurde nicht gefunden, oder der aufrufende Benutzer ist nicht autorisiert, den angeforderten Vorgang für eine Ressource auszuführen, die über die Anforderungs-URI für GET- (Auflisten oder Abrufen einzelner Entitys), UPDATE- und DELETE-Vorgänge angegeben wurde. Prüfen Sie, ob die angeforderte Ressource tatsächlich vorhanden ist und Sie Zugriff darauf haben. Weitere Informationen zu Berechtigungen finden Sie unter Policy-Referenz.NotFound
Beschreibung
In dem URI-Pfad und der HTTP-Methode, die Sie in der Anforderung angegeben haben, wird kein Vorgang unterstützt.
Fehlerbehebung
Entweder sind die Komponenten des statischen Pfades nicht vorhanden, oder Sie sind nicht berechtigt, darauf zuzugreifen. Prüfen Sie die Anforderung, und aktualisieren Sie die statische Pfadkomponente.NotAuthorizedOrNotFound
Beschreibung
Eine Ressource, die über die URI (Pfad- oder Abfrageparameter) der Anforderung angegeben wurde, wurde nicht gefunden, oder Sie haben keine Zugriffsberechtigung für diese Ressource.
Fehlerbehebung
Die Ressource wurde nicht gefunden, oder der aufrufende Benutzer ist nicht autorisiert, den angeforderten Vorgang für eine Ressource auszuführen, die über die Anforderungs-URI für GET- (Auflisten oder Abrufen einzelner Entitys), UPDATE- und DELETE-Vorgänge angegeben wurde. Prüfen Sie, ob die angeforderte Ressource tatsächlich vorhanden ist und Sie Zugriff darauf haben. Weitere Informationen zu Berechtigungen finden Sie unter Policy-Referenz.InvalidParameter
Beschreibung
Ein im Pfad angegebener Parameter ist ungültig oder syntaktisch gültig, aber nicht zulässig.
Fehlerbehebung
Prüfen Sie die Parameter in der Anforderung auf Tippfehler oder falsche Formate. Informationen zum Vorgang finden Sie in der REST-API-Dokumentation. Korrigieren Sie die Anforderung.Fehler - HTTP-Statuscode 405
MethodNotAllowed
Beschreibung
Die Zielressource unterstützt die verwendete HTTP-Methode nicht.
Fehlerbehebung
Die HTTP-Methode in der Anforderung (z.B. PUT, POST, DELETE oder GET) ist für die Zielressource nicht zulässig. Prüfen Sie, ob die beabsichtigte HTTP-Methode korrekt angegeben ist. Vergewissern Sie sich mithilfe der REST-API-Dokumentation, dass Sie die korrekte HTTP-Methode verwenden.Fehler - HTTP-Statuscode 409
NotAuthorizedOrResourceAlreadyExists
Beschreibung
Sie haben keine Berechtigung zum Ausführen dieser Anforderung, oder die Ressource, die Sie erstellen möchten, ist bereits vorhanden. Dieser Fehlercode wird nur von create-Vorgängen anstelle des allgemeineren NotAuthorizedOrNotFound-Fehlercodes zurückgegeben.
Fehlerbehebung
- Wenn die Anforderung eine Ressource erstellen soll, stellen Sie sicher, dass die Ressource noch nicht vorhanden ist und dass der aufrufende Benutzer autorisiert ist, diesen Ressourcentyp in diesem Compartment zu erstellen.
- Prüfen Sie, ob der Benutzer in einer Gruppe ist, die zur Arbeit mit Ressourcen in einem Compartment berechtigt ist. Weitere Informationen zu Berechtigungen finden Sie unter Policy-Referenz.
InvalidatedRetryToken
Beschreibung
Das angegebene Wiederholungstoken wurde in einer früheren Anforderung verwendet, die zu einer Systemaktualisierung geführt hat. Das Token ist jedoch durch einen nachfolgenden Vorgang ungültig geworden. Dies kann passieren, wenn eine Entity, die mit demselben Token erstellt wurde, seither gelöscht wurde. Wenn die mit dieser Anforderung verknüpfte Systemstatusänderung erneut ausgeführt werden soll, verwenden Sie ein anderes Token.
Fehlerbehebung
Prüfen Sie den Quellcode, und stellen Sie sicher, dass das Wiederholungstoken korrekt verwendet wird.ExternalServerIncorrectState
Beschreibung
Der Server befindet sich in einem falschen Status und hat ein Timeout, hat eine ungültige Antwort zurückgegeben oder ist nicht erreichbar.
Fehlerbehebung
Versuchen Sie Folgendes:
- Weitere Informationen finden Sie in der Fehlermeldung. Möglicherweise müssen Sie Ihren Server neu eintippen und sicherstellen, dass Oracle-Services darauf zugreifen können.
- Weitere Informationen finden Sie in den Fehlerlogs auf Ihrem Server.
- Möglicherweise ist auf Ihrem Server ein temporäres Problem aufgetreten. Warten Sie einen Moment, und wiederholen Sie dann die Anforderung.
- Wenn die Anforderung weiterhin nicht erfolgreich verläuft, wenden Sie sich an den technischen OCI-Support, und geben Sie die opc-Anforderungs-ID aus der nicht erfolgreichen HTTP-Anforderung oder -Antwort an.
IncorrectState
Beschreibung
Der angeforderte Status für die Ressource steht mit dem aktuellen Status in Konflikt, die Ressource wird aber nach einem gewissen Zeitraum den korrekten Status haben.
Fehlerbehebung
Versuchen Sie Folgendes:
- Prüfen Sie die Ressourcenabhängigkeiten. Eine Ressource kann nicht gelöscht werden, wenn sie noch von anderen Ressourcen verwendet wird.
- Stellen Sie die Anforderung später erneut, oder aktualisieren Sie den Code so, dass gewartet wird, bis der richtige Status erreicht ist, bevor diese Aktion ausgeführt wird. Bei einigen Vorgängen muss die Ressource einen bestimmten Status aufweisen (z.B. "Wird ausgeführt").
Conflict
Beschreibung
Der angeforderte Status für die Ressource steht mit dem aktuellen Status in Konflikt. Dieser Status ist nicht transient.
Fehlerbehebung
Prüfen Sie den Status der angeforderten Ressource, und versuchen Sie es erneut.Fehler - HTTP-Statuscode 412
NoEtagMatch
Beschreibung
Das im if-match-Feld der Anforderung angegebene Entitytag stimmt nicht mit dem Entitytag für die Ressource überein.
Fehlerbehebung
Korrigieren Sie das Entitytag in der Anforderung, wenn dies nicht erwartet wird. Weitere Informationen zu Entitytags finden Sie in der Entitytag-Dokumentation.
Fehler - HTTP-Statuscode 413
PayloadTooLarge
Beschreibung
Die Anforderungsentity ist größer als die vom Server definierten Limits.
Fehlerbehebung
Versuchen Sie, eine kleinere Anforderung zu senden.
Fehler - HTTP-Statuscode 422
UnprocessableEntity
Beschreibung
Die Payload ist syntaktisch korrekt, aber semantisch ungültig.
Fehlerbehebung
Der Service kann die Anforderung nicht verarbeiten. Prüfen Sie die Anforderung, und formatieren Sie sie gegebenenfalls neu.
Fehler - HTTP-Statuscode 429
TooManyRequests
Beschreibung
Sie haben zu viele Anforderungen zu schnell an die Oracle Cloud Infrastructure-APIs ausgegeben.
Fehlerbehebung
Dies wird durch zu viele Anforderungen innerhalb kurzer Zeit verursacht. Wenn der Service Throttling-Mechanismen verwendet, können zu viele Anforderungen innerhalb eines kurzen Zeitraums dazu führen, dass einige Anforderungen abgelehnt werden. Versuchen Sie, Verzögerungen zwischen Anforderungen hinzuzufügen, um diesen Fehler zu vermeiden.
Fehler - HTTP-Statuscode 431
RequestHeaderFieldsTooLarge
Beschreibung
Die HTTP-Header in der Anforderung sind zu lang.
Fehlerbehebung
Die Anforderung kann erneut übermittelt werden, nachdem die Größe der Anforderungsheader reduziert wurde.
Fehler - HTTP-Statuscode 500
InternalServerError
Beschreibung
Ein interner Serverfehler ist aufgetreten.
Fehlerbehebung
Der Service konnte die Anforderung aus unbekannten Gründen nicht verarbeiten. Dies ist in der Regel ein Problem auf der Serviceseite, möglicherweise aufgrund eines temporären Serviceausfalls oder eines Bugs. Versuchen Sie, dieselbe Anforderung erneut zu senden. Wenn auch der Wiederholungsversuch nicht erfolgreich verläuft, wenden Sie sich an den technischen OCI-Support, und geben Sie in Ihrer Nachricht die opc-request-id aus der nicht erfolgreichen HTTP-Anforderung oder -Antwort an.
Fehler - HTTP-Statuscode 501
MethodNotImplemented
Beschreibung
Das HTTP-Anforderungsziel erkennt die HTTP-Methode nicht.
Fehlerbehebung
Die HTTP-Methode in der Anforderung ist im Service nicht implementiert. Informationen zum Vorgang finden Sie in der REST-API-Dokumentation. Aktualisieren Sie die Anforderung, um die richtige HTTP-Methode für den Vorgang zu verwenden.