In diesem Dokument wird beschrieben, wie Sie nach dem Erstellen einer Anfrage zur Größenänderung in einer verwalteten Instanzgruppe (MIG) Folgendes tun:
Rufen Sie Anfragen zur Größenanpassung in einer MIG auf, um ihren Status zu überwachen oder Fehler zu beheben.
Brechen Sie Anfragen zur Größenanpassung ab, um zu verhindern, dass eine MIG die angeforderte Anzahl von VM-Instanzen erstellt.
Löschen Sie Anfragen zur Größenanpassung.
Hinweise
-
Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben.
Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft.
Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
So brechen Sie Anfragen zur Größenanpassung in einer MIG ab oder löschen sie:
compute.instanceGroupManagers.update
-
So rufen Sie eine Liste der Anfragen zur Größenanpassung in einer MIG auf:
compute.instanceGroupManagers.list
-
So rufen Sie die Details einer Anfrage zur Größenänderung auf:
compute.instanceGroupManagers.get
Wenn Sie die Konfigurationsdetails und Status aller Anfragen zur Größenanpassung in einer MIG aufrufen möchten, rufen Sie eine Liste der Anfragen zur Größenänderung in einer MIG auf.
Wenn Sie die Konfigurationsdetails, den Status und die Fehlermeldungen in einer Anfrage zur Größenänderung ansehen möchten, rufen Sie die Details einer Anfrage zur Größenänderung auf.
Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Klicken Sie in der Spalte Name auf den Namen der MIG, die Anfragen zur Größenanpassung enthält.
Die Übersichtsseite der MIG wird geöffnet.
Klicken Sie in der Zeile Anfrage zur Größenänderung auf
Anfragen zur Größenänderung bearbeiten.Der Bereich Anfragen zur Größenanpassung wird angezeigt.
INSTANCE_GROUP_NAME
ist der Name einer vorhandenen zonalen MIG mit akzeptierten, erfolgreichen, abgebrochenen oder fehlgeschlagenen Anfragen zur Größenänderung.ZONE
: Die Zone, in der sich die MIG befindet.PROJECT_ID
ist die ID des Projekts, in dem sich eine vorhandene zonale MIG mit akzeptierten, erfolgreichen, abgebrochenen oder fehlgeschlagenen Anfragen zur Größenanpassung befindet.ZONE
: Die Zone, in der sich die MIG befindet.INSTANCE_GROUP_NAME
ist der Name einer vorhandenen zonalen MIG mit akzeptierten, erfolgreichen, abgebrochenen oder fehlgeschlagenen Anfragen zur Größenänderung.ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS
: Die angeforderten Ressourcen sind vorübergehend nicht verfügbar.QUOTA_EXCEEDED
: In Ihrem Projekt fehlt das Kontingent für die angeforderten Ressourcen. Informationen zum Erhöhen des Kontingents Ihres Projekts finden Sie unter Höheres Kontingent anfordern.INSTANCE_GROUP_NAME
ist der Name einer vorhandenen zonalen MIG, in der sich die Anfrage zur Größenänderung befindet.RESIZE_REQUEST_NAME
ist der Name einer vorhandenen Anfrage zur Größenänderung, deren Details Sie aufrufen möchten.ZONE
: Die Zone, in der sich die MIG befindet.PROJECT_ID
ist die ID des Projekts, in dem sich die zonale MIG befindet.ZONE
: Die Zone, in der sich die MIG befindet.INSTANCE_GROUP_NAME
ist der Name einer vorhandenen zonalen MIG, in der sich die Anfrage zur Größenänderung befindet.RESIZE_REQUEST_NAME
ist der Name einer vorhandenen Anfrage zur Größenänderung, deren Details Sie aufrufen möchten.Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Klicken Sie in der Spalte Name auf den Namen der MIG, die Anfragen zur Größenanpassung enthält.
Die Übersichtsseite der MIG wird geöffnet.
Klicken Sie in der Zeile Anfrage zur Größenänderung auf
Anfragen zur Größenänderung bearbeiten.Der Bereich Anfragen zur Größenanpassung wird angezeigt.
Wählen Sie die Anfragen zur Größenänderung aus, die abgebrochen werden sollen.
Klicken Sie auf
Abbrechen und dann auf Bestätigen.INSTANCE_GROUP_NAME
ist der Name einer vorhandenen zonalen MIG mit akzeptierten Anfragen zur Größenänderung.RESIZE_REQUEST_NAMES
ist eine durch Kommas getrennte Liste der Namen akzeptierter Anfragen zur Größenänderung in der angegebenen zonalen MIG. Geben Sie beispielsweiserequest-1,request-2
an.ZONE
: Die Zone, in der sich die MIG befindet.PROJECT_ID
ist die ID des Projekts, in dem sich eine vorhandene zonale MIG mit einer akzeptierten Anfrage zur Größenänderung befindet.ZONE
: Die Zone, in der sich die MIG befindet.INSTANCE_GROUP_NAME
: Name der MIG.RESIZE_REQUEST_NAME
ist der Name der Anfrage zur Größenänderung, die abgebrochen werden soll.Erfolgreich (
SUCCEEDED
)Fehlgeschlagen (
FAILED
)Storniert (
CANCELLED
)Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.
Klicken Sie in der Spalte Name auf den Namen der MIG, die Anfragen zur Größenanpassung enthält.
Die Übersichtsseite der MIG wird geöffnet.
Klicken Sie in der Zeile Anfrage zur Größenänderung auf
Anfragen zur Größenänderung bearbeiten.Der Bereich Anfragen zur Größenanpassung wird angezeigt.
Wählen Sie die Anfragen zur Größenanpassung aus, die gelöscht werden sollen.
Klicken Sie auf
Löschen und dann auf Bestätigen.INSTANCE_GROUP_NAME
ist der Name einer vorhandenen zonalen MIG mit erfolgreichen, fehlgeschlagenen oder abgebrochenen Anfragen zur Größenanpassung.RESIZE_REQUEST_NAMES
ist eine durch Kommas getrennte Liste der Namen von Anfragen zur Größenanpassung, die in der MIG gelöscht werden sollen. Geben Sie beispielsweiserequest-1,request-2
an.ZONE
: Die Zone, in der sich die MIG befindet.PROJECT_ID
ist die ID des Projekts, in dem sich eine vorhandene zonale MIG mit erfolgreichen, fehlgeschlagenen oder abgebrochenen Anfragen zur Größenanpassung befindet.ZONE
: Die Zone, in der sich die MIG befindet.INSTANCE_GROUP_NAME
: Name der MIG.RESIZE_REQUEST_NAME
ist der Name der zu löschenden Anfrage zur Größenänderung.
REST
Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen für das Projekt die IAM-Rolle Compute Instance Admin (Version 1) (
roles/compute.instanceAdmin.v1
) zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Aufrufen, Abbrechen oder Löschen von Anfragen zur Größenanpassung in einer MIG benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aufrufen, Abbrechen oder Löschen von Anfragen zur Größenanpassung in einer MIG erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um Anfragen zur Größenanpassung in einer MIG aufzurufen, abzubrechen oder zu löschen:
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Anfragen zur Größenänderung anzeigen
Verwenden Sie basierend auf den Details, die Sie in einer Anfrage zur Größenänderung anzeigen möchten, eine der folgenden Methoden:
Liste der Anfragen zur Größenänderung in einer MIG aufrufen
Sie können eine Liste aller Anfragen zur Größenänderung in einer MIG und der zugehörigen Details aufrufen, z. B. den Status, die angeforderte Anzahl von VMs und die Ausführungsdauer der VMs.
Console
So rufen Sie eine Liste aller Anfragen zur Größenanpassung in einer MIG auf:
gcloud
Verwenden Sie den Befehl
beta instance-groups managed resize-requests list
, um eine Liste aller Anfragen zur Größenänderung in einer MIG aufzurufen.gcloud beta compute instance-groups managed resize-requests list INSTANCE_GROUP_NAME \ --zone=ZONE
Ersetzen Sie Folgendes:
Die Ausgabe sieht in etwa so aus:
NAME: rr-01 LOCATION: us-central1-a SCOPE: zone RESIZE_BY: 5 STATE: SUCCEEDED REQUESTED_RUN_DURATION: P1D NAME: rr-02 LOCATION: us-central1-a SCOPE: zone RESIZE_BY: 10 STATE: ACCEPTED REQUESTED_RUN_DURATION: P3D
REST
Wenn Sie eine Liste aller Größenanfragen in einer zonalen MIG aufrufen möchten, senden Sie eine
GET
-Anfrage an die Methodebeta.instanceGroupManagerResizeRequests.list
.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests
Ersetzen Sie Folgendes:
Die Ausgabe sieht in etwa so aus:
{ "kind": "compute#instanceGroupManagerResizeRequestList", "id": "projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests", "items": [ { "kind": "compute#instanceGroupManagerResizeRequest", "id": "4247139565532196982", "creationTimestamp": "2024-01-08T07:51:53.034-08:00", "name": "rr-01", "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a", "count": 5, "resizeBy": 5, "requestedRunDuration": { "seconds": "86400", "nanos": 0 }, "state": "SUCCEEDED", "status": {}, "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/rr-01", "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/4247139565532196982" }, { "kind": "compute#instanceGroupManagerResizeRequest", "id": "8095866098849525652", "creationTimestamp": "2024-01-11T08:04:11.851-08:00", "name": "rr-02", "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a", "count": 10, "resizeBy": 10, "requestedRunDuration": { "seconds": "259200", "nanos": 0 }, "state": "ACCEPTED", "status": {}, "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/rr-02", "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/8095866098849525652" } ], "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests" }
Details einer Anfrage zur Größenänderung ansehen
Sie können die Details einer Anfrage zur Größenänderung aufrufen, um ihre Konfiguration zu prüfen und optional Fehler zu beheben, wenn die Anfrage noch nicht erfolgreich war.
Prüfen Sie das Feld
lastAttempt.error.errors.code
in den Details, um zu ermitteln, warum eine Anfrage zur Größenanpassung (ACCEPTED
) nicht erfolgreich ist. Mögliche Fehlercodes:gcloud
Verwenden Sie den Befehl
beta instance-groups managed resize-requests describe
, um die Details einer Anfrage zur Größenanpassung in einer zonalen MIG aufzurufen.gcloud beta compute instance-groups managed resize-requests describe INSTANCE_GROUP_NAME \ --resize-request=RESIZE_REQUEST_NAME \ --zone=ZONE
Ersetzen Sie Folgendes:
Die Ausgabe sieht in etwa so aus:
creationTimestamp: '2024-01-10T07:51:53.034-08:00' id: '4247139565532196982' kind: compute#instanceGroupManagerResizeRequest name: example-request requestedRunDuration: nanos: 0 seconds: '6000' resizeBy: 10 selfLink: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/example-request selfLinkWithId: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/4247139565532196982 state: ACCEPTED status: lastAttempt: error: errors: - code: ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS message: There are currently not enough resources available to fulfill the request. - code: QUOTA_EXCEEDED message: Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1. zone: https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a
REST
Wenn Sie die Details einer Anfrage zur Größenänderung in einer MIG aufrufen möchten, senden Sie eine
GET
-Anfrage an die Methodebeta.instanceGroupManagerResizeRequests.get
.GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME
Ersetzen Sie Folgendes:
Die Ausgabe sieht in etwa so aus:
{ "kind": "compute#instanceGroupManagerResizeRequest", "id": "4247139565532196982", "creationTimestamp": "2024-01-10T07:51:53.034-08:00", "name": "example-request", "zone": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a", "count": 10, "resizeBy": 10, "requestedRunDuration": { "seconds": "6000", "nanos": 0 }, "state": "ACCEPTED", "status": { "lastAttempt": { "error": { "errors": [ { "code": "ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS", "message": "There are currently not enough resources available to fulfill the request.", }, { "code": "QUOTA_EXCEEDED", "message": "Quota 'NVIDIA_A100_GPUS' exceeded. Limit: 1500 in region us-central1." } ] } } }, "selfLink": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/example-request", "selfLinkWithId": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-a/instanceGroupManagers/example-mig/resizeRequests/4247139565532196982" }
Anfragen zur Größenanpassung in einer MIG abbrechen
Sie können Anfragen zur Größenanpassung in einer MIG abbrechen, um zu verhindern, dass die MIG versucht, die angeforderte Anzahl von VMs zu erstellen. Sie können nur akzeptierte (
ACCEPTED
) Anfragen zur Größenanpassung abbrechen. Nachdem Sie eine Anfrage zur Größenänderung abgebrochen haben, können Sie sie entweder löschen oder von Compute Engine nach 14 Tagen automatisch löschen lassen.Wenn Sie mehrere Anfragen zur Größenänderung gleichzeitig abbrechen möchten, verwenden Sie die Google Cloud Console oder die gcloud CLI.
Console
So brechen Sie Anfragen zur Größenanpassung in einer zonalen MIG ab:
gcloud
Verwenden Sie den Befehl
beta instance-groups managed resize-requests cancel
, um Anfragen zur Größenanpassung in einer zonalen MIG abzubrechen.gcloud beta compute instance-groups managed resize-requests cancel INSTANCE_GROUP_NAME \ --resize-requests=RESIZE_REQUEST_NAMES \ --zone=ZONE
Ersetzen Sie Folgendes:
REST
Wenn Sie eine Anfrage zur Größenänderung in einer zonalen MIG abbrechen möchten, senden Sie eine
POST
-Anfrage an die Methodebeta.instanceGroupManagerResizeRequests.cancel
.POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME/cancel
Ersetzen Sie Folgendes:
Anfragen zur Größenanpassung in einer MIG löschen
Standardmäßig löscht Compute Engine eine Anfrage zur Größenanpassung automatisch 14 Tage, nachdem der Status der Anfrage auf einen der folgenden Werte festgelegt wurde:
Sie können eine Anfrage zur Größenänderung jedoch vorher sofort löschen, wie in diesem Abschnitt beschrieben.
Wenn Sie eine erfolgreiche Anfrage zur Größenänderung löschen, werden die in der Anfrage erstellten VMs nicht gelöscht. Die MIG löscht diese VMs automatisch am Ende der angeforderten Ausführungsdauer. Wenn Ihr Job jedoch abgeschlossen ist und Sie die VMs nicht mehr benötigen, löschen Sie die VMs.
Verwenden Sie die Google Cloud Console oder die gcloud CLI, um mehrere Anfragen zur Größenanpassung gleichzeitig zu löschen.
Console
So löschen Sie Anfragen zur Größenanpassung in einer zonalen MIG:
gcloud
Verwenden Sie den Befehl
beta instance-groups managed resize-requests delete
, um Anfragen zur Größenanpassung in einer zonalen MIG zu löschen.gcloud beta compute instance-groups managed resize-requests delete INSTANCE_GROUP_NAME \ --resize-requests=RESIZE_REQUEST_NAMES \ --zone=ZONE
Ersetzen Sie Folgendes:
REST
Wenn Sie eine Anfrage zur Größenänderung in einer zonalen MIG löschen möchten, senden Sie eine
DELETE
-Anfrage an die Methodebeta.instanceGroupManagerResizeRequests.delete
.DELETE https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME
Ersetzen Sie Folgendes:
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-10-14 (UTC).
-