ErrorInfo

Beschreibt die Fehlerursache mit strukturierten Details.

Beispiel für einen Fehler bei der Kontaktaufnahme mit der "pubsub.googleapis.com" API, wenn sie nicht aktiviert ist:

{ "reason": "API_DISABLED"
  "domain": "googleapis.com"
  "metadata": {
    "resource": "projects/123",
    "service": "pubsub.googleapis.com"
  }
}

Diese Antwort gibt an, dass die pubsub.googleapis.com API nicht aktiviert ist.

Beispiel für einen Fehler, der beim Versuch zurückgegeben wird, eine Spanner-Instanz in einer Region zu erstellen, die nicht auf Lager ist:

{ "reason": "STOCKOUT"
  "domain": "spanner.googleapis.com",
  "metadata": {
    "availableRegions": "us-central1,us-east2"
  }
}
JSON-Darstellung 
{
  "reason": string,
  "domain": string,
  "metadata": {
    string: string,
    ...
  }
}
Felder
reason

string

Die Ursache des Fehlers. Dies ist ein konstanter Wert, der die unmittelbare Ursache des Fehlers angibt. Fehlerursachen sind innerhalb einer bestimmten Fehlerdomain eindeutig. Diese darf höchstens 63 Zeichen umfassen und mit dem regulären Ausdruck [A-Z][A-Z0-9_]+[A-Z0-9] für UPPER_SNAKE_CASE übereinstimmen.
domain

string

Die logische Gruppierung, zu der der "reason" gehört. Die Fehlerdomain ist in der Regel der registrierte Dienstname des Tools oder Produkts, das den Fehler generiert. Beispiel: "pubsub.googleapis.com". Wenn der Fehler von einer gemeinsamen Infrastruktur generiert wird, muss die Fehlerdomain ein global eindeutiger Wert sein, der die Infrastruktur identifiziert. Bei der Google API-Infrastruktur lautet die Fehlerdomain „googleapis.com“.
metadata

map (key: string, value: string)

Weitere strukturierte Details zu diesem Fehler.

Schlüssel sollten "/[a-zA-Z0-9-_]/" entsprechen und auf 64 Zeichen beschränkt sein. Wenn der aktuelle Wert eines überschrittenen Limits benannt wird, sollten die Einheiten im Schlüssel enthalten sein, nicht im Wert. Beispielsweise sollte anstelle von {"instanceLimit": "100/request"} eben {"instanceLimitPerRequest": "100"} zurückgegeben werden, wenn der Client die Anzahl der Instanzen überschreitet, die in einer einzelnen (Batch) Anfrage erstellt werden können.