Afficher les détails et l'état d'une extension de VM

Vous installez des extensions de VM sur des instances de machine virtuelle (VM) Compute Engine en créant des règles d'extension globales ou zonales au niveau de l'organisation, du dossier ou du projet. Une même règle peut installer plusieurs extensions sur une même VM, et plusieurs règles peuvent s'appliquer à la même VM.

Ce document explique comment utiliser les méthodes get et list en lecture seule dans votre hiérarchie de ressources Google Cloud pour effectuer les tâches suivantes :

• Afficher les règles d'extension dans votre hiérarchie de ressources Répertoriez les règles d'extension de VM globales ou zonales pour afficher les détails des règles et l'état du déploiement dans votre organisation, votre dossier ou votre projet.
• Afficher les extensions et les versions de VM Répertoriez les extensions de VM compatibles avec VM Extension Manager ou affichez les détails des extensions (y compris les numéros de version et les niveaux de compatibilité) dans toutes les zones ou dans une zone spécifique de votre organisation, dossier ou projet.
• Affichez l'état des extensions installées sur chaque VM. Répertoriez toutes les extensions de VM installées et leurs états d'exécution sur une instance lorsqu'une règle installe plusieurs extensions sur une VM, ou affichez la configuration effective finale et la règle de gouvernance (policyId) lorsque plusieurs règles s'appliquent à la même VM.
• Résoudre les problèmes liés aux extensions sur une instance Affichez la progression de l'installation, l'état d'exécution et les messages de diagnostic lorsqu'une extension inattendue est installée ou qu'une extension échoue sur une instance de VM.

Avant de commencer

Avant d'afficher les règles d'extension de VM, de récupérer les détails des extensions de VM ou d'inspecter les états des extensions sur vos instances de VM, remplissez les conditions préalables suivantes :

• Consultez À propos de VM Extension Manager pour comprendre comment les règles d'extension gèrent les plug-ins d'agent invité sur l'ensemble de votre parc de VM.
• Si vous n'avez pas encore déployé d'extensions sur vos instances, commencez par créer une règle. Pour en savoir plus, consultez Installer des extensions de VM en créant des règles d'extension.
• Assurez-vous de disposer des autorisations IAM (Identity and Access Management) requises pour afficher les règles d'extension, récupérer les détails des extensions et inspecter l'état des extensions d'instance.

Limites d'affichage des règles et des extensions

Lorsque vous affichez les règles d'extension de VM, les détails des extensions et les états des instances, tenez compte des contraintes opérationnelles suivantes :

• Vous ne pouvez afficher les règles d'extension de VM au niveau du dossier et de l'organisation qu'à l'aide de la Google Cloud CLI ou de l'API REST Compute Engine.
• Vous ne pouvez récupérer les détails des extensions de VM et les états des extensions d'instance qu'à l'aide de la Google Cloud CLI ou de l'API REST Compute Engine. Vous ne pouvez pas afficher les détails des extensions de VM ni les états des extensions par instance dans la consoleGoogle Cloud .
• Les API d'état des extensions d'instance (getVmExtensionState et listVmExtensionStates) n'indiquent l'état d'exécution que pour les extensions installées et gérées par les règles du VM Extension Manager. Ces API ne signalent pas l'état des agents autonomes que vous installez manuellement en dehors de VM Extension Manager.

Afficher les règles d'extension

Vous pouvez lister les règles d'extension de VM ou inspecter les détails de configuration d'une règle spécifique au niveau de l'organisation, du dossier ou du projet.

Afficher les règles d'extension globales dans toutes les zones d'une organisation

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez lister toutes les règles d'extension de VM globales de votre organisation ou inspecter une règle globale spécifique au niveau de l'organisation pour auditer les déploiements d'extensions à l'échelle du parc.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les règles d'extension au niveau de l'organisation, demandez à votre administrateur de vous accorder le rôle IAM Lecteur des règles d'extension des VM Compute au niveau de l'organisation (roles/compute.orgVmExtensionPolicyViewer) ou Administrateur des règles d'extension des VM Compute au niveau de l'organisation (roles/compute.orgVmExtensionPolicyAdmin) sur votre organisation. 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 afficher les règles d'extension au niveau de l'organisation. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les règles d'extension au niveau de l'organisation :

• Répertoriez les règles d'extension : compute.orgVmExtensionPolicies.list
• Affichez les détails d'une règle d'extension : compute.orgVmExtensionPolicies.get

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

Pour afficher les règles d'extension globales d'une organisation, sélectionnez l'une des options suivantes :

gcloud

Pour afficher toutes les règles d'extension globales d'une organisation, exécutez la commande gcloud preview compute global-vm-extension-policies list avec l'option --organization :

gcloud preview compute global-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --page-size=PAGE_SIZE

Remplacez les éléments suivants :

• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• PAGE_SIZE : nombre maximal de résultats à renvoyer par page.

Pour afficher les détails d'une règle d'extension globale spécifique dans une organisation, exécutez la commande gcloud preview compute global-vm-extension-policies describe avec l'option --organization :

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• ORGANIZATION_ID : ID de votre organisation Google Cloud .

REST

