Afficher, annuler ou supprimer des requêtes de redimensionnement dans un MIG

Ce document explique comment effectuer les opérations suivantes après avoir créé une requête de redimensionnement dans un groupe d'instances géré (MIG) :

  • Afficher les requêtes de redimensionnement d'un MIG pour surveiller leurs états ou résoudre les problèmes associés

  • Annuler des requêtes de redimensionnement pour empêcher un MIG de créer le nombre d'instances de machines virtuelles (VM) demandé

  • Supprimer des requêtes de redimensionnement

Avant de commencer

  • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification est le processus permettant de valider votre identité pour accéder aux services et aux API Google Cloud. Pour exécuter du code ou des exemples depuis un environnement de développement local, vous pouvez vous authentifier auprès de Compute Engine comme suit :

    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

      Pour utiliser les exemples d'API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à gcloud CLI.

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

        gcloud init

      Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l'authentification Google Cloud.

Rôles requis

Pour obtenir les autorisations nécessaires pour afficher, annuler ou supprimer des requêtes de redimensionnement dans un MIG, demandez à votre administrateur de vous accorder le rôle IAM Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour afficher, annuler ou supprimer des requêtes de redimensionnement dans un MIG. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Vous devez disposer des autorisations suivantes pour afficher, annuler ou supprimer des requêtes de redimensionnement dans un MIG :

  • Pour annuler ou supprimer des requêtes de redimensionnement dans un MIG : compute.instanceGroupManagers.update
  • Pour afficher la liste des requêtes de redimensionnement d'un MIG : compute.instanceGroupManagers.list
  • Pour afficher les détails d'une requête de redimensionnement : compute.instanceGroupManagers.get

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Afficher les requêtes de redimensionnement

En fonction des informations que vous souhaitez afficher dans une requête de redimensionnement, utilisez l'une des méthodes suivantes :

Afficher la liste des requêtes de redimensionnement d'un MIG

Vous pouvez afficher la liste de toutes les requêtes de redimensionnement d'un MIG et les informations les concernant (par exemple, états, nombre de VM demandé et durée d'exécution des VM).

Console

Pour afficher la liste de toutes les requêtes de redimensionnement d'un MIG, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Groupes d'instances.

    Accéder à la page "Groupes d'instances"

  2. Dans la colonne Nom, cliquez sur le nom du MIG contenant les requêtes de redimensionnement.

    La page de présentation du MIG s'affiche.

  3. Sur la ligne Demandes de redimensionnement, cliquez sur  Modifier les demandes de redimensionnement.

    Le volet Demandes de redimensionnement s'affiche.

gcloud

Pour afficher la liste de toutes les demandes de redimensionnement d'un MIG, utilisez la commande instance-groups managed resize-requests list.

gcloud compute instance-groups managed resize-requests list INSTANCE_GROUP_NAME \
    --zone=ZONE

Remplacez les éléments suivants :

  • INSTANCE_GROUP_NAME : nom d'un MIG zonal existant comportant des requêtes de redimensionnement acceptées, terminées, annulées ou ayant échoué.

  • ZONE : zone où se trouve le MIG.

Le résultat ressemble à ce qui suit :

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

Pour afficher la liste de toutes les requêtes de redimensionnement d'un MIG zonal, envoyez une requête GET à la méthode instanceGroupManagerResizeRequests.list.

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel se trouve un MIG zonal existant comportant des requêtes de redimensionnement acceptées, terminées, annulées ou ayant échoué.

  • ZONE : zone où se trouve le MIG.

  • INSTANCE_GROUP_NAME : nom d'un MIG zonal existant comportant des requêtes de redimensionnement acceptées, terminées, annulées ou ayant échoué.

Le résultat ressemble à ce qui suit :

{
  "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"
}

Afficher les détails d'une requête de redimensionnement

Vous pouvez afficher les détails d'une requête de redimensionnement pour examiner sa configuration et, éventuellement, résoudre les problèmes si la requête n'a pas encore abouti.

Pour comprendre pourquoi une requête de redimensionnement (ACCEPTED) échoue, vérifiez le champ lastAttempt.error.errors.code dans les détails. Voici les différents codes d'erreur possibles :

  • ZONE_RESOURCE_POOL_EXHAUSTED_WITH_DETAILS : les ressources demandées sont temporairement indisponibles.

  • QUOTA_EXCEEDED : votre projet manque de quota pour les ressources demandées. Pour augmenter le quota de votre projet, consultez la section Demander une augmentation de quota.

gcloud

Pour afficher les détails d'une demande de redimensionnement dans un MIG zonal, utilisez la commande instance-groups managed resize-requests describe.

gcloud compute instance-groups managed resize-requests describe INSTANCE_GROUP_NAME \
    --resize-request=RESIZE_REQUEST_NAME \
    --zone=ZONE

Remplacez les éléments suivants :

  • INSTANCE_GROUP_NAME : nom d'un MIG zonal existant dans lequel se trouve la requête de redimensionnement.

  • RESIZE_REQUEST_NAME : nom d'une requête de redimensionnement existante dont vous souhaitez afficher les détails.

  • ZONE : zone où se trouve le MIG.

Le résultat ressemble à ce qui suit :

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

Pour afficher les détails d'une requête de redimensionnement dans un MIG, envoyez une requête GET à la méthode instanceGroupManagerResizeRequests.get.

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel se trouve le MIG zonal.

  • ZONE : zone où se trouve le MIG.

  • INSTANCE_GROUP_NAME : nom d'un MIG zonal existant dans lequel se trouve la requête de redimensionnement.

  • RESIZE_REQUEST_NAME : nom d'une requête de redimensionnement existante dont vous souhaitez afficher les détails.

