In diesem Dokument wird gezeigt, wie Sie Probleme bei Erstellungsvorgängen der Bulk Instance API beheben.
Fehler bei Vorgängen
Wenn Sie die Bulk Instance API zum Erstellen von VMs verwenden, geben create
-Anfragen HTTP 200 OK
mit dem Status RUNNING
zurück, wenn die Anfrage erfolgreich gestartet wird. Wenn die Anfrage nicht erfolgreich gestartet wird, gibt die API eine der im Folgenden aufgeführten Antworten zurück.
Ungültig
Wenn beim Erstellen von VMs die folgenden API-Antwortfelder vorhanden sind, wurde Ihre API-Anfrage nicht richtig programmiert oder sie verwendet ein Attribut, das von der Bulk API nicht unterstützt wird.
API-Antwortfelder:
HTTP 400
"reason": "invalid"
So beheben Sie das Problem:
- Prüfen Sie das Feld
message
in der Antwort, um zu ermitteln, welches Attribut in der Anfrage den Fehler verursacht hat. - Ändern Sie das Attribut, das den Fehler verursacht hat.
- Wiederholen Sie die Anfrage.
- Wenn die Anfrage wiederum fehlschlägt, versuchen Sie, die Anfrage mit dem API Explorer zu validieren. Weitere Informationen finden Sie unter API-Anfragen validieren.
Kontingent wurde überschritten
Wenn beim Erstellen von VMs die folgenden API-Antwortfelder vorhanden sind, haben Sie ein Kontingentlimit für eine Ressource erreicht. Weitere Informationen zu Kontingenten finden Sie unter Ressourcenkontingente.
API-Antwortfelder:
HTTP 403
"reason": "quotaExceeded"
- Prüfen Sie das Feld "message", um festzustellen, welches Ressourcenkontingent mit der Anfrage überschritten wurde.
- Führen Sie einen der folgenden Schritte aus:
- Wiederholen Sie die Anfrage mit einer kleineren Anzahl an VMs.
- Fordern Sie ein höheres Kontingent an.
Ratenbegrenzung wurde überschritten
Wenn beim Erstellen von VMs die folgenden API-Antwortfelder vorhanden sind, haben Sie das Limit von 20 Anfragen pro Sekunde erreicht oder mehr als 10 Bulk-Vorgänge gleichzeitig ausgeführt.
API-Antwortfelder:
HTTP 403
"reason": "rateLimitExceeded"
Um dieses Problem zu beheben, warten Sie, bis einige Anfragen abgeschlossen sind, und wiederholen Sie dann Ihre Anfrage.
Unzureichende Kapazität
Wenn beim Erstellen von VMs die folgenden API-Antwortfelder vorhanden sind, hat die Region oder die Zone, in der Sie VMs erstellen möchten, keine ausreichende Kapazität.
API-Antwortfelder:
HTTP 503
"reason": "insufficientCapacity"
- VMs in einer anderen Region erstellen
- VMs bei Verwendung des zonalen Endpunkts in einer anderen Zone erstellen
- Andere VM-Konfiguration verwenden
- Anfrage später wiederholen
Fehler beim Anfragestatus
Wenn Sie zum Erstellen von VMs die Bulk Instance API verwenden, gibt Ihre create
-Anfrage HTTP 200 OK
mit dem Status RUNNING
zurück, wenn die Anfrage erfolgreich gestartet wird.
Die Anfrage kann jedoch fehlschlagen, bevor sie abgeschlossen ist. Sie können den Status Ihrer Anfrage prüfen, um festzustellen, ob sie erfolgreich abgeschlossen wurde. Wenn die Anfrage nicht erfolgreich abgeschlossen wurde, wird einer der im Folgenden aufgeführten Anfragestatus angezeigt.
Kontingent wurde überschritten
Wenn beim Abfragen von Vorgängen die folgenden API-Antwortfelder vorhanden sind, ist Ihre Anfrage fehlgeschlagen, da Sie ein Kontingentlimit für eine Ressource erreicht haben. Weitere Informationen zu Kontingenten finden Sie unter Ressourcenkontingente.
API-Antwortfelder:
"status": "done"
"httpErrorMessage": "FORBIDDEN"
"code"": "QUOTA_EXCEEDED"
So beheben Sie das Problem:
- Prüfen Sie das Feld "message", um festzustellen, welches Ressourcenkontingent mit der Anfrage überschritten wurde.
- Führen Sie einen der folgenden Schritte aus:
- Wiederholen Sie die Anfrage mit einer kleineren Anzahl an VMs.
- Fordern Sie ein höheres Kontingent an.
Ressource ist bereits vorhanden
Wenn beim Abrufen von Vorgängen die folgenden API-Antwortfelder vorhanden sind, ist Ihre Anfrage fehlgeschlagen, weil versucht wurde, eine bereits vorhandene Ressource zu erstellen.
API-Antwortfelder:
code: RESOURCE_ALREADY_EXISTS
httpErrorMessage: CONFLICT
status: DONE
So beheben Sie das Problem:
- Prüfen Sie im Feld
message
den Namen der Ressource, die bereits vorhanden ist. - Wiederholen Sie Ihre Anfrage mit einem anderen
namePattern
. Weitere Informationen finden Sie unter Mehrere VMs in einer Region erstellen.
Unzureichende Kapazität
Wenn beim Abrufen von Vorgängen die folgenden API-Antwortfelder vorhanden sind, ist Ihre Anfrage fehlgeschlagen, da die Region oder die Zone (bei Verwendung des zonalen Endpunkts), in der Sie VMs erstellt haben, keine ausreichende Kapazität hat.
API-Antwortfelder:
"status": "DONE"
"httpErrorMessage": "SERVICE UNAVAILABLE"
"code": "ZONE_RESOURCE_POOL_EXHAUSTED"
Führen Sie einen der folgenden Schritte aus, um das Problem zu lösen:
- VMs in einer anderen Region erstellen
- VMs bei Verwendung des zonalen Endpunkts in einer anderen Zone erstellen
- Andere VM-Konfiguration verwenden
- Anfrage später wiederholen
Nächste Schritte
- Weitere Informationen finden Sie unter Bulk Instance API verwenden.