Anfragen zur Größenanpassung in einer MIG aufrufen, abbrechen oder löschen

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

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. 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:

  • 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

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:

  1. Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

    Zu den Instanzgruppen

  2. 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.

  3. 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.

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:

  • 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.

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 Methode beta.instanceGroupManagerResizeRequests.list.

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests

Ersetzen Sie Folgendes:

  • 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.

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:

  • 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.

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:

  • 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.

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 Methode beta.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:

  • 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.

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:

  1. Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

    Zu den Instanzgruppen

  2. 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.

  3. 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.

  4. Wählen Sie die Anfragen zur Größenänderung aus, die abgebrochen werden sollen.

  5. Klicken Sie auf Abbrechen und dann auf Bestätigen.

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:

  • 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 beispielsweise request-1,request-2 an.

  • ZONE: Die Zone, in der sich die MIG befindet.

REST

Wenn Sie eine Anfrage zur Größenänderung in einer zonalen MIG abbrechen möchten, senden Sie eine POST-Anfrage an die Methode beta.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:

  • 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.

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:

  • Erfolgreich (SUCCEEDED)

  • Fehlgeschlagen (FAILED)

  • Storniert (CANCELLED)

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:

  1. Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

    Zu den Instanzgruppen

  2. 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.

  3. 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.

  4. Wählen Sie die Anfragen zur Größenanpassung aus, die gelöscht werden sollen.

  5. Klicken Sie auf Löschen und dann auf Bestätigen.

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:

  • 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 beispielsweise request-1,request-2 an.

  • ZONE: Die Zone, in der sich die MIG befindet.

REST

Wenn Sie eine Anfrage zur Größenänderung in einer zonalen MIG löschen möchten, senden Sie eine DELETE-Anfrage an die Methode beta.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:

  • PROJECT_IDist 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.

Nächste Schritte