Le résultat ressemble à ce qui suit :

{
  "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"
}

Annuler des requêtes de redimensionnement dans un MIG

Vous pouvez annuler des requêtes de redimensionnement dans un MIG pour empêcher celui-ci de créer le nombre de VM demandé. Vous ne pouvez annuler que les requêtes de redimensionnement acceptées (ACCEPTED). Après avoir annulé une requête de redimensionnement, vous pouvez soit la supprimer, soit laisser Compute Engine la supprimer automatiquement au bout de 14 jours.

Pour annuler plusieurs requêtes de redimensionnement à la fois, utilisez la console Google Cloud ou la gcloud CLI.

Console

Pour annuler des requêtes de redimensionnement dans un MIG zonal, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Groupes d'instances.

    Accéder à la page "Groupes d'instances"

  2. Dans la colonne Nom, cliquez sur le nom du MIG contenant les requêtes de redimensionnement.

    La page de présentation du MIG s'affiche.

  3. Sur la ligne Demandes de redimensionnement, cliquez sur  Modifier les demandes de redimensionnement.

    Le volet Demandes de redimensionnement s'affiche.

  4. Sélectionnez les requêtes de redimensionnement à annuler.

  5. Cliquez sur  Annuler, puis sur Confirmer.

gcloud

Pour annuler des demandes de redimensionnement dans un MIG zonal, exécutez la commande instance-groups managed resize-requests cancel.

gcloud compute instance-groups managed resize-requests cancel INSTANCE_GROUP_NAME \
    --resize-requests=RESIZE_REQUEST_NAMES \
    --zone=ZONE

Remplacez les éléments suivants :

  • INSTANCE_GROUP_NAME : nom d'un MIG zonal existant comportant des requêtes de redimensionnement acceptées.

  • RESIZE_REQUEST_NAMES : liste des noms des requêtes de redimensionnement acceptées dans le MIG zonal spécifié, séparés par une virgule. Par exemple, spécifiez request-1,request-2.

  • ZONE : zone où se trouve le MIG.

REST

Pour annuler une requête de redimensionnement dans un MIG zonal, envoyez une requête POST à la méthode instanceGroupManagerResizeRequests.cancel.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME/cancel

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel se trouve un MIG zonal existant comportant une requête de redimensionnement acceptée.

  • ZONE : zone où se trouve le MIG.

  • INSTANCE_GROUP_NAME : nom du MIG.

  • RESIZE_REQUEST_NAME : nom de la requête de redimensionnement à annuler.

Supprimer des requêtes de redimensionnement dans un MIG

Par défaut, Compute Engine supprime automatiquement une requête de redimensionnement 14 jours après avoir défini son état sur l'un des suivants :

  • Terminée (SUCCEEDED)

  • Échec (FAILED)

  • Annulé (CANCELLED)

Toutefois, vous pouvez immédiatement supprimer une requête de redimensionnement avant ce délai, comme décrit dans cette section.

La suppression d'une requête de redimensionnement terminée ne supprime pas les VM créées via la requête. Le MIG supprime automatiquement ces VM à la fin de la durée d'exécution demandée. Cependant, si votre job est terminé et que vous n'avez plus besoin des VM, supprimez-les.

Pour supprimer plusieurs requêtes de redimensionnement à la fois, utilisez la console Google Cloud ou la gcloud CLI.

Console

Pour supprimer des requêtes de redimensionnement d'un MIG zonal, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Groupes d'instances.

    Accéder à la page "Groupes d'instances"

  2. Dans la colonne Nom, cliquez sur le nom du MIG contenant les requêtes de redimensionnement.

    La page de présentation du MIG s'affiche.

  3. Sur la ligne Demandes de redimensionnement, cliquez sur  Modifier les demandes de redimensionnement.

    Le volet Demandes de redimensionnement s'affiche.

  4. Sélectionnez les requêtes de redimensionnement à supprimer.

  5. Cliquez sur  Supprimer, puis sur Confirmer.

gcloud

Pour supprimer des demandes de redimensionnement dans un MIG zonal, utilisez la commande instance-groups managed resize-requests delete.

gcloud compute instance-groups managed resize-requests delete INSTANCE_GROUP_NAME \
    --resize-requests=RESIZE_REQUEST_NAMES \
    --zone=ZONE

Remplacez les éléments suivants :

  • INSTANCE_GROUP_NAME : nom d'un MIG zonal existant comportant des requêtes de redimensionnement terminées, ayant échoué ou annulées.

  • RESIZE_REQUEST_NAMES : liste des noms des requêtes de redimensionnement à supprimer du MIG, séparés par une virgule. Par exemple, spécifiez request-1,request-2.

  • ZONE : zone où se trouve le MIG.

REST

Pour supprimer une requête de redimensionnement d'un MIG zonal, envoyez une requête DELETE à la méthode instanceGroupManagerResizeRequests.delete.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/resizeRequests/RESIZE_REQUEST_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel se trouve un MIG zonal existant comportant des requêtes de redimensionnement terminées, ayant échoué ou annulées.

  • ZONE : zone où se trouve le MIG.

  • INSTANCE_GROUP_NAME : nom du MIG.

  • RESIZE_REQUEST_NAME : nom de la requête de redimensionnement à supprimer.

Étapes suivantes