Afficher l'emplacement physique d'une instance Compute Engine

Ce document explique comment afficher l'emplacement physique des instances Compute Engine en cours d'exécution dans votre organisation Google Cloud .

Après avoir créé et démarré des instances de calcul, vous pouvez afficher l'hôte physique sur lequel chaque instance de calcul s'exécute dans une zone. Utilisez l'emplacement physique des instances de calcul de votre cluster pour effectuer les opérations suivantes :

  • Minimiser la latence du réseau : ajustez la conception de votre application ou de votre charge de travail pour exécuter des tâches sensibles à la latence sur les instances de calcul les plus proches les unes des autres.

  • Améliorer la fiabilité des charges de travail : répartissez les instances de calcul sur des hôtes physiques distincts pour limiter l'impact des erreurs d'hôte dans votre application.

Pour vérifier quelles instances de calcul s'exécutent dans votre projet, affichez la liste des instances de calcul.

Limites

Vous pouvez afficher l'ID du cluster, du bloc, du sous-bloc et de l'hôte des instances de calcul qui répondent à une ou plusieurs des exigences suivantes :

Si une instance de calcul ne répond à aucune des exigences précédentes, vous pouvez afficher son ID d'hôte après l'avoir exposé, comme décrit dans ce document.

Comprendre la topologie des instances de calcul

Chaque instance de calcul s'exécute sur un serveur physique, un hôte, qui existe dans un bloc de serveur. Chaque bloc appartient à un cluster d'une zone. Lorsque vous affichez les détails des instances de calcul qui répondent à des exigences spécifiques, vous pouvez comprendre leur topologie par rapport aux autres instances de calcul qui répondent aux mêmes exigences.

Compute Engine expose les sous-champs suivants dans le champ physicalHostTopology de chaque instance de calcul. Plus deux instances de calcul en cours d'exécution partagent de sous-champs, plus elles sont proches l'une de l'autre.

  • Cluster (cluster) : nom global du cluster où se trouve votre instance de calcul. Un cluster est un regroupement logique de haut niveau de plusieurs hôtes, qui peut s'étendre sur plusieurs blocs et qui fonctionnent ensemble en tant que pool de ressources unique.

  • (block) : ID spécifique à l'organisation du bloc dans lequel se trouve votre instance de calcul. Un bloc est un ensemble de plusieurs hôtes regroupés.

  • Sous-bloc (subBlock) : ID spécifique à l'organisation du sous-bloc où se trouve votre instance de calcul. Un sous-bloc est une subdivision physique d'un bloc, qui regroupe des hôtes dans un même boîtier physique.

  • Hôte (host) : ID spécifique à l'organisation ou au projet de l'hôte sur lequel votre instance de calcul s'exécute. L'ID d'hôte change comme suit :

    • Si l'instance de calcul spécifie une stratégie d'emplacement compact ou une stratégie de charge de travail, l'ID d'hôte est spécifique à votre projet.

    • Si l'instance de calcul spécifie une série de machines compatible ou si vous exposez son ID d'hôte, l'ID d'hôte est spécifique à votre organisation.

      Avant de commencer

      • Si ce n'est pas déjà fait, configurez l'authentification. L'authentification permet 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 :

        Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :

        Console

        Lorsque vous utilisez la console Google Cloud pour accéder aux services et aux API Google Cloud , vous n'avez pas besoin de configurer l'authentification.

        gcloud

        1. Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée. Après vous être connecté, initialisez la Google Cloud CLI en exécutant la commande suivante :

          gcloud init
      • Définissez une région et une zone par défaut.
      • 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, puis connectez-vous à 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 .

      Rôles requis

      Pour obtenir les autorisations nécessaires pour vérifier la topologie de vos instances de calcul, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Compute (roles/compute.admin) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

      Ce rôle prédéfini contient les autorisations requises pour vérifier la topologie de vos instances de calcul. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

      Autorisations requises

      Les autorisations suivantes sont requises pour vérifier la topologie de vos instances de calcul :

      • Pour afficher les détails d'une instance de calcul : compute.instances.get
      • Pour afficher la liste des instances de calcul : compute.instances.list
      • Pour exposer l'ID d'hôte lorsque vous créez une instance de calcul :
        • compute.instances.create sur le projet
        • Pour créer la VM à l'aide d'une image personnalisée : compute.images.useReadOnly sur l'image
        • Pour créer la VM à l'aide d'un instantané : compute.snapshots.useReadOnly sur l'instantané
        • Pour créer la VM à l'aide d'un modèle d'instance : compute.instanceTemplates.useReadOnly sur le modèle d'instance
        • Pour attribuer un ancien réseau à la VM : compute.networks.use sur le projet
        • Pour spécifier une adresse IP statique pour la VM : compute.addresses.use sur le projet
        • Pour attribuer une adresse IP externe à la VM, en cas d'utilisation d'un ancien réseau : compute.networks.useExternalIp sur le projet
        • Pour spécifier un sous-réseau pour la VM : compute.subnetworks.use sur le projet ou sur le sous-réseau choisi
        • Pour attribuer une adresse IP externe à la VM, en cas d'utilisation d'un réseau VPC : compute.subnetworks.useExternalIp sur le projet ou sur le sous-réseau choisi
        • Pour définir les métadonnées d'instance de VM pour la VM : compute.instances.setMetadata sur le projet
        • Pour définir des tags pour la VM : compute.instances.setTags sur la VM
        • Pour définir des étiquettes pour la VM : compute.instances.setLabels sur la VM
        • Pour définir un compte de service que doit utiliser la VM : compute.instances.setServiceAccount sur la VM
        • Pour créer un disque pour la VM : compute.disks.create sur le projet
        • Pour associer un disque existant en mode lecture seule ou en mode lecture/écriture : compute.disks.use sur le disque
        • Pour associer un disque existant en mode lecture seule : compute.disks.useReadOnly sur le disque
      • Pour exposer l'ID d'hôte lorsque vous créez un modèle d'instance : compute.instanceTemplates.create
      • Pour afficher ou masquer l'ID d'hôte dans une instance de calcul existante : compute.instances.update

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

      Afficher ou masquer l'ID de l'hôte

      Sauf si une instance de calcul répond à des exigences spécifiques, son ID d'hôte est masqué par défaut. Vous pouvez exposer l'ID d'hôte lorsque vous créez ou mettez à jour des instances de calcul. Lorsque vous affichez les détails de vos instances de calcul, vous pouvez voir leurs ID d'hôte spécifiques à votre organisation Google Cloud . Vous ne pouvez pas voir les ID du bloc, du sous-bloc ou du cluster pour les instances de calcul.

      Pour exposer ou masquer l'ID d'hôte dans une instance de calcul, utilisez l'une des méthodes suivantes :

      Si vous souhaitez empêcher l'exposition de l'ID d'hôte pour un ou plusieurs projets de votre organisation, vous pouvez créer une contrainte personnalisée. Cette contrainte est utile, par exemple, lorsque vous souhaitez exécuter des charges de travail sensibles à la sécurité. Pour en savoir plus, consultez Contraintes personnalisées.

      Exposer ou masquer l'ID d'hôte dans une instance de calcul existante

      Vous pouvez exposer ou masquer l'ID d'hôte dans une instance de calcul existante sans redémarrage. Si vous désactivez le paramètre qui expose l'ID d'hôte pour une instance de calcul qui affiche l'ID d'hôte par défaut, l'un des événements suivants se produit :

      • Si l'instance de calcul spécifie une stratégie d'emplacement compact ou une stratégie de charge de travail, l'ID d'hôte spécifique au projet et les informations de localisation physique associées s'affichent.

      • Si l'instance de calcul utilise un type de machine H4D ou un type de machine A3 High avec huit GPU (ou des générations ultérieures), Compute Engine ignore la requête.

      Pour afficher ou masquer l'ID d'hôte d'une instance de calcul existante, sélectionnez l'une des options suivantes :

      gcloud

      Pour exposer ou masquer l'ID d'hôte d'une instance de calcul existante, utilisez la commande gcloud compute instances update avec l'un des flags suivants :

      • Pour exposer l'ID d'hôte, incluez l'option --expose-host-topology :

        gcloud compute instances update INSTANCE_NAME \
            --expose-host-topology \
            --zone=ZONE
        
      • Pour masquer l'ID d'hôte, incluez l'option --no-expose-host-topology :

        gcloud compute instances update INSTANCE_NAME \
            --no-expose-host-topology \
            --zone=ZONE
        

      Remplacez les éléments suivants :

      • INSTANCE_NAME : nom de l'instance de calcul.

      • ZONE : zone où se trouve l'instance de calcul.

      REST

      1. Pour afficher les propriétés d'une instance de calcul existante, envoyez une requête GET à la méthode instances.get :

        GET https://compute./compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
        

        Remplacez les éléments suivants :

        • PROJECT_ID : ID du projet dans lequel vous avez créé l'instance de calcul.

        • ZONE : zone où se trouve l'instance de calcul.

        • INSTANCE_NAME : nom de l'instance de calcul.

      2. Pour mettre à jour une instance de calcul afin d'afficher ou de masquer l'ID d'hôte, envoyez une requête PUT à la méthode instances.update. Dans le corps de la requête, utilisez le résultat de la requête GET de l'étape précédente. Toutefois, dans le champ scheduling, vous devez ajouter le champ exposeHostTopology pour afficher ou masquer l'ID de l'hôte. Si le champ scheduling n'existe pas dans le résultat de la requête, ajoutez-le également.

        La requête PUT ressemble à ce qui suit :

        PUT https://compute./compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=REFRESH
        
        {
          "scheduling": {
            "exposeHostTopology": EXPOSE_HOST_ID
          },
          ...
        }
        

        Remplacez EXPOSE_HOST_ID par l'une des valeurs suivantes :

        • Pour exposer l'ID de l'hôte : true

        • Pour masquer l'ID de l'hôte : false

      Exposer l'ID d'hôte dans une nouvelle instance de calcul

      Pour exposer l'ID d'hôte lors de la création d'une instance de calcul, sélectionnez l'une des options suivantes :

      gcloud

      Pour exposer l'ID d'hôte lors de la création d'une instance de calcul, utilisez la commande gcloud compute instances create avec l'option --expose-host-topology :

      gcloud compute instances create INSTANCE_NAME \
          --machine-type=MACHINE_TYPE \
          --expose-host-topology \
          --zone=ZONE
      

      Remplacez les éléments suivants :

      • INSTANCE_NAME : nom de l'instance de calcul.

      • MACHINE_TYPE : type de machine que vous souhaitez que votre instance de calcul utilise.

      • ZONE : zone dans laquelle vous souhaitez créer l'instance de calcul.

      REST

      Pour exposer l'ID d'hôte lors de la création d'une instance de calcul, envoyez une requête POST à la méthode instances.insert. Dans le corps de la requête, incluez le champ scheduling.exposeHostTopology défini sur true.

      POST https://compute./compute/v1/projects/PROJECT_ID/zones/ZONE/instances
      
      {
        "name": "INSTANCE_NAME",
        "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
        "disks": [
          {
            "boot": true,
            "initializeParams": {
              "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
            }
          }
        ],
        "networkInterfaces": [
          {
            "network": "global/networks/default"
          }
        ],
        "scheduling": {
          "exposeHostTopology": true
        }
      }
      

      Remplacez les éléments suivants :

      • PROJECT_ID : ID du projet dans lequel créer l'instance de calcul.

      • ZONE : zone dans laquelle vous souhaitez créer l'instance de calcul.

      • INSTANCE_NAME : nom de l'instance de calcul.

      • MACHINE_TYPE : type de machine que vous souhaitez que votre instance de calcul utilise.

      • IMAGE_PROJECT : projet contenant l'image, par exemple, debian-cloud. Pour en savoir plus sur les projets d'image compatibles, consultez Images d'OS publiques.

      • IMAGE : spécifiez l'une des options suivantes :

        • Une version spécifique de l'image de l'OS. Exemple : debian-12-bookworm-v20240617.

        • Une famille d'images, qui doit être au format family/IMAGE_FAMILY. Cela permet de spécifier l'image de l'OS non obsolète la plus récente. Par exemple, si vous spécifiez family/debian-12, la dernière version de la famille d'images Debian 12 est utilisée. Pour en savoir plus sur l'utilisation des familles d'images, consultez la page Bonnes pratiques concernant les familles d'images.

      Exposer l'ID d'hôte dans de nouvelles instances de calcul de manière groupée

      Pour exposer l'ID d'hôte lorsque vous créez des instances de calcul de manière groupée, sélectionnez l'une des options suivantes :

      gcloud

      Pour exposer l'ID d'hôte lorsque vous créez des instances de calcul de manière groupée, exécutez la commande gcloud compute instances bulk create avec l'option --expose-host-topology.

      Par exemple, pour créer des instances de calcul de manière groupée dans une seule zone et spécifier l'exposition de leur ID d'hôte, exécutez la commande suivante :

      gcloud compute instances bulk create \
          --count=COUNT \
          --machine-type=MACHINE_TYPE \
          --name-pattern="NAME_PATTERN" \
          --expose-host-topology \
          --zone=ZONE
      

      Remplacez les éléments suivants :

      • COUNT : nombre d'instances de calcul à créer.

      • MACHINE_TYPE : type de machine que vous souhaitez que vos instances de calcul utilisent.

      • NAME_PATTERN : format de nom pour les instances de calcul. Pour remplacer une séquence de nombres dans un nom d'instance de calcul, utilisez une séquence de caractères dièse (#). Par exemple, le format de nom instance-# génère des instances de calcul portant les noms instance-1, instance-2, etc., jusqu'à ce qu'il atteigne le nombre d'instances de calcul spécifié par COUNT.

      • ZONE : zone dans laquelle vous souhaitez créer des instances de calcul de manière groupée.

      REST

      Pour exposer l'ID d'hôte lorsque vous créez des instances de calcul de manière groupée, envoyez une requête POST à la méthode instances.bulkInsert. Dans le corps de la requête, incluez le champ instanceProperties.scheduling.exposeHostTopology défini sur true.

      Par exemple, pour créer des instances de calcul de manière groupée dans une seule zone et spécifier l'exposition de leur ID d'hôte, envoyez une requête POST comme suit :

      POST https://compute./compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert
      
      {
        "count": "COUNT",
        "namePattern": "NAME_PATTERN",
        "instanceProperties": {
          "machineType": "MACHINE_TYPE",
          "disks": [
            {
              "boot": true,
              "initializeParams": {
                "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
              }
            }
          ],
          "networkInterfaces": [
            {
              "network": "global/networks/default"
            }
          ],
          "scheduling": {
            "exposeHostTopology": true
          }
        }
      }
      

      Remplacez les éléments suivants :

      • PROJECT_ID : ID du projet dans lequel créer les instances de calcul.

      • ZONE : zone dans laquelle vous souhaitez créer les instances de calcul.

      • COUNT : nombre d'instances de calcul à créer.

      • NAME_PATTERN : format de nom pour les instances de calcul. Pour remplacer une séquence de nombres dans un nom d'instance de calcul, utilisez une séquence de caractères dièse (#). Par exemple, le format de nom instance-# génère des instances de calcul portant les noms instance-1, instance-2, etc., jusqu'à ce qu'il atteigne le nombre d'instances de calcul spécifié par COUNT.

      • MACHINE_TYPE : type de machine que vous souhaitez que vos instances de calcul utilisent.

      • IMAGE_PROJECT : projet contenant l'image, par exemple, debian-cloud. Pour en savoir plus sur les projets d'image compatibles, consultez Images d'OS publiques.

      • IMAGE : spécifiez l'une des options suivantes :

        • Une version spécifique de l'image de l'OS. Exemple : debian-12-bookworm-v20240617.

        • Une famille d'images, qui doit être au format family/IMAGE_FAMILY. Cela permet de spécifier l'image de l'OS non obsolète la plus récente. Par exemple, si vous spécifiez family/debian-12, la dernière version de la famille d'images Debian 12 est utilisée. Pour en savoir plus sur l'utilisation des familles d'images, consultez la page Bonnes pratiques concernant les familles d'images.

      Exposer l'ID d'hôte dans un nouveau modèle d'instance

      Après avoir créé un modèle d'instance qui spécifie l'exposition de l'ID d'hôte, vous pouvez l'utiliser pour effectuer les opérations suivantes :

      Pour exposer l'ID d'hôte lors de la création d'un modèle d'instance, sélectionnez l'une des options suivantes :

      gcloud

      Pour exposer l'ID d'hôte lors de la création d'un modèle d'instance, utilisez la commande gcloud compute instance-templates create avec l'option --expose-host-topology.

      Par exemple, utilisez la commande suivante pour créer un modèle d'instance régional. Pour créer un modèle d'instance global, utilisez la même commande sans l'option --instance-template-region.

      gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
          --expose-host-topology \
          --instance-template-region=REGION \
          --machine-type=MACHINE_TYPE
      

      Remplacez les éléments suivants :

      • INSTANCE_TEMPLATE_NAME : nom du modèle d'instance.

      • REGION : région dans laquelle créer le modèle d'instance.

      • MACHINE_TYPE : type de machine que vous souhaitez que vos instances de calcul utilisent.

      REST

      Pour exposer l'ID d'hôte lors de la création d'un modèle d'instance, envoyez une requête POST à l'une des méthodes suivantes. Dans le corps de la requête, incluez le champ properties.scheduling.exposeHostTopology défini sur true.

      Par exemple, pour créer un modèle d'instance régional qui expose l'ID de l'hôte, envoyez une requête POST comme suit :

      POST https://compute./compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates
      
      {
        "name": "INSTANCE_TEMPLATE_NAME",
        "properties": {
          "disks": [
            {
              "boot": true,
              "initializeParams": {
                "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
              }
            }
          ],
          "machineType": "MACHINE_TYPE",
          "networkInterfaces": [
            {
              "network": "global/networks/default"
            }
          ],
          "scheduling": {
            "exposeHostTopology": true
          }
        }
      }
      

      Remplacez les éléments suivants :

      • PROJECT_ID : ID du projet dans lequel créer le modèle d'instance.

      • REGION : région dans laquelle vous souhaitez créer le modèle d'instance.

      • INSTANCE_TEMPLATE_NAME : nom du modèle d'instance.

      • IMAGE_PROJECT : projet contenant l'image, par exemple, debian-cloud. Pour en savoir plus sur les projets d'image compatibles, consultez la page Images d'OS publiques.

      • IMAGE : spécifiez l'une des options suivantes :

        • Une version spécifique de l'image de l'OS. Exemple : debian-12-bookworm-v20240617.

        • Une famille d'images, qui doit être au format family/IMAGE_FAMILY. Cela permet de spécifier l'image de l'OS non obsolète la plus récente. Par exemple, si vous spécifiez family/debian-12, la dernière version de la famille d'images Debian 12 est utilisée. Pour en savoir plus sur l'utilisation des familles d'images, consultez la page Bonnes pratiques concernant les familles d'images.

      • MACHINE_TYPE : type de machine que vous souhaitez que vos instances de calcul utilisent.

      Vérifier l'emplacement physique d'une instance de calcul

      Vous ne pouvez afficher l'emplacement physique de vos instances de calcul en cours d'exécution que si elles répondent à des exigences spécifiques ou si vous exposez leurs ID d'hôte.

      Pour vérifier l'emplacement physique des instances de calcul en cours d'exécution dans votre organisation, utilisez l'une des méthodes suivantes :

      Vérifier l'emplacement physique à l'aide de la console Google Cloud , de la gcloud CLI ou de REST

      Pour afficher l'emplacement physique de plusieurs instances de calcul à la fois, utilisez l'API REST. Sinon, sélectionnez l'une des options suivantes :

      Console

      1. Dans la console Google Cloud , accédez à la page Instances de VM.

        Accéder à la page Instances de VM

      2. Dans la colonne Nom, cliquez sur le nom de l'instance de calcul dont vous souhaitez afficher les détails. Une page indiquant les détails de l'instance s'affiche, et l'onglet Détails est sélectionné.

      3. Dans la section Informations de base, vérifiez la valeur du champ Hôte physique.

      gcloud

      Pour afficher l'emplacement physique d'une instance de calcul en cours d'exécution, utilisez la commande gcloud compute instances describe avec l'option --flatten=resourceStatus.physicalHostTopology :

      gcloud compute instances describe INSTANCE_NAME \
          --flatten=resourceStatus.physicalHostTopology \
          --zone=ZONE
      

      Remplacez les éléments suivants :

      • INSTANCE_NAME : nom de l'instance de calcul.

      • ZONE : zone où se trouve l'instance de calcul.

      Le résultat ressemble à l'un des éléments suivants :

      • Si vous pouvez afficher l'ID du cluster, du bloc, du sous-bloc et de l'hôte d'une instance de calcul, le résultat ressemble à ce qui suit :

        ---
        block: 3e3056e23cf91a5cb4a8621b6a52c100
        cluster: europe-west1-cluster-jfhb
        host: 1215168a4ecdfb434fd4d28056589059
        subBlock: 0fc09525cbd5abd734342893ca1c083f
        
      • Si vous ne pouvez afficher l'ID de l'hôte qu'après l'avoir exposé, le résultat ressemble à ce qui suit :

        ---
        block: null
        cluster: null
        host: 1215168a4ecdfb434fd4d28056589059
        subBlock: null
        

      REST

      Pour afficher l'emplacement physique de vos instances de calcul en cours d'exécution, envoyez l'une des requêtes GET suivantes. Lorsque vous effectuez une requête, vous devez inclure le paramètre de requête fields et limiter la sortie aux champs name, machineType et physicalHostTopology d'une instance de calcul. Vous devez également inclure le paramètre de requête filter et limiter les résultats aux instances de calcul en cours d'exécution.

      • Pour afficher la liste de vos instances dans toutes les zones : méthode instances.aggregatedList

        GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/instances?fields=items.name,items.machineType,items.resourceStatus.physicalHostTopology&filter=status=RUNNING
        
      • Pour afficher la liste de vos instances dans une zone spécifique : méthode instances.list

        GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances?fields=items.name,items.machineType,items.resourceStatus.physicalHostTopology&filter=status=RUNNING
        

      Remplacez les éléments suivants :

      • PROJECT_ID : ID du projet dans lequel se trouvent les instances de calcul.

      • ZONE : zone où se trouvent les instances de calcul.

      Le résultat ressemble à l'un des éléments suivants :

      • Si vous pouvez afficher l'ID du cluster, du bloc, du sous-bloc et de l'hôte d'une instance de calcul, le résultat ressemble à ce qui suit. Dans l'exemple suivant, les instances de calcul vm-01 et vm-02 se trouvent dans le même bloc.

        {
          "items": [
            {
              "name": "vm-01",
              "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
              "resourceStatus": {
                "physicalHostTopology": {
                  "block": "3e3056e23cf91a5cb4a8621b6a52c100",
                  "cluster": "europe-west1-cluster-jfhb",
                  "host": "1215168a4ecdfb434fd4d28056589059",
                  "subBlock": "0fc09525cbd5abd734342893ca1c083f"
                }
              }
            },
            {
              "name": "vm-02",
              "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
              "resourceStatus": {
                "physicalHostTopology": {
                  "block": "3e3056e23cf91a5cb4a8621b6a52c100",
                  "cluster": "europe-west1-cluster-jfhb",
                  "host": "2326279b5ecdfc545fd5e39167698168",
                  "subBlock": "1fc18636cbd4abd623553784ca2c174e"
                }
              }
            },
            ...
          ]
        }
        
      • Si vous ne pouvez afficher l'ID de l'hôte qu'après l'avoir exposé, le résultat ressemble à ce qui suit :

        {
          "items": [
            {
              "name": "vm-01",
              "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
              "resourceStatus": {
                "physicalHostTopology": {
                  "block": null,
                  "cluster": null,
                  "host": "1215168a4ecdfb434fd4d28056589059",
                  "subBlock": null
                }
              }
            },
            {
              "name": "vm-02",
              "machineType": "https://www.googleapis.com/compute/v1/projects/example-project/zones/europe-west1-b/machineTypes/a3-ultragpu-8g",
              "resourceStatus": {
                "physicalHostTopology": {
                  "block": null,
                  "cluster": null,
                  "host": "2326279b5ecdfc545fd5e39167698168",
                  "subBlock": null
                }
              }
            },
            ...
          ]
        }
        

      Si vous souhaitez affiner votre liste d'instances de calcul, modifiez l'expression de filtre dans le paramètre de requête filter.

      Vérifier l'emplacement physique en interrogeant la clé de métadonnées

      Pour afficher l'emplacement physique d'une instance de calcul en cours d'exécution en interrogeant la clé de métadonnées physical_host_topology, sélectionnez l'une des options suivantes :

      Instances Linux

      1. Connectez-vous à votre instance Linux.

      2. Interrogez la clé de métadonnées physical_host_topology à l'aide de curl :

        user@myinst:~$ curl -s -H "Metadata-Flavor: Google" http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology
        

        Le résultat ressemble à l'un des éléments suivants :

        • Si vous pouvez afficher l'ID du cluster, du bloc, du sous-bloc et de l'hôte d'une instance de calcul, le résultat ressemble à ce qui suit :

          {
            "block": "3e3056e23cf91a5cb4a8621b6a52c100",
            "cluster": "europe-west1-cluster-jfhb",
            "host": "2326279b5ecdfc545fd5e39167698168",
            "subBlock": "1fc18636cbd4abd623553784ca2c174e"
          }
          
        • Si vous ne pouvez afficher l'ID de l'hôte qu'après l'avoir exposé, le résultat est semblable à celui-ci :

          {
            "block": null,
            "cluster": null,
            "host": "2326279b5ecdfc545fd5e39167698168",
            "subBlock": null
          }
          

      Instances Windows

      1. Connectez-vous à votre instance Windows.

      2. Interrogez la clé de métadonnées physical_host_topology à l'aide de la commande Invoke-RestMethod :

        PS C:\> 
        $value = (Invoke-RestMethod `
                -Headers @{'Metadata-Flavor' = 'Google'} `
                -Uri "http://metadata.google.internal/computeMetadata/v1/instance/attributes/physical_host_topology")
        $value
        

        Le résultat ressemble à l'un des éléments suivants :

        • Si vous pouvez afficher l'ID du cluster, du bloc, du sous-bloc et de l'hôte d'une instance de calcul, le résultat ressemble à ce qui suit :

          {
            "block": "3e3056e23cf91a5cb4a8621b6a52c100",
            "cluster": "europe-west1-cluster-jfhb",
            "host": "2326279b5ecdfc545fd5e39167698168",
            "subBlock": "1fc18636cbd4abd623553784ca2c174e"
          }
          
        • Si vous ne pouvez afficher l'ID de l'hôte qu'après l'avoir exposé, le résultat est semblable à celui-ci :

          {
            "block": null,
            "cluster": null,
            "host": "2326279b5ecdfc545fd5e39167698168",
            "subBlock": null
          }
          

      Étapes suivantes