Afficher la 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 valide 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. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante : 

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    2. Set a default region and zone.

    REST

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

      Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante : 

      gcloud init

      Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

    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 flexibilité des instances.

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

  3. Cliquez sur l'onglet Détails.

    Dans la section Flexibilité de l'instance, le tableau Sélections d'instances affiche le nom et le classement de la sélection d'instances, ainsi que les types de machines qu'elle contient. 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. Incluez l'option --format pour filtrer les propriétés instanceFlexibilityPolicy.instanceSelections.

  gcloud 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, le résultat renvoie null.

Remplacez les éléments suivants :

  • INSTANCE_GROUP_NAME : nom du MIG dont vous souhaitez afficher la configuration de 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. 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/v1/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, le résultat 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 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 Présentation du MIG s'ouvre. Elle liste toutes les VM du groupe, leurs types de machines et d'autres détails.

gcloud

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

  gcloud 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 flexibilité des instances.

REST

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

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

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

{
  "managedInstances": [
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-0md2",
      "instanceStatus": "RUNNING",
      "id": "2656095434923471959",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/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/v1/projects/example-project/zones/us-central1-b/instances/example-mig-vbgg",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "9171259522409694366",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/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 : 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 flexibilité des instances.

Étapes suivantes