Pour afficher toutes les règles d'extension globales d'une organisation, envoyez une requête GET à la méthode organizationGlobalVmExtensionPolicies.list :

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies

Pour afficher les détails d'une règle d'extension globale spécifique dans une organisation, envoyez une requête GET à la méthode organizationGlobalVmExtensionPolicies.get :

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensionPolicies/POLICY_NAME

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• ORGANIZATION_ID : ID de votre organisation Google Cloud .

Afficher les règles d'extension globales dans toutes les zones d'un dossier

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez lister toutes les règles d'extension de VM globales d'un dossier ou inspecter une règle globale spécifique limitée à un dossier pour vérifier quelles extensions s'appliquent aux projets de ce dossier.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les règles d'extension au niveau du dossier, demandez à votre administrateur de vous accorder le rôle IAM Lecteur des règles d'extension de VM Compute au niveau du dossier (roles/compute.folderVmExtensionPolicyViewer) ou Administrateur des règles d'extension de VM Compute au niveau du dossier (roles/compute.folderVmExtensionPolicyAdmin) sur votre dossier. 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 afficher les règles d'extension limitées au dossier. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les règles d'extension limitées à un dossier :

• Répertoriez les règles d'extension : compute.folderVmExtensionPolicies.list
• Affichez les détails d'une règle d'extension : compute.folderVmExtensionPolicies.get

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

Pour afficher les règles d'extension globales d'un dossier, sélectionnez l'une des options suivantes :

gcloud

Pour afficher toutes les règles d'extension globales d'un dossier, exécutez la commande gcloud preview compute global-vm-extension-policies list avec l'option --folder :

gcloud preview compute global-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --page-size=PAGE_SIZE

Remplacez les éléments suivants :

• FOLDER_ID : ID de votre dossier Google Cloud .
• PAGE_SIZE : nombre maximal de résultats à renvoyer par page.

Pour afficher les détails d'une stratégie d'extension globale spécifique dans un dossier, exécutez la commande gcloud preview compute global-vm-extension-policies describe avec l'option --folder :

gcloud preview compute global-vm-extension-policies describe POLICY_NAME \
  --folder=folders/FOLDER_ID

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• FOLDER_ID : ID de votre dossier Google Cloud .

REST

Pour afficher toutes les règles d'extension globales d'un dossier, envoyez une requête GET à la méthode folderGlobalVmExtensionPolicies.list :

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies

Pour afficher les détails d'une règle d'extension globale spécifique dans un dossier, envoyez une requête GET à la méthode folderGlobalVmExtensionPolicies.get :

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensionPolicies/POLICY_NAME

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• FOLDER_ID : ID de votre dossier Google Cloud .

Afficher les règles d'extension globales dans toutes les zones d'un projet

Vous pouvez afficher les règles d'extension de VM globales d'un projet pour surveiller la progression du déploiement et inspecter les configurations d'extension dans toutes les zones de ce projet.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les règles d'extension au niveau du projet, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de règles d'extension de VM Compute (roles/compute.vmExtensionPolicyViewer) ou Administrateur de règles d'extension de VM Compute (roles/compute.vmExtensionPolicyAdmin) 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 afficher les règles d'extension au niveau du projet. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les règles d'extension limitées au projet :

• Répertoriez les règles d'extension : compute.vmExtensionPolicies.list
• Affichez les détails d'une règle d'extension : compute.vmExtensionPolicies.get

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

Pour afficher les règles d'extension globales d'un projet, sélectionnez l'une des options suivantes :

Console

Pour afficher les règles d'extension de VM globales dans votre projet à l'aide de la console Google Cloud , procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Règles d'extension de VM.

   Accéder aux règles d'extension de VM

2. Cliquez sur Stratégies globales. Cet onglet liste toutes les règles d'extension de VM globales de votre projet.

gcloud

Pour afficher toutes les règles d'extension globales d'un projet, exécutez la commande gcloud compute global-vm-extension-policies list :

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• PAGE_SIZE : nombre maximal de résultats à renvoyer par page.

Pour afficher les détails d'une règle d'extension globale spécifique dans un projet, exécutez la commande gcloud compute global-vm-extension-policies describe :

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• PROJECT_ID : ID de votre projet Google Cloud .

REST

Pour afficher toutes les règles d'extension globales d'un projet, envoyez une requête GET à la méthode globalVmExtensionPolicies.list :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies

Pour afficher les détails d'une règle d'extension globale spécifique dans un projet, envoyez une requête GET à la méthode globalVmExtensionPolicies.get :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/vmExtensionPolicies/POLICY_NAME

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• PROJECT_ID : ID de votre projet Google Cloud .

Afficher les règles d'extension zonales dans une zone d'une organisation

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez lister les règles d'extension de VM au niveau de l'organisation dans une zone spécifique ou inspecter une seule règle pour auditer les règles d'application au niveau de la zone dans l'ensemble de votre organisation.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les règles d'extension au niveau de l'organisation, demandez à votre administrateur de vous accorder le rôle IAM Lecteur des règles d'extension des VM Compute au niveau de l'organisation (roles/compute.orgVmExtensionPolicyViewer) ou Administrateur des règles d'extension des VM Compute au niveau de l'organisation (roles/compute.orgVmExtensionPolicyAdmin) sur votre organisation. 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 afficher les règles d'extension au niveau de l'organisation. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les règles d'extension au niveau de l'organisation :

• Répertoriez les règles d'extension : compute.orgVmExtensionPolicies.list
• Affichez les détails d'une règle d'extension : compute.orgVmExtensionPolicies.get

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

Pour afficher les règles d'extension zonale d'une organisation, sélectionnez l'une des options suivantes :

gcloud

Pour afficher toutes les règles d'extension au niveau de l'organisation dans une zone, exécutez la commande gcloud preview compute zone-vm-extension-policies list avec l'option --organization :

gcloud preview compute zone-vm-extension-policies list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

Remplacez les éléments suivants :

• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• ZONE : nom de la zone dans laquelle vous souhaitez lister les règles d'extension de VM.
• PAGE_SIZE : nombre maximal de résultats à renvoyer par page.

Pour afficher les détails d'une règle d'extension zonale spécifique au niveau de l'organisation, exécutez la commande gcloud preview compute zone-vm-extension-policies describe avec l'option --organization :

gcloud preview compute zone-vm-extension-policies describe POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• ZONE : zone Google Cloud où se trouve la règle d'extension de VM.

REST

Pour afficher toutes les règles d'extension zonale d'une organisation, envoyez une requête GET à la méthode organizationZoneVmExtensionPolicies.list :

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies

Pour afficher les détails d'une règle d'extension zonale spécifique dans une organisation, envoyez une requête GET à la méthode organizationZoneVmExtensionPolicies.get :

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• ZONE : zone Google Cloud où se trouve la règle d'extension de VM.

Afficher les règles d'extension zonales dans une zone d'un dossier

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez lister les règles d'extension de VM au niveau du dossier dans une zone spécifique ou inspecter une règle individuelle pour vérifier les règles d'extension au niveau de la zone pour les projets de votre dossier.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les règles d'extension au niveau du dossier, demandez à votre administrateur de vous accorder le rôle IAM Lecteur des règles d'extension de VM Compute au niveau du dossier (roles/compute.folderVmExtensionPolicyViewer) ou Administrateur des règles d'extension de VM Compute au niveau du dossier (roles/compute.folderVmExtensionPolicyAdmin) sur votre dossier. 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 afficher les règles d'extension limitées au dossier. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les règles d'extension limitées à un dossier :

• Répertoriez les règles d'extension : compute.folderVmExtensionPolicies.list
• Affichez les détails d'une règle d'extension : compute.folderVmExtensionPolicies.get

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

Pour afficher les règles d'extension zonale d'un dossier, sélectionnez l'une des options suivantes :

gcloud

Pour afficher toutes les règles d'extension limitées à un dossier dans une zone, exécutez la commande gcloud preview compute zone-vm-extension-policies list avec l'option --folder :

gcloud preview compute zone-vm-extension-policies list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

Remplacez les éléments suivants :

• FOLDER_ID : ID de votre dossier Google Cloud .
• ZONE : nom de la zone dans laquelle vous souhaitez lister les règles d'extension de VM.
• PAGE_SIZE : nombre maximal de résultats à renvoyer par page.

Pour afficher les détails d'une règle d'extension zonale spécifique limitée à un dossier, exécutez la commande gcloud preview compute zone-vm-extension-policies describe avec l'option --folder :

gcloud preview compute zone-vm-extension-policies describe POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• FOLDER_ID : ID de votre dossier Google Cloud .
• ZONE : zone Google Cloud où se trouve la règle d'extension de VM.

REST

Pour afficher toutes les règles d'extension zonales d'un dossier, envoyez une requête GET à la méthode folderZoneVmExtensionPolicies.list :

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies

Pour afficher les détails d'une règle d'extension zonale spécifique dans un dossier, envoyez une requête GET à la méthode folderZoneVmExtensionPolicies.get :

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• FOLDER_ID : ID de votre dossier Google Cloud .
• ZONE : zone Google Cloud où se trouve la règle d'extension de VM.

Afficher les règles d'extension zonales dans une zone d'un projet

Vous pouvez lister les règles d'extension de VM au niveau du projet dans une zone spécifique ou inspecter une règle individuelle pour vérifier quelles extensions s'appliquent aux instances de cette zone.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les règles d'extension au niveau du projet, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de règles d'extension de VM Compute (roles/compute.vmExtensionPolicyViewer) ou Administrateur de règles d'extension de VM Compute (roles/compute.vmExtensionPolicyAdmin) 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 afficher les règles d'extension au niveau du projet. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les règles d'extension limitées au projet :

• Répertoriez les règles d'extension : compute.vmExtensionPolicies.list
• Affichez les détails d'une règle d'extension : compute.vmExtensionPolicies.get

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

Pour afficher les règles d'extension zonale d'un projet, sélectionnez l'une des options suivantes :

Console

Pour afficher les règles d'extension de VM zonales dans votre projet à l'aide de la console Google Cloud , procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Règles d'extension de VM.

   Accéder aux règles d'extension de VM

2. Pour afficher les détails d'une règle d'extension spécifique, cliquez sur son nom.

gcloud

Pour afficher toutes les règles d'extension au niveau du projet dans une zone, exécutez la commande gcloud compute zone-vm-extension-policies list :

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : nom de la zone dans laquelle vous souhaitez lister les règles d'extension de VM.
• PAGE_SIZE : nombre maximal de résultats à renvoyer par page.

Pour afficher les détails d'une règle d'extension zonale spécifique au niveau du projet, exécutez la commande gcloud compute zone-vm-extension-policies describe :

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : zone Google Cloud où se trouve la règle d'extension de VM.

REST

Pour afficher toutes les règles d'extension zonale d'un projet, envoyez une requête GET à la méthode zoneVmExtensionPolicies.list :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies

Pour afficher les détails d'une règle d'extension zonale spécifique dans un projet, envoyez une requête GET à la méthode zoneVmExtensionPolicies.get :

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/vmExtensionPolicies/POLICY_NAME

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez afficher.
• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : zone Google Cloud où se trouve la règle d'extension de VM.

Afficher les extensions et les versions de VM

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous pouvez utiliser les méthodes get et list en lecture seule pour afficher les extensions de VM compatibles avec VM Extension Manager dans votre organisation, votre dossier ou votre projet. Vous pouvez afficher les noms des extensions, les numéros de version et les niveaux de compatibilité des extensions dans toutes les zones ou dans une zone spécifique.

Afficher les extensions de VM dans toutes les zones d'une organisation

Utilisez les méthodes en lecture seule get et list pour afficher les extensions de VM compatibles avec VM Extension Manager dans toutes les zones de votre organisation, y compris leurs numéros de version et leurs niveaux de compatibilité.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les extensions de VM dans votre organisation, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de règles d'extension de VM Compute au niveau de l'organisation (roles/compute.orgVmExtensionPolicyViewer) ou Administrateur de règles d'extension de VM Compute au niveau de l'organisation (roles/compute.orgVmExtensionPolicyAdmin) sur votre organisation. 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 afficher les extensions de VM dans votre organisation. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les extensions de VM dans votre organisation :

• Répertorier les extensions de VM : compute.orgVmExtensions.list
• Affichez les détails d'une extension de VM : compute.orgVmExtensions.get

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

Pour afficher les extensions de VM et les versions compatibles avec le VM Extension Manager dans toutes les zones de votre organisation, sélectionnez l'une des options suivantes :

gcloud

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans toutes les zones de votre organisation, exécutez la commande gcloud preview compute global-vm-extension-policies extensions list avec l'option --organization :

gcloud preview compute global-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID

Remplacez les éléments suivants :

• ORGANIZATION_ID : ID de votre organisation Google Cloud .

Le résultat liste les extensions de VM compatibles avec le VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans votre organisation, exécutez la commande gcloud preview compute global-vm-extension-policies extensions describe avec l'option --organization :

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID

Remplacez les éléments suivants :

• EXTENSION_NAME : nom de l'extension de VM (par exemple, ops-agent, google-cloud-sap-extension ou google-cloud-workload-extension).
• ORGANIZATION_ID : ID de votre organisation Google Cloud .

REST

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans toutes les zones de votre organisation, envoyez une requête GET à la méthode organizationGlobalVmExtensionPolicies.listVmExtensions :

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions

Remplacez les éléments suivants :

• ORGANIZATION_ID : ID de votre organisation Google Cloud .

La réponse liste les extensions de VM compatibles avec VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans votre organisation, envoyez une requête GET à la méthode organizationGlobalVmExtensionPolicies.getVmExtension :

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/global/vmExtensions/EXTENSION_NAME

Remplacez les éléments suivants :

• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• EXTENSION_NAME : nom de l'extension de VM (par exemple, ops-agent).

Afficher les extensions de VM dans toutes les zones d'un dossier

Utilisez les méthodes en lecture seule get et list pour afficher les extensions de VM compatibles avec VM Extension Manager dans toutes les zones de votre dossier, y compris leurs numéros de version et leurs niveaux de compatibilité.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les extensions de VM dans votre dossier, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de règles d'extension de VM Compute au niveau du dossier (roles/compute.folderVmExtensionPolicyViewer) ou Administrateur de règles d'extension de VM Compute au niveau du dossier (roles/compute.folderVmExtensionPolicyAdmin) sur votre dossier. 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 afficher les extensions de VM dans votre dossier. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les extensions de VM dans votre dossier :

• Répertorier les extensions de VM : compute.folderVmExtensions.list
• Affichez les détails d'une extension de VM : compute.folderVmExtensions.get

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

Pour afficher les extensions de VM et les versions compatibles avec VM Extension Manager dans toutes les zones de votre dossier, sélectionnez l'une des options suivantes :

gcloud

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans toutes les zones de votre dossier, exécutez la commande gcloud preview compute global-vm-extension-policies extensions list avec l'option --folder :

gcloud preview compute global-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID

Remplacez les éléments suivants :

• FOLDER_ID : ID de votre dossier Google Cloud .

Le résultat liste les extensions de VM compatibles avec le VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans votre dossier, exécutez la commande gcloud preview compute global-vm-extension-policies extensions describe avec l'option --folder :

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID

Remplacez les éléments suivants :

• EXTENSION_NAME : nom de l'extension de VM (par exemple, ops-agent, google-cloud-sap-extension ou google-cloud-workload-extension).
• FOLDER_ID : ID de votre dossier Google Cloud .

REST

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans toutes les zones de votre dossier, envoyez une requête GET à la méthode folderGlobalVmExtensionPolicies.listVmExtensions :

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions

Remplacez les éléments suivants :

• FOLDER_ID : ID de votre dossier Google Cloud .

La réponse liste les extensions de VM compatibles avec VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans votre dossier, envoyez une requête GET à la méthode folderGlobalVmExtensionPolicies.getVmExtension :

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/global/vmExtensions/EXTENSION_NAME

Remplacez les éléments suivants :

• FOLDER_ID : ID de votre dossier Google Cloud .
• EXTENSION_NAME : nom de l'extension de VM (par exemple, ops-agent).

Afficher les extensions de VM dans toutes les zones d'un projet

Utilisez les méthodes get et list en lecture seule pour afficher les extensions de VM compatibles avec VM Extension Manager dans toutes les zones de votre projet, y compris leurs numéros de version et leurs niveaux de compatibilité.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les extensions de VM dans votre projet, demandez à votre administrateur de vous accorder le rôle IAM Lecteur des règles d'extension de VM Compute (roles/compute.vmExtensionPolicyViewer) ou Administrateur des règles d'extension de VM Compute (roles/compute.vmExtensionPolicyAdmin) 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 afficher les extensions de VM dans votre projet. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les extensions de VM dans votre projet :

• Répertorier les extensions de VM : compute.vmExtensions.list
• Affichez les détails d'une extension de VM : compute.vmExtensions.get

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

Pour afficher les extensions de VM et les versions compatibles avec VM Extension Manager dans toutes les zones de votre projet, sélectionnez l'une des options suivantes :

gcloud

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans toutes les zones de votre projet, exécutez la commande gcloud preview compute global-vm-extension-policies extensions list :

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .

Le résultat liste les extensions de VM compatibles avec le VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans votre projet, exécutez la commande gcloud preview compute global-vm-extension-policies extensions describe :

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

Remplacez les éléments suivants :

• EXTENSION_NAME : nom de l'extension de VM (par exemple, ops-agent, google-cloud-sap-extension ou google-cloud-workload-extension).
• PROJECT_ID : ID de votre projet Google Cloud .

REST

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans toutes les zones de votre projet, envoyez une requête GET à la méthode globalVmExtensionPolicies.listVmExtensions :

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .

L'extrait de code JSON suivant montre un exemple de réponse qui liste les extensions de VM compatibles avec le VM Extension Manager et leurs niveaux de compatibilité :

{
  "kind": "compute#globalVmExtensionList",
  "items": [
    {
      "kind": "compute#globalVmExtension",
      "name": "ops-agent",
      "versions": [
        "2.58.0",
        "2.57.0"
      ],
      "supportLevel": "GA",
      "selfLink": "https://www.googleapis.com/compute/2026-10-01-preview/projects/my-project/global/vmExtensions/ops-agent"
    }
  ]
}

Pour afficher les détails d'une extension de VM spécifique dans votre projet, envoyez une requête GET à la méthode globalVmExtensionPolicies.getVmExtension :

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/global/vmExtensions/EXTENSION_NAME

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• EXTENSION_NAME : nom de l'extension de VM (par exemple, ops-agent).

Afficher les extensions de VM d'une zone dans une organisation

Utilisez les méthodes en lecture seule get et list pour afficher les extensions de VM compatibles avec VM Extension Manager dans une zone spécifique de votre organisation, y compris leurs numéros de version et leurs niveaux de compatibilité.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les extensions de VM dans une zone de votre organisation, demandez à votre administrateur de vous accorder le rôle IAM Lecteur de règles d'extension de VM Compute au niveau de l'organisation (roles/compute.orgVmExtensionPolicyViewer) ou Administrateur de règles d'extension de VM Compute au niveau de l'organisation (roles/compute.orgVmExtensionPolicyAdmin) sur votre organisation. 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 afficher les extensions de VM dans une zone de votre organisation. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les extensions de VM dans une zone de votre organisation :

• Répertorier les extensions de VM : compute.orgVmExtensions.list
• Affichez les détails d'une extension de VM : compute.orgVmExtensions.get

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

Pour afficher les extensions de VM et les versions compatibles avec VM Extension Manager dans une zone de votre organisation, sélectionnez l'une des options suivantes :

gcloud

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans une zone spécifique de votre organisation, exécutez la commande gcloud preview compute zone-vm-extension-policies extensions list avec l'option --organization :

gcloud preview compute zone-vm-extension-policies extensions list \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

Remplacez les éléments suivants :

• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• ZONE : zone Google Cloud dans laquelle vous souhaitez lister les extensions de VM (par exemple, us-central1-a).

Le résultat liste les extensions de VM compatibles avec le VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans une zone de votre organisation, exécutez la commande gcloud preview compute zone-vm-extension-policies extensions describe avec l'option --organization :

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE

Remplacez les éléments suivants :

• EXTENSION_NAME : nom de l'extension de VM (par exemple, ops-agent).
• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• ZONE : zone dans laquelle vous souhaitez afficher les détails de l'extension.

REST

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans une zone spécifique de votre organisation, envoyez une requête GET à la méthode organizationZoneVmExtensionPolicies.listVmExtensions :

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions

Remplacez les éléments suivants :

• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• ZONE : nom de la zone (par exemple, us-central1-a).

La réponse liste les extensions de VM compatibles avec VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans une zone de votre organisation, envoyez une requête GET à la méthode organizationZoneVmExtensionPolicies.getVmExtension :

GET https://compute.googleapis.com/compute/2026-10-01-preview/organizations/ORGANIZATION_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

Remplacez les éléments suivants :

• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• ZONE : nom de la zone.
• EXTENSION_NAME : nom de l'extension de VM.

Afficher les extensions de VM dans une zone d'un dossier

Utilisez les méthodes get et list en lecture seule pour afficher les extensions de VM compatibles avec VM Extension Manager dans une zone spécifique de votre dossier, y compris leurs numéros de version et leurs niveaux de compatibilité.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les extensions de VM dans une zone de votre dossier, demandez à votre administrateur de vous accorder le rôle IAM Lecteur des règles d'extension de VM Compute au niveau du dossier (roles/compute.folderVmExtensionPolicyViewer) ou Administrateur des règles d'extension de VM Compute au niveau du dossier (roles/compute.folderVmExtensionPolicyAdmin) sur votre dossier. 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 afficher les extensions de VM dans une zone de votre dossier. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les extensions de VM dans une zone de votre dossier :

• Répertorier les extensions de VM : compute.folderVmExtensions.list
• Affichez les détails d'une extension de VM : compute.folderVmExtensions.get

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

Pour afficher les extensions de VM et les versions compatibles avec le gestionnaire d'extensions de VM dans une zone de votre dossier, sélectionnez l'une des options suivantes :

gcloud

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans une zone spécifique de votre dossier, exécutez la commande gcloud preview compute zone-vm-extension-policies extensions list avec l'option --folder :

gcloud preview compute zone-vm-extension-policies extensions list \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

Remplacez les éléments suivants :

• FOLDER_ID : ID de votre dossier Google Cloud .
• ZONE : zone Google Cloud dans laquelle vous souhaitez lister les extensions de VM (par exemple, us-central1-a).

Le résultat liste les extensions de VM compatibles avec le VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans une zone de votre dossier, exécutez la commande gcloud preview compute zone-vm-extension-policies extensions describe avec l'option --folder :

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE

Remplacez les éléments suivants :

• EXTENSION_NAME : nom de l'extension de VM (par exemple, ops-agent).
• FOLDER_ID : ID de votre dossier Google Cloud .
• ZONE : zone dans laquelle vous souhaitez afficher les détails de l'extension.

REST

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans une zone spécifique de votre dossier, envoyez une requête GET à la méthode folderZoneVmExtensionPolicies.listVmExtensions :

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions

Remplacez les éléments suivants :

• FOLDER_ID : ID de votre dossier Google Cloud .
• ZONE : nom de la zone (par exemple, us-central1-a).

La réponse liste les extensions de VM compatibles avec VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans une zone de votre dossier, envoyez une requête GET à la méthode folderZoneVmExtensionPolicies.getVmExtension :

GET https://compute.googleapis.com/compute/2026-10-01-preview/folders/FOLDER_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

Remplacez les éléments suivants :

• FOLDER_ID : ID de votre dossier Google Cloud .
• ZONE : nom de la zone.
• EXTENSION_NAME : nom de l'extension de VM.

Afficher les extensions de VM dans une zone d'un projet

Utilisez les méthodes get et list en lecture seule pour afficher les extensions de VM compatibles avec VM Extension Manager dans une zone spécifique de votre projet, y compris leurs numéros de version et leurs niveaux de compatibilité.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les extensions de VM dans une zone de votre projet, demandez à votre administrateur de vous accorder le rôle IAM Lecteur des règles d'extension de VM Compute (roles/compute.vmExtensionPolicyViewer) ou Administrateur des règles d'extension de VM Compute (roles/compute.vmExtensionPolicyAdmin) 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 afficher les extensions de VM dans une zone de votre projet. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les extensions de VM dans une zone de votre projet :

• Répertorier les extensions de VM : compute.vmExtensions.list
• Affichez les détails d'une extension de VM : compute.vmExtensions.get

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

Pour afficher les extensions de VM et les versions compatibles avec VM Extension Manager dans une zone de votre projet, sélectionnez l'une des options suivantes :

gcloud

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans une zone spécifique de votre projet, exécutez la commande gcloud preview compute zone-vm-extension-policies extensions list :

gcloud preview compute zone-vm-extension-policies extensions list \
  --zone=ZONE \
  --project=PROJECT_ID

Remplacez les éléments suivants :

• ZONE : zone Google Cloud dans laquelle vous souhaitez lister les extensions de VM (par exemple, us-central1-a).
• PROJECT_ID : ID de votre projet Google Cloud .

Le résultat liste les extensions de VM compatibles avec le VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans une zone de votre projet, exécutez la commande gcloud preview compute zone-vm-extension-policies extensions describe :

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --zone=ZONE \
  --project=PROJECT_ID

Remplacez les éléments suivants :

• EXTENSION_NAME : nom de l'extension de VM (par exemple, ops-agent).
• ZONE : zone dans laquelle vous souhaitez afficher les détails de l'extension.
• PROJECT_ID : ID de votre projet Google Cloud .

REST

Pour lister toutes les extensions de VM compatibles avec VM Extension Manager et leurs niveaux de compatibilité dans une zone spécifique de votre projet, envoyez une requête GET à la méthode zoneVmExtensionPolicies.listVmExtensions :

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : nom de la zone (par exemple, us-central1-a).

La réponse liste les extensions de VM compatibles avec VM Extension Manager, leurs versions et leurs niveaux de compatibilité.

Pour afficher les détails d'une extension de VM spécifique dans une zone de votre projet, envoyez une requête GET à la méthode zoneVmExtensionPolicies.getVmExtension :

GET https://compute.googleapis.com/compute/2026-10-01-preview/projects/PROJECT_ID/zones/ZONE/vmExtensions/EXTENSION_NAME

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : nom de la zone.
• EXTENSION_NAME : nom de l'extension de VM.

Afficher les états des extensions de VM sur une instance

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Vous installez des extensions de VM sur des VM en créant des règles d'extension globales ou zonales au niveau de l'organisation, du dossier ou du projet. Une même règle peut installer plusieurs extensions sur une seule VM, et plusieurs règles de votre hiérarchie de ressources peuvent s'appliquer à la même VM. Utilisez les méthodes d'état d'extension d'instance en lecture seule list et get pour afficher l'état d'exécution des extensions installées sur chaque VM sans vous connecter à des machines individuelles. Ces méthodes vous permettent de voir la configuration effective finale et la règle applicable (policyId) pour chaque extension installée, ou de résoudre les problèmes lorsqu'une extension inattendue est installée ou qu'une extension échoue sur une instance.

Autorisations IAM requises

Pour obtenir les autorisations nécessaires pour afficher les états des extensions de VM sur une instance, demandez à votre administrateur de vous accorder le rôle IAM Lecteur Compute (roles/compute.viewer), Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1) ou 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 afficher les états des extensions de VM sur une instance. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour afficher les états des extensions de VM sur une instance :

• Répertoriez tous les états d'extension de VM sur une instance : compute.instances.listVmExtensionStates
• Obtenez l'état d'une extension de VM spécifique sur une instance : compute.instances.getVmExtensionState

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

Lister tous les états d'extension de VM sur une instance

Lorsqu'une règle installe plusieurs extensions sur une VM, lorsque plusieurs règles s'appliquent à la même instance ou lorsque vous trouvez une extension inattendue lors du dépannage, listez tous les états d'extension sur la VM pour afficher la configuration effective finale et l'état d'exécution de chaque extension installée. La réponse indique la version active, l'état d'application, l'état de santé et la règle applicable (policyId) de chaque extension.

Pour afficher l'état de toutes les extensions de VM installées sur une instance, sélectionnez l'une des options suivantes :

gcloud

Pour lister toutes les extensions de VM installées et afficher leur état actuel sur une instance, exécutez la commande gcloud beta compute instances list-vm-extension-states :

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

Remplacez les variables suivantes par les valeurs de votre environnement :

• INSTANCE_NAME : nom de l'instance de VM
• ZONE : zone où se trouve l'instance (par exemple, us-central1-a).
• PROJECT_ID : ID de votre projet Google Cloud .

La commande renvoie un tableau qui liste le nom, l'état d'application et l'état de chaque extension installée :

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

REST

Pour lister toutes les extensions de VM installées et afficher leur état actuel sur une instance, envoyez une requête GET à la méthode instances.listVmExtensionStates :

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates

Remplacez les variables suivantes par les valeurs de votre environnement :

• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : zone où se trouve l'instance
• INSTANCE_NAME : nom ou ID de l'instance de VM.

L'extrait de code JSON suivant montre un exemple de réponse listant les états des extensions installées sur une instance :

{
  "kind": "compute#vmExtensionStatesList",
  "items": [
    {
      "name": "ops-agent",
      "version": "2.58.0",
      "healthStatus": "RUNNING",
      "enforcementState": "INSTALLED",
      "healthMsg": "Plugin is running ok",
      "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
    }
  ]
}

Afficher l'état d'une extension de VM spécifique sur une instance

Lorsque plusieurs règles ciblent une VM ou qu'une extension installée ne s'exécute pas comme prévu, affichez l'état de cette extension spécifique pour voir sa configuration effective finale (policyId et version) et les messages d'état de diagnostic.

Pour afficher l'état effectif et la règle applicable d'une extension de VM spécifique sur une instance, sélectionnez l'une des options suivantes :

gcloud

Pour récupérer l'état effectif, la version active et la règle de gouvernance d'une extension de VM spécifique sur une instance, exécutez la commande gcloud beta compute instances get-vm-extension-state :

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --extension-name=EXTENSION_NAME \
    --zone=ZONE \
    --project=PROJECT_ID

Remplacez les variables suivantes par les valeurs de votre environnement :

• INSTANCE_NAME : nom de l'instance de VM
• EXTENSION_NAME : nom de l'extension que vous souhaitez inspecter (par exemple, ops-agent).
• ZONE : zone dans laquelle se trouve l'instance.
• PROJECT_ID : ID de votre projet Google Cloud .

REST

Pour récupérer l'état effectif, la version active et la règle de gouvernance d'une extension de VM spécifique sur une instance, envoyez une requête GET à la méthode instances.getVmExtensionState :

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/vmExtensionStates/EXTENSION_NAME

Remplacez les variables suivantes par les valeurs de votre environnement :

• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : zone dans laquelle se trouve l'instance.
• INSTANCE_NAME : nom ou ID de l'instance de VM.
• EXTENSION_NAME : nom de l'extension de VM (par exemple, ops-agent).

L'extrait JSON suivant montre un exemple de réponse pour l'état d'une seule extension de VM sur une instance :

{
  "name": "ops-agent",
  "version": "2.58.0",
  "healthStatus": "RUNNING",
  "enforcementState": "INSTALLED",
  "enforcementMsg": "",
  "healthMsg": "Plugin is running ok",
  "policyId": "projects/my-project/zones/us-central1-a/vmExtensionPolicies/prod-ops-policy"
}

Interpréter les champs d'état de l'extension de VM

Lorsque vous récupérez l'état d'une extension de VM sur une instance, la réponse inclut des champs qui indiquent la règle appliquée, la version active, la progression de l'installation et l'état d'exécution du plug-in.

Le tableau suivant décrit les champs renvoyés par une ressource VmExtensionState :

Champ	Description
name	Identifiant de l'extension de VM (par exemple, ops-agent).
version	Version active de l'extension installée sur l'instance de VM.
policyId	Identifiant de la règle d'extension de VM effective qui applique cette extension sur l'instance. Si plusieurs règles ciblent la VM, ce champ indique la règle gagnante après la résolution des priorités.
enforcementState	État actuel du cycle de vie du processus d'application de l'extension. Les valeurs possibles sont les suivantes : ENFORCEMENT_STATE_UNSPECIFIED : l'état d'application n'est pas spécifié. INSTALLING : l'agent invité installe l'extension. INSTALLED : l'extension est installée sur l'instance. INSTALL_FAILED : l'installation a échoué et aucune révision stable précédente n'est disponible pour le rollback. ROLLING_BACK : l'agent invité effectue un rollback de l'extension vers la dernière révision stable enregistrée. ROLLED_BACK : l'extension a été restaurée à la dernière révision stable. ROLLBACK_FAILED : échec de la tentative de rollback. INCOMPATIBLE : Aucune des révisions disponibles pour la version de l'extension n'est compatible avec le système d'exploitation ou l'architecture de la VM. REMOVING : l'agent invité supprime l'extension de l'instance. SERVICE_DISABLED : l'API de service requise pour cette extension est désactivée dans le projet. APPLYING_CONFIG : l'agent invité applique une nouvelle configuration à l'extension, ce qui peut impliquer le redémarrage du plug-in.
enforcementMsg	Message d'état de diagnostic renvoyé par l'agent invité si l'extension ne parvient pas à appliquer une règle ou rencontre une erreur d'installation.
healthStatus	État d'intégrité de l'environnement d'exécution du plug-in d'extension appliqué. Si l'extension n'est pas encore appliquée, cette valeur n'est pas spécifiée. Les valeurs possibles sont les suivantes : HEALTH_STATUS_UNSPECIFIED : l'état de santé n'est pas spécifié. STARTING : le processus d'extension démarre. RUNNING : le processus d'extension s'exécute normalement. STOPPING : le processus d'extension est en cours d'arrêt. STOPPED : le processus d'extension est arrêté. CRASHED : le processus d'extension a démarré, mais s'est arrêté de manière inattendue.
healthMsg	Message de diagnostic que l'extension signale concernant son état (par exemple, Plugin is running ok).

Étapes suivantes

• Pour diagnostiquer les échecs de déploiement, vérifier les processus invités en cours d'exécution ou inspecter les journaux de débogage de l'agent invité, consultez Résoudre les problèmes liés aux extensions de VM.
• Pour interroger l'historique des événements d'application et auditer les enregistrements d'installation ou de plantage dans Cloud Logging, consultez Afficher les journaux des extensions de VM.
• Pour créer des tableaux de bord Cloud Monitoring et configurer des alertes concernant l'état de l'agent, l'utilisation du processeur et l'utilisation de la mémoire, consultez Surveiller les extensions de VM.
• Pour modifier les paramètres de configuration, changer les versions épinglées ou supprimer les agents déployés, consultez Gérer les extensions de VM à l'aide de règles d'extension.