Afficher la configuration de flexibilité des instances

Ce document explique comment afficher la configuration de la flexibilité des instances dans un groupe d'instances géré (MIG) et les types de machines utilisés par chaque VM du groupe.

Une fois que vous avez ajouté ou modifié la flexibilité des instances dans un MIG, vous pouvez effectuer les opérations suivantes:

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 en sélectionnant l'une des options suivantes:

    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.

Afficher la configuration de flexibilité des instances

Console

  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 dont vous souhaitez afficher la configuration de la flexibilité des instances.

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

  3. Cliquez sur l'onglet Détails.

    Dans la section Flexibilité des instances, le tableau Sélections d'instances indique le nom, le classement et les types de machines d'une sélection. Si la flexibilité des instances n'est pas configurée pour le MIG, la section Flexibilité des instances ne s'affiche pas.

gcloud

Pour afficher la configuration de la flexibilité des instances, utilisez la commande instance-groups managed describe bêta. Incluez l'indicateur --format pour filtrer les propriétés instanceFlexibilityPolicy.instanceSelections.

  gcloud beta compute instance-groups managed describe INSTANCE_GROUP_NAME \
      --region REGION \
      --format="json(instanceFlexibilityPolicy.instanceSelections)"

Voici un exemple de résultat :

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

Si la flexibilité des instances n'est pas configurée pour un MIG, la sortie renvoie null.

Remplacez les éléments suivants :

  • INSTANCE_GROUP_NAME: nom du MIG dont vous souhaitez afficher la configuration de la flexibilité des instances.
  • REGION : région où se trouve le MIG.

REST

Pour afficher la configuration de la flexibilité des instances, utilisez la méthode regionInstanceGroupManagers.get (version bêta). Incluez le paramètre fields dans l'URL de la requête pour filtrer les propriétés instanceFlexibilityPolicy.instanceSelections.

  GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME?fields=instanceFlexibilityPolicy.instanceSelections

Voici un exemple de résultat :

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

Si la flexibilité des instances n'est pas configurée pour un MIG, la sortie renvoie null.

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet
  • REGION : région où se trouve le MIG.
  • INSTANCE_GROUP_NAME: nom du MIG dont vous souhaitez afficher la configuration de la flexibilité des instances.

Afficher les types de machines utilisés par chaque VM

Console

  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 dans lequel vous souhaitez afficher les types de machines utilisés par chaque VM.

    La page Vue d'ensemble du MIG s'ouvre. Elle liste toutes les VM du groupe, leurs types de machines et d'autres informations.

gcloud

Pour afficher les types de machines utilisés par chaque VM dans un MIG, listez les VM à l'aide de la commande instance-groups managed list-instances bêta et incluez l'option --format pour filtrer le champ propertiesFromFlexibilityPolicy.machineType. Vous pouvez également filtrer d'autres champs si nécessaire.

  gcloud beta compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
      --region REGION \
      --format='(name,instanceStatus,currentAction,propertiesFromFlexibilityPolicy.machineType,lastAttempt.errors.errors)'

Voici un exemple de résultat :

NAME: example-mig-0md2
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

NAME: example-mig-vbgg
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

Remplacez les éléments suivants :

  • REGION : région où se trouve le MIG.
  • INSTANCE_GROUP_NAME: nom du MIG dont vous souhaitez afficher la configuration de la flexibilité des instances.

REST

Pour afficher les types de machines utilisés par chaque VM dans un MIG, listez les VM à l'aide de la méthode bêta listManagedInstances et vérifiez le champ propertiesFromFlexibilityPolicy.machineType dans la réponse.

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

Voici un exemple de sortie. Recherchez le champ propertiesFromFlexibilityPolicy dans lequel le champ machineType d'une VM est défini.

{
  "managedInstances": [
    {
      "instance": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-b/instances/example-mig-0md2",
      "instanceStatus": "RUNNING",
      "id": "2656095434923471959",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/beta/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-0md2",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    },
    {
      "instance": "https://www.googleapis.com/compute/beta/projects/example-project/zones/us-central1-b/instances/example-mig-vbgg",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "9171259522409694366",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/beta/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-vbgg",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    }
  ]
}

Remplacez les éléments suivants :

  • PROJECT_ID : l'ID de votre projet.
  • REGION : région où se trouve le MIG.
  • INSTANCE_GROUP_NAME: nom du MIG dont vous souhaitez afficher la configuration de la flexibilité des instances.

Étape suivante