Diese Seite enthält Informationen zur Fehlerbehebung für jede Version der folgenden APIs von Service Infrastructure:
- Service Management API
- Service Control API
- Service Consumer Management API
Wie gehe ich allgemein mit Service Control API-Fehlern um?
Die Service Control API bietet Funktionen auf Steuerungsebene wie Logging und Monitoring für verwaltete Dienste. Daher wird die Service Control API normalerweise von Serveranwendungen aufgerufen. Hier einige allgemeine Empfehlungen zum Umgang mit Fehlern auf REST/RPC API-Ebene:
- Ihr Server sollte alle Fehler in einem Log protokollieren, die von der Service Control API zurückgegeben werden. Diese Daten können für die Fehlerbehebung im verwalteten Dienst nützlich sein.
- Wenn Ihr Server
429
-Fehler von der Service Control API empfängt, sollte er429
-Fehler an seine Clients zurückgeben. - Wenn Ihr Server keinen Zugriff auf die Service Control API hat, kann er entweder den Fehler ignorieren ("fail-open") oder
503
an seinen Client zurückgeben ("fail-close"). - Wenn Ihr Server
500
-Fehler von der Service Control API empfängt, sollte er500
-Fehler an seine Clients zurückgeben. Diese Fehlercodes weisen normalerweise auf Programmfehler in der Service Control API hin. - Wenn Ihr Server andere Fehler von der Service Control API empfängt, sollte er den
500
-Fehler an seine Clients zurückgeben. Diese Fehlercodes weisen normalerweise auf Programmfehler im verwalteten Dienst hin.
Was bedeutet der Fehler "Dienst nicht aktiviert"?
Damit Sie einen Google API-Dienst verwenden können, müssen Sie ein Google Cloud-Projekt haben, den Dienst für dieses Projekt aktivieren und einen zum Projekt gehörenden API-Schlüssel oder ein OAuth-Zugriffstoken für jede API-Anfrage übergeben. Weitere Informationen finden Sie im Authentifizierungsleitfaden. Zum Beheben dieses Fehlers müssen Sie den Dienst für Ihr Projekt über die Google Cloud Console, die Google Cloud CLI oder die Service Usage API aktivieren. Informationen zum Aktivieren eines Dienstes finden Sie unter Dienste aktivieren und deaktivieren.
Wie behebe ich Fehler wegen verweigerter Berechtigungen?
Dieser Fehler tritt normalerweise auf, wenn der Aufrufer nicht die erforderliche IAM-Berechtigung (Identity and Access Management) für bestimmte Ressourcen hat. Informationen zu den erforderlichen Berechtigungen für jede der folgenden APIs von Service Infrastructure finden Sie auf der entsprechenden Seite zur Zugriffssteuerung:
Wie kann ich den Aufruf bei einem API-Fehler wiederholen?
Sie sollten eine Wiederholung mit zufälligen, exponentiellen Intervallen vornehmen.
Das minimale Wiederholungsintervall sollte 30 Sekunden für den Kontingentfehler 429
und 1 Sekunde für die Serverfehler 500
und 503
betragen. Bei anderen Fehlern sollte eine Wiederholung nur anhand zusätzlicher Fehlerinformationen vorgenommen werden. Unter google.rpc.Code
finden Sie weitere Informationen.
Wie fordere ich höhere API-Kontingente an?
Informationen zum Anfordern eines höheren Kontingents für jede der folgenden APIs von Service Infrastructure finden Sie im entsprechenden Abschnitt der Seite Kontingente:
- Kontingent für die Service Control-API
- Kontingent für die Consumer Management API
- Kontingent für die Service Management API
Wie behebe ich Fehler der Art "Eigentumsrechte für den Domainnamen können nicht überprüft werden"?
Dieser Fehler gibt an, dass der Aufrufer nicht der Eigentümer des Domainnamens ist, der für den Namen des verwalteten Dienstes in einer Dienstkonfiguration verwendet wird. Folgen Sie dieser Anleitung, um eine gültige Domain zu verwenden.