Fehler

Die folgenden Abschnitte beschreiben das Fehlermodell für v2- und v1-Ressourcenmethoden, respectively.

modellv2

Standardmäßig reagieren Ressourcenmethoden mit einem 200-OK-Status.Wenn Anfragen erfolglos sind, gibt Open Cloud Standard-Fehlercodes zurück.Alle Fehlerantworten haben das gleiche Format, das Folgendes beinhaltet:

• code - Repräsentiert den Codes.
• message - Eine Nachricht, die den Fehler erklärt.
• details - Ein Objekt, das mehr Informationen enthält, die spezifisch für den Fehler sind.

Beispielfehler
{
  "code": "INVALID_ARGUMENT",
  "message": "The provided filter is invalid.",
  "details": [
    {
      ...
    }
  ]
}

Kodierungen

Die folgende Tabelle beschreibt mögliche Werte für code.

modellv1

Alle Fehlerantworten haben das gleiche, standardmäßige Format, das umfasst:

• Ein error Feld, das eine hohe Ebene verursacht, die für alle Open Cloud-Endpunkte anwendbar ist.
• Ein erklärender Fehler message, der den Fehler weiter erklärt.
• Ein errorDetails Objekt, das mehr Informationen über den Fehler abdeckt, der für jede API spezifisch ist.

Um die Ursache eines Fehlers zu analysieren, beziehe dich auf den Wert des error -Feldes und des errorDetails -Feldes.Verwende das Feld message als Ergänzung für die Fehlerbehandlung, da es manchmal nicht die gleiche Detaillierungsstufe wie das Feld errorDetails abdeckt.

Beispiel Standard-Datenspeicherfehlerantwort
{
  "error": "INVALID_ARGUMENT",
  "message": "Invalid cursor.",
  "errorDetails": [
    {
      "errorDetailType": "DatastoreErrorInfo",
      "datastoreErrorCode": "InvalidCursor"
    }
  ]
}

Die Beispielfehlerantwort zeigt die hohe Ebene Open Cloud error als INVALID_ARGUMENT , den Fehler message als InvalidCursor und die errorDetails spezifische für Datenbanken mit der datastoreErrorCode als InvalidCursor.Aus den Feldern error und datastoreErrorCode der Antwort kannst du verstehen, dass du einen ungültigen Cursor-Parameter übergeben hast, der zu dem Fehler geführt hat.Du kannst dann deinen Cursor-Parameter korrigieren, um das Problem zu lösen.

Alle bestellten Datenspeicherfehlerantworten haben das gleiche Format, das Folgendes umfasst:

Beispiel bestellte Datenspeicherfehlerantwort
{
  "code": "INVALID_ARGUMENT",
  "message": "Invalid cursor."
}

Die code wird eine Zeichenkette des hohen Fehlers enthalten, während die message spezifische Details im Zusammenhang mit dem Fehler enthält

Kodierungen

Verweise auf die folgende Tabelle für eine Zusammenfassung aller hochrangigen Open Cloud-Fehler.