Gérer les extensions de VM à l'aide de règles d'extension

VM Extension Manager utilise des règles d'extension pour gérer vos extensions de VM à grande échelle. Pour en savoir plus, consultez À propos de VM Extension Manager. Ce document explique comment mettre à jour et supprimer des règles d'extension de VM globales et zonales au niveau du projet, ou au niveau du dossier et de l'organisation (disponible en preview). Pour afficher les règles d'extension, les extensions et versions de VM, ainsi que les états des extensions d'exécution sur les instances de VM, consultez Afficher les détails et l'état des extensions de VM. Pour diagnostiquer les problèmes d'installation ou d'exécution, consultez Résoudre les problèmes liés aux extensions de VM.

Limites de la gestion des règles

Vous ne pouvez mettre à jour et supprimer des 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 pas gérer les règles limitées à un dossier ou à une organisation dans la consoleGoogle Cloud .

Modifier des extensions en mettant à jour une règle d'extension de VM

Lorsque vous mettez à jour une règle, VM Extension Manager déploie les modifications sur toutes les VM concernées, généralement en une minute. Si vous modifiez les étiquettes d'inclusion, les extensions peuvent être installées sur de nouvelles VM ou désinstallées de VM existantes, selon qu'elles correspondent ou non aux étiquettes mises à jour.

Modifier les extensions de VM 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.

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour mettre à jour une règle d'extension au niveau de l'organisation, demandez à votre administrateur de vous accorder le rôle IAM Administrateur des 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 l'autorisation compute.orgVmExtensionPolicies.update, qui est nécessaire pour mettre à jour une stratégie d'extension au niveau de l'organisation.

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

Pour mettre à jour une règle d'extension globale au niveau de l'organisation, sélectionnez l'une des options suivantes :

gcloud

Exécutez la commande gcloud preview compute global-vm-extension-policies update avec l'option --organization pour modifier une règle d'extension de VM globale existante au niveau de l'organisation. Lorsque vous mettez à jour une stratégie à l'aide de gcloud, la requête agit comme un remplacement complet. Tous les champs facultatifs que vous omettez reviennent à leurs valeurs par défaut au lieu de conserver les valeurs existantes de la stratégie modifiée.

Pour mettre à jour une règle d'extension de VM globale au niveau de l'organisation, exécutez la commande suivante :

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• ORGANIZATION_ID : l'ID de votre organisation Google Cloud .
• DESCRIPTION : description facultative de la règle.
• EXTENSION_NAME_1,EXTENSION_NAME_2 : liste d'extensions à ajouter à la règle, séparées par une virgule. Vous devez spécifier au moins une extension. Vous pouvez spécifier l'une des extensions compatibles suivantes :
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est la version de l'extension. Si vous ne spécifiez pas de version pour une extension, VM Extension Manager utilise la dernière version disponible et la met automatiquement à niveau lorsque de nouvelles versions sont disponibles.
  Remarque : Pour ops-agent, VM Extension Manager est compatible avec l'installation de la version 2.58.0 ou de versions ultérieures. Pour google-cloud-sap-extension et google-cloud-workload-extension, VM Extension Manager n'est compatible qu'avec la dernière version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est le chemin d'accès au fichier de configuration de cette extension. Ce fichier se trouve sur la VM sur laquelle vous exécutez la commande gcloud, et non sur la VM sur laquelle vous installez l'extension.

  Vous pouvez également fournir la configuration sous forme de chaîne intégrée en utilisant l'option --config au lieu de --config-from-file (par exemple, EXTENSION_NAME_1="CONFIG_1"). Vous pouvez utiliser --config-from-file ou --config, mais pas les deux dans la même commande.

• KEY_1=VALUE_1 : liste de paires clé/valeur séparées par une virgule qui définissent les étiquettes d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Si vous spécifiez --inclusion-labels plusieurs fois, la règle cible les VM qui correspondent à l'un des sélecteurs fournis (OU logique). Si vous omettez cette option, la règle cible toutes les VM de tous les projets et zones descendants de l'organisation.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.
• ROLLOUT_PLAN : spécifiez slow_rollout ou fast_rollout. Si vous devez utiliser un plan de déploiement personnalisé, spécifiez l'option --rollout-custom-plan au lieu de --rollout-predefined-plan au format suivant :

  --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Remplacez les éléments suivants :

  • ORGANIZATION_ID : organisation dans laquelle le plan de déploiement est défini.
  • ROLLOUT_PLAN_NAME : nom du plan de déploiement personnalisé que vous avez défini.

  Si vous ne spécifiez pas d'option de plan de déploiement, VM Extension Manager utilise slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR : spécifie le comportement lorsque VM Extension Manager détecte un conflit entre une règle zonale et une règle globale. Vous pouvez spécifier l'un des comportements de conflit suivants :
  • "" (chaîne vide) : la règle globale n'écrase pas les règles zonales en conflit portant le même nom. Il s'agit du comportement par défaut en cas de conflit.
  • overwrite : la stratégie globale écrase toute stratégie zonale portant le même nom, puis gère les déploiements de stratégies dans la zone.

  Pour en savoir plus, consultez la section concernant l'option --rollout-conflict-behavior.

• RETRY_UUID : UUID qui identifie une nouvelle tentative de déploiement d'une mise à jour de stratégie. Cet UUID vous permet de réessayer une mise à jour sans modification. Une erreur se produit si vous définissez cet indicateur et que la stratégie est modifiée. Pour en savoir plus, consultez Réessayer un déploiement.

Exemple : Mettre à jour une règle globale au niveau de l'organisation

La commande suivante met à jour la règle prod-frontend-policy dans l'organisation 123456789 pour ajouter l'extension google-cloud-workload-extension et annuler l'épinglage de ops-agent afin qu'elle suive la dernière version à l'aide d'un plan de déploiement rapide :

gcloud preview compute global-vm-extension-policies update prod-frontend-policy \
  --organization=organizations/123456789 \
  --description="Updated policy: ops-agent + workload extension, unpinned" \
  --extensions=ops-agent,google-cloud-workload-extension \
  --config=ops-agent="updated-monitoring-config" \
  --inclusion-labels="env=prod,workload=frontend" \
  --priority=100 \
  --rollout-predefined-plan=fast_rollout

REST

Pour mettre à jour une règle d'extension globale au niveau de l'organisation, envoyez une requête PATCH à la méthode organizationGlobalVmExtensionPolicies.update. Lorsque vous mettez à jour une stratégie à l'aide de REST, il vous suffit de fournir les champs que vous souhaitez mettre à jour. Les champs que vous omettez conservent leurs valeurs existantes.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Remplacez les éléments suivants :

• ORGANIZATION_ID : l'ID de votre organisation Google Cloud .
• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• DESCRIPTION : description de la règle d'extension de VM.
• EXTENSION_NAME : nom de l'extension à mettre à jour, utilisé comme clé dans le mappage extensionPolicies. Pour mettre à jour plusieurs extensions, incluez plusieurs entrées dans le mappage extensionPolicies.
• EXTENSION_NAME_VERSION : version de l'extension de VM.
• EXTENSION_NAME_CONFIG : paramètres de configuration de l'extension de VM, sous forme de chaîne intégrée.
• KEY_1:VALUE_1, KEY_2:VALUE_2 : paires clé-valeur qui définissent les libellés d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Pour spécifier plusieurs sélecteurs, incluez plusieurs objets dans le tableau instanceSelectors, chacun avec un champ labelSelector. Dans ce cas, VM Extension Manager cible les VM qui correspondent à n'importe lequel des sélecteurs fournis (OU logique). Si vous omettez instanceSelectors, la règle cible toutes les VM de l'ensemble des projets et zones descendants de l'organisation.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.
• ROLLOUT_CONFLICT_BEHAVIOR : spécifie le comportement lorsque VM Extension Manager détecte un conflit entre une règle zonale et une règle globale. Vous pouvez spécifier l'un des comportements de conflit suivants :
  • "" (chaîne vide) : la règle globale n'écrase pas les règles zonales en conflit portant le même nom. Il s'agit du comportement par défaut en cas de conflit.
  • overwrite : la stratégie globale écrase toute stratégie zonale portant le même nom, puis gère les déploiements de stratégies dans la zone.

  Pour en savoir plus, consultez la section concernant l'option --rollout-conflict-behavior.

• ROLLOUT_PLAN_NAME : nom du plan de déploiement personnalisé que vous avez défini. Pour utiliser un plan de déploiement prédéfini, remplacez le champ name par predefinedRolloutPlan et spécifiez l'une des valeurs suivantes :
  • SLOW_ROLLOUT : déploie la règle sur cinq jours. Ce plan prédéfini est le plan de déploiement par défaut si vous n'en spécifiez pas.
  • FAST_ROLLOUT : déploie immédiatement la stratégie dans toutes les zones.
• RETRY_UUID : UUID qui identifie une nouvelle tentative de déploiement d'une mise à jour de stratégie.

Modifier les extensions de VM 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.

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour mettre à jour une règle d'extension limitée à un dossier, demandez à votre administrateur de vous accorder le rôle IAM 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 l'autorisation compute.folderVmExtensionPolicies.update, qui est requise pour mettre à jour une règle d'extension limitée à un dossier.

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

Pour mettre à jour une règle d'extension globale limitée à un dossier, sélectionnez l'une des options suivantes :

gcloud

Exécutez la commande gcloud preview compute global-vm-extension-policies update avec l'option --folder pour modifier une règle d'extension de VM globale existante limitée à un dossier. Lorsque vous mettez à jour une stratégie à l'aide de gcloud, la requête agit comme un remplacement complet. Tous les champs facultatifs que vous omettez reviennent à leurs valeurs par défaut au lieu de conserver les valeurs existantes de la stratégie modifiée.

Pour mettre à jour une règle d'extension de VM globale limitée à un dossier, exécutez la commande suivante :

gcloud preview compute global-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• FOLDER_ID : l'ID de votre dossier Google Cloud .
• DESCRIPTION : description facultative de la règle.
• EXTENSION_NAME_1,EXTENSION_NAME_2 : liste d'extensions à ajouter à la règle, séparées par une virgule. Vous devez spécifier au moins une extension. Vous pouvez spécifier l'une des extensions compatibles suivantes :
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est la version de l'extension. Si vous ne spécifiez pas de version pour une extension, VM Extension Manager utilise la dernière version disponible et la met automatiquement à niveau lorsque de nouvelles versions sont disponibles.
  Remarque : Pour ops-agent, VM Extension Manager est compatible avec l'installation de la version 2.58.0 ou de versions ultérieures. Pour google-cloud-sap-extension et google-cloud-workload-extension, VM Extension Manager n'est compatible qu'avec la dernière version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est le chemin d'accès au fichier de configuration de cette extension. Ce fichier se trouve sur la VM sur laquelle vous exécutez la commande gcloud, et non sur la VM sur laquelle vous installez l'extension.

  Vous pouvez également fournir la configuration sous forme de chaîne intégrée en utilisant l'option --config au lieu de --config-from-file (par exemple, EXTENSION_NAME_1="CONFIG_1"). Vous pouvez utiliser --config-from-file ou --config, mais pas les deux dans la même commande.

• KEY_1=VALUE_1 : liste de paires clé/valeur séparées par une virgule qui définissent les étiquettes d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Si vous spécifiez --inclusion-labels plusieurs fois, la règle cible les VM qui correspondent à l'un des sélecteurs fournis (OU logique). Si vous omettez cette option, la règle cible toutes les VM de tous les projets et zones descendants du dossier.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.
• ROLLOUT_PLAN : spécifiez slow_rollout ou fast_rollout. Si vous devez utiliser un plan de déploiement personnalisé, spécifiez l'option --rollout-custom-plan au lieu de --rollout-predefined-plan au format suivant :

  --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Remplacez les éléments suivants :

  • FOLDER_ID : dossier dans lequel le plan de déploiement est défini.
  • ROLLOUT_PLAN_NAME : nom du plan de déploiement personnalisé que vous avez défini.

  Si vous ne spécifiez pas d'option de plan de déploiement, VM Extension Manager utilise slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR : spécifie le comportement lorsque VM Extension Manager détecte un conflit entre une règle zonale et une règle globale. Vous pouvez spécifier l'un des comportements de conflit suivants :
  • "" (chaîne vide) : la règle globale n'écrase pas les règles zonales en conflit portant le même nom. Il s'agit du comportement par défaut en cas de conflit.
  • overwrite : la stratégie globale écrase toute stratégie zonale portant le même nom, puis gère les déploiements de stratégies dans la zone.

  Pour en savoir plus, consultez la section concernant l'option --rollout-conflict-behavior.

• RETRY_UUID : UUID qui identifie une nouvelle tentative de déploiement d'une mise à jour de stratégie. Cet UUID vous permet de réessayer une mise à jour sans modification. Une erreur se produit si vous définissez cet indicateur et que la stratégie est modifiée. Pour en savoir plus, consultez Réessayer un déploiement.

REST

Pour mettre à jour une règle d'extension globale limitée à un dossier, envoyez une requête PATCH à la méthode folderGlobalVmExtensionPolicies.update. Lorsque vous mettez à jour une stratégie à l'aide de REST, il vous suffit de fournir les champs que vous souhaitez mettre à jour. Les champs que vous omettez conservent leurs valeurs existantes.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Remplacez les éléments suivants :

• FOLDER_ID : l'ID de votre dossier Google Cloud .
• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• DESCRIPTION : description de la règle d'extension de VM.
• EXTENSION_NAME : nom de l'extension à mettre à jour, utilisé comme clé dans le mappage extensionPolicies. Pour mettre à jour plusieurs extensions, incluez plusieurs entrées dans le mappage extensionPolicies.
• EXTENSION_NAME_VERSION : version de l'extension de VM.
• EXTENSION_NAME_CONFIG : paramètres de configuration de l'extension de VM, sous forme de chaîne intégrée.
• KEY_1:VALUE_1, KEY_2:VALUE_2 : paires clé-valeur qui définissent les libellés d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Pour spécifier plusieurs sélecteurs, incluez plusieurs objets dans le tableau instanceSelectors, chacun avec un champ labelSelector. Dans ce cas, VM Extension Manager cible les VM qui correspondent à n'importe lequel des sélecteurs fournis (OU logique). Si vous omettez instanceSelectors, la règle cible toutes les VM de tous les projets et zones descendants du dossier.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.
• ROLLOUT_CONFLICT_BEHAVIOR : spécifie le comportement lorsque VM Extension Manager détecte un conflit entre une règle zonale et une règle globale. Vous pouvez spécifier l'un des comportements de conflit suivants :
  • "" (chaîne vide) : la règle globale n'écrase pas les règles zonales en conflit portant le même nom. Il s'agit du comportement par défaut en cas de conflit.
  • overwrite : la stratégie globale écrase toute stratégie zonale portant le même nom, puis gère les déploiements de stratégies dans la zone.

  Pour en savoir plus, consultez la section concernant l'option --rollout-conflict-behavior.

• ROLLOUT_PLAN_NAME : nom du plan de déploiement personnalisé que vous avez défini. Pour utiliser un plan de déploiement prédéfini, remplacez le champ name par predefinedRolloutPlan et spécifiez l'une des valeurs suivantes :
  • SLOW_ROLLOUT : déploie la règle sur cinq jours. Ce plan prédéfini est le plan de déploiement par défaut si vous n'en spécifiez pas.
  • FAST_ROLLOUT : déploie immédiatement la stratégie dans toutes les zones.
• RETRY_UUID : UUID qui identifie une nouvelle tentative de déploiement d'une mise à jour de stratégie.

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

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour mettre à jour une règle d'extension au niveau du projet, demandez à votre administrateur de vous accorder le rôle IAM 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 l'autorisation compute.vmExtensionPolicies.update, qui est nécessaire pour mettre à jour une règle d'extension limitée au projet.

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

Pour mettre à jour une règle d'extension globale au niveau du projet, sélectionnez l'une des options suivantes :

Console

Pour mettre à jour une règle d'extension de VM globale limitée à un projet dans 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 Règles globales, puis sélectionnez la règle que vous souhaitez modifier.
3. Cliquez sur Modifier.
4. Dans le champ Priorité, spécifiez un numéro de priorité pour résoudre les conflits entre les règles. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1 000.
5. Dans la section Gérer les extensions, procédez comme suit :
   • Pour ajouter d'autres extensions, cliquez sur Ajouter une extension, puis sélectionnez l'extension et la version.
   • Pour supprimer une extension gérée par cette règle, cliquez sur le bouton Supprimer à côté du nom de l'extension.
6. Si vous souhaitez appliquer des étiquettes, ajoutez-les pour les VM cibles dans la section Instances de VM cibles.
7. Cliquez sur Enregistrer.

Remarque : La console Google Cloud ne permet pas de modifier un déploiement. Pour modifier un déploiement, utilisez la gcloud CLI ou l'API REST.

gcloud

Exécutez la commande gcloud compute global-vm-extension-policies update pour modifier une règle d'extension de VM globale existante au niveau du projet. Lorsque vous mettez à jour une stratégie à l'aide de gcloud, la requête agit comme un remplacement complet. Tous les champs facultatifs que vous omettez reviennent à leurs valeurs par défaut au lieu de conserver les valeurs existantes de la stratégie modifiée.

Pour mettre à jour une règle d'extension de VM globale au niveau du projet, exécutez la commande suivante :

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-conflict-behavior=ROLLOUT_CONFLICT_BEHAVIOR \
  --rollout-retry-uuid=RETRY_UUID

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• PROJECT_ID : ID de votre projet Google Cloud .
• DESCRIPTION : description facultative de la règle.
• EXTENSION_NAME_1,EXTENSION_NAME_2 : liste d'extensions à ajouter à la règle, séparées par une virgule. Vous devez spécifier au moins une extension. Vous pouvez spécifier l'une des extensions compatibles suivantes :
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est la version de l'extension. Si vous ne spécifiez pas de version pour une extension, VM Extension Manager utilise la dernière version disponible et la met automatiquement à niveau lorsque de nouvelles versions sont disponibles.
  Remarque : Pour ops-agent, VM Extension Manager est compatible avec l'installation de la version 2.58.0 ou de versions ultérieures. Pour google-cloud-sap-extension et google-cloud-workload-extension, VM Extension Manager n'est compatible qu'avec la dernière version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est le chemin d'accès au fichier de configuration de cette extension. Ce fichier se trouve sur la VM sur laquelle vous exécutez la commande gcloud, et non sur la VM sur laquelle vous installez l'extension.

  Vous pouvez également fournir la configuration sous forme de chaîne intégrée en utilisant l'option --config au lieu de --config-from-file (par exemple, EXTENSION_NAME_1="CONFIG_1"). Vous pouvez utiliser --config-from-file ou --config, mais pas les deux dans la même commande.

• KEY_1=VALUE_1 : liste de paires clé/valeur séparées par une virgule qui définissent les étiquettes d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Si vous spécifiez --inclusion-labels plusieurs fois, la règle cible les VM qui correspondent à l'un des sélecteurs fournis (OU logique). Si vous omettez cette option, la règle cible toutes les VM de toutes les zones du projet.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.
• ROLLOUT_PLAN : spécifiez slow_rollout ou fast_rollout. Si vous devez utiliser un plan de déploiement personnalisé, spécifiez l'option --rollout-custom-plan au lieu de --rollout-predefined-plan au format suivant :

  --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Remplacez les éléments suivants :

  • PROJECT_NUMBER : projet dans lequel le plan de déploiement est défini.
  • ROLLOUT_PLAN_NAME : nom du plan de déploiement personnalisé que vous avez défini.

  Si vous ne spécifiez pas d'option de plan de déploiement, VM Extension Manager utilise slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR : spécifie le comportement lorsque VM Extension Manager détecte un conflit entre une règle zonale et une règle globale. Vous pouvez spécifier l'un des comportements de conflit suivants :
  • "" (chaîne vide) : la règle globale n'écrase pas les règles zonales en conflit portant le même nom. Il s'agit du comportement par défaut en cas de conflit.
  • overwrite : la stratégie globale écrase toute stratégie zonale portant le même nom, puis gère les déploiements de stratégies dans la zone.

  Pour en savoir plus, consultez la section concernant l'option --rollout-conflict-behavior.

• RETRY_UUID : UUID qui identifie une nouvelle tentative de déploiement d'une mise à jour de stratégie. Cet UUID vous permet de réessayer une mise à jour sans modification. Une erreur se produit si vous définissez cet indicateur et que la stratégie est modifiée. Pour en savoir plus, consultez Réessayer un déploiement.

REST

Pour mettre à jour une règle d'extension globale limitée à un projet, envoyez une requête PATCH à la méthode globalVmExtensionPolicies.update. Lorsque vous mettez à jour une stratégie à l'aide de REST, il vous suffit de fournir les champs que vous souhaitez mettre à jour. Les champs que vous omettez conservent leurs valeurs existantes.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY,
"rolloutOperation": {
  "rolloutInput": {
    "conflictBehavior": "ROLLOUT_CONFLICT_BEHAVIOR",
    "retryUuid": "RETRY_UUID",
    "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME"
  }
}
}

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• DESCRIPTION : description de la règle d'extension de VM.
• EXTENSION_NAME : nom de l'extension à mettre à jour, utilisé comme clé dans le mappage extensionPolicies. Pour mettre à jour plusieurs extensions, incluez plusieurs entrées dans le mappage extensionPolicies.
• EXTENSION_NAME_VERSION : version de l'extension de VM.
• EXTENSION_NAME_CONFIG : paramètres de configuration de l'extension de VM, sous forme de chaîne intégrée.
• KEY_1:VALUE_1, KEY_2:VALUE_2 : paires clé-valeur qui définissent les libellés d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Pour spécifier plusieurs sélecteurs, incluez plusieurs objets dans le tableau instanceSelectors, chacun avec un champ labelSelector. Dans ce cas, VM Extension Manager cible les VM qui correspondent à n'importe lequel des sélecteurs fournis (OU logique). Si vous omettez instanceSelectors, la règle cible toutes les VM de toutes les zones du projet.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.
• ROLLOUT_CONFLICT_BEHAVIOR : spécifie le comportement lorsque VM Extension Manager détecte un conflit entre une règle zonale et une règle globale. Vous pouvez spécifier l'un des comportements de conflit suivants :
  • "" (chaîne vide) : la règle globale n'écrase pas les règles zonales en conflit portant le même nom. Il s'agit du comportement par défaut en cas de conflit.
  • overwrite : la stratégie globale écrase toute stratégie zonale portant le même nom, puis gère les déploiements de stratégies dans la zone.

  Pour en savoir plus, consultez la section concernant l'option --rollout-conflict-behavior.

• PROJECT_NUMBER : projet dans lequel le plan de déploiement personnalisé est défini.
• ROLLOUT_PLAN_NAME : nom du plan de déploiement personnalisé que vous avez défini. Pour utiliser un plan de déploiement prédéfini, remplacez le champ name par predefinedRolloutPlan et spécifiez l'une des valeurs suivantes :
  • SLOW_ROLLOUT : déploie la règle sur cinq jours. Ce plan prédéfini est le plan de déploiement par défaut si vous n'en spécifiez pas.
  • FAST_ROLLOUT : déploie immédiatement la stratégie dans toutes les zones.
• RETRY_UUID : UUID qui identifie une nouvelle tentative de déploiement d'une mise à jour de stratégie.

Modifier les extensions de VM dans une zone au sein 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.

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour mettre à jour une règle d'extension au niveau de l'organisation, demandez à votre administrateur de vous accorder le rôle IAM Administrateur des 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 l'autorisation compute.orgVmExtensionPolicies.update, qui est nécessaire pour mettre à jour une stratégie d'extension au niveau de l'organisation.

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

Pour mettre à jour une règle d'extension zonale au niveau de l'organisation, sélectionnez l'une des options suivantes :

gcloud

Utilisez la commande gcloud preview compute zone-vm-extension-policies update avec l'option --organization pour modifier une règle d'extension de VM zonale existante au niveau de l'organisation. Lorsque vous mettez à jour une stratégie à l'aide de gcloud, la requête agit comme un remplacement complet. Tous les champs facultatifs que vous omettez reviennent à leurs valeurs par défaut au lieu de conserver les valeurs existantes de la stratégie modifiée.

Pour mettre à jour une règle d'extension de VM zonale au niveau de l'organisation, exécutez la commande suivante :

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• ORGANIZATION_ID : l'ID de votre organisation Google Cloud .
• ZONE : zone Google Cloud où la stratégie s'applique.
• DESCRIPTION : description facultative de la règle.
• EXTENSION_NAME_1,EXTENSION_NAME_2 : liste d'extensions à ajouter à la règle, séparées par une virgule. Vous devez spécifier au moins une extension. Vous pouvez spécifier l'une des extensions compatibles suivantes :
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est la version de l'extension. Si vous ne spécifiez pas de version pour une extension, VM Extension Manager utilise la dernière version disponible et la met automatiquement à niveau lorsque de nouvelles versions sont disponibles.
  Remarque : Pour ops-agent, VM Extension Manager est compatible avec l'installation de la version 2.58.0 ou de versions ultérieures. Pour google-cloud-sap-extension et google-cloud-workload-extension, VM Extension Manager n'est compatible qu'avec la dernière version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est le chemin d'accès au fichier de configuration de cette extension. Ce fichier se trouve sur la VM sur laquelle vous exécutez la commande gcloud, et non sur la VM sur laquelle vous installez l'extension.

  Vous pouvez également fournir la configuration sous forme de chaîne intégrée en utilisant l'option --config au lieu de --config-from-file (par exemple, EXTENSION_NAME_1="CONFIG_1"). Vous pouvez utiliser --config-from-file ou --config, mais pas les deux dans la même commande.

• KEY_1=VALUE_1 : liste de paires clé/valeur séparées par une virgule qui définissent les étiquettes d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Si vous spécifiez --inclusion-labels plusieurs fois, la règle cible les VM qui correspondent à l'un des sélecteurs fournis (OU logique). Si vous omettez cette option, la règle cible toutes les VM de la zone spécifiée dans tous les projets descendants de l'organisation.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.

REST

Pour mettre à jour une règle d'extension zonale au niveau de l'organisation, envoyez une requête PATCH à la méthode organizationZoneVmExtensionPolicies.update. Lorsque vous mettez à jour une stratégie à l'aide de REST, il vous suffit de fournir les champs que vous souhaitez mettre à jour. Les champs que vous omettez conservent leurs valeurs existantes.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

Remplacez les éléments suivants :

• ORGANIZATION_ID : l'ID de votre organisation Google Cloud .
• ZONE : zone Google Cloud où se trouve la règle d'extension de VM.
• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• DESCRIPTION : description de la règle d'extension de VM.
• EXTENSION_NAME : nom de l'extension à mettre à jour, utilisé comme clé dans le mappage extensionPolicies. Pour mettre à jour plusieurs extensions, incluez plusieurs entrées dans le mappage extensionPolicies.
• EXTENSION_NAME_VERSION : version de l'extension de VM.
• EXTENSION_NAME_CONFIG : paramètres de configuration de l'extension de VM, sous forme de chaîne intégrée.
• KEY_1:VALUE_1, KEY_2:VALUE_2 : paires clé-valeur qui définissent les libellés d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Pour spécifier plusieurs sélecteurs, incluez plusieurs objets dans le tableau instanceSelectors, chacun avec un champ labelSelector. Dans ce cas, VM Extension Manager cible les VM qui correspondent à n'importe lequel des sélecteurs fournis (OU logique). Si vous omettez instanceSelectors, la règle cible toutes les VM de la zone spécifiée dans tous les projets descendants de l'organisation.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.

Modifier les extensions de VM 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.

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour mettre à jour une règle d'extension limitée à un dossier, demandez à votre administrateur de vous accorder le rôle IAM 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 l'autorisation compute.folderVmExtensionPolicies.update, qui est requise pour mettre à jour une règle d'extension limitée à un dossier.

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

Pour mettre à jour une règle d'extension zonale limitée à un dossier, sélectionnez l'une des options suivantes :

gcloud

Utilisez la commande gcloud preview compute zone-vm-extension-policies update avec l'option --folder pour modifier une règle d'extension de VM zonale existante limitée à un dossier. Lorsque vous mettez à jour une stratégie à l'aide de gcloud, la requête agit comme un remplacement complet. Tous les champs facultatifs que vous omettez reviennent à leurs valeurs par défaut au lieu de conserver les valeurs existantes de la stratégie modifiée.

Pour mettre à jour une règle d'extension de VM zonale limitée à un dossier, exécutez la commande suivante :

gcloud preview compute zone-vm-extension-policies update POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• FOLDER_ID : l'ID de votre dossier Google Cloud .
• ZONE : zone Google Cloud où la stratégie s'applique.
• DESCRIPTION : description facultative de la règle.
• EXTENSION_NAME_1,EXTENSION_NAME_2 : liste d'extensions à ajouter à la règle, séparées par une virgule. Vous devez spécifier au moins une extension. Vous pouvez spécifier l'une des extensions compatibles suivantes :
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est la version de l'extension. Si vous ne spécifiez pas de version pour une extension, VM Extension Manager utilise la dernière version disponible et la met automatiquement à niveau lorsque de nouvelles versions sont disponibles.
  Remarque : Pour ops-agent, VM Extension Manager est compatible avec l'installation de la version 2.58.0 ou de versions ultérieures. Pour google-cloud-sap-extension et google-cloud-workload-extension, VM Extension Manager n'est compatible qu'avec la dernière version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est le chemin d'accès au fichier de configuration de cette extension. Ce fichier se trouve sur la VM sur laquelle vous exécutez la commande gcloud, et non sur la VM sur laquelle vous installez l'extension.

  Vous pouvez également fournir la configuration sous forme de chaîne intégrée en utilisant l'option --config au lieu de --config-from-file (par exemple, EXTENSION_NAME_1="CONFIG_1"). Vous pouvez utiliser --config-from-file ou --config, mais pas les deux dans la même commande.

• KEY_1=VALUE_1 : liste de paires clé/valeur séparées par une virgule qui définissent les étiquettes d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Si vous spécifiez --inclusion-labels plusieurs fois, la règle cible les VM qui correspondent à l'un des sélecteurs fournis (OU logique). Si vous omettez cette option, la règle cible toutes les VM de la zone spécifiée dans tous les projets descendants du dossier.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.

REST

Pour mettre à jour une règle d'extension zonale limitée à un dossier, envoyez une requête PATCH à la méthode folderZoneVmExtensionPolicies.update. Lorsque vous mettez à jour une stratégie à l'aide de REST, il vous suffit de fournir les champs que vous souhaitez mettre à jour. Les champs que vous omettez conservent leurs valeurs existantes.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

Remplacez les éléments suivants :

• FOLDER_ID : l'ID de votre dossier Google Cloud .
• ZONE : zone Google Cloud où se trouve la règle d'extension de VM.
• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• DESCRIPTION : description de la règle d'extension de VM.
• EXTENSION_NAME : nom de l'extension à mettre à jour, utilisé comme clé dans le mappage extensionPolicies. Pour mettre à jour plusieurs extensions, incluez plusieurs entrées dans le mappage extensionPolicies.
• EXTENSION_NAME_VERSION : version de l'extension de VM.
• EXTENSION_NAME_CONFIG : paramètres de configuration de l'extension de VM, sous forme de chaîne intégrée.
• KEY_1:VALUE_1, KEY_2:VALUE_2 : paires clé-valeur qui définissent les libellés d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Pour spécifier plusieurs sélecteurs, incluez plusieurs objets dans le tableau instanceSelectors, chacun avec un champ labelSelector. Dans ce cas, VM Extension Manager cible les VM qui correspondent à n'importe lequel des sélecteurs fournis (OU logique). Si vous omettez instanceSelectors, la règle cible toutes les VM de la zone spécifiée dans tous les projets descendants du dossier.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.

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

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour mettre à jour une règle d'extension limitée au projet, demandez à votre administrateur de vous accorder le rôle IAM 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 l'autorisation compute.vmExtensionPolicies.update, qui est nécessaire pour mettre à jour une règle d'extension limitée au projet.

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

Pour mettre à jour une règle d'extension zonale au niveau du projet, sélectionnez l'une des options suivantes :

Console

Pour mettre à jour une règle d'extension de VM zonale au niveau du projet dans 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. Sélectionnez la règle que vous souhaitez mettre à jour.
3. Cliquez sur Modifier.
4. Modifiez la description, la priorité, les extensions ou les instances de VM cibles.
5. Cliquez sur Enregistrer.

gcloud

Utilisez la commande gcloud compute zone-vm-extension-policies update pour modifier une règle d'extension de VM zonale existante limitée au projet. Lorsque vous mettez à jour une stratégie à l'aide de gcloud, la requête agit comme un remplacement complet. Tous les champs facultatifs que vous omettez reviennent à leurs valeurs par défaut au lieu de conserver les valeurs existantes de la stratégie modifiée.

Pour mettre à jour une règle d'extension de VM zonale limitée au projet, exécutez la commande suivante :

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --description="DESCRIPTION" \
  --extensions=EXTENSION_NAME_1,EXTENSION_NAME_2 \
  --version=EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 \
  --config-from-file=EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 \
  --inclusion-labels=KEY_1=VALUE_1 \
  --priority=PRIORITY

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : zone Google Cloud où la stratégie s'applique.
• DESCRIPTION : description facultative de la règle.
• EXTENSION_NAME_1,EXTENSION_NAME_2 : liste d'extensions à ajouter à la règle, séparées par une virgule. Vous devez spécifier au moins une extension. Vous pouvez spécifier l'une des extensions compatibles suivantes :
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est la version de l'extension. Si vous ne spécifiez pas de version pour une extension, VM Extension Manager utilise la dernière version disponible et la met automatiquement à niveau lorsque de nouvelles versions sont disponibles.
  Remarque : Pour ops-agent, VM Extension Manager est compatible avec l'installation de la version 2.58.0 ou de versions ultérieures. Pour google-cloud-sap-extension et google-cloud-workload-extension, VM Extension Manager n'est compatible qu'avec la dernière version.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2 : liste de paires clé/valeur séparées par une virgule, où la clé est le nom de l'extension et la valeur est le chemin d'accès au fichier de configuration de cette extension. Ce fichier se trouve sur la VM sur laquelle vous exécutez la commande gcloud, et non sur la VM sur laquelle vous installez l'extension.

  Vous pouvez également fournir la configuration sous forme de chaîne intégrée en utilisant l'option --config au lieu de --config-from-file (par exemple, EXTENSION_NAME_1="CONFIG_1"). Vous pouvez utiliser --config-from-file ou --config, mais pas les deux dans la même commande.

• KEY_1=VALUE_1 : liste de paires clé/valeur séparées par une virgule qui définissent les étiquettes d'inclusion d'un sélecteur. Les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur pour être ciblées. Si vous spécifiez --inclusion-labels plusieurs fois, la règle cible les VM qui correspondent à l'un des sélecteurs fournis (OU logique). Si vous omettez cette option, la règle cible toutes les VM de la zone spécifiée dans votre projet.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.

REST

Pour mettre à jour une règle d'extension zonale au niveau du projet, envoyez une requête PATCH à la méthode zoneVmExtensionPolicies.update. Lorsque vous mettez à jour une stratégie à l'aide de REST, il vous suffit de fournir les champs que vous souhaitez mettre à jour. Les champs que vous omettez conservent leurs valeurs existantes.

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

{
"description": "DESCRIPTION",
"extensionPolicies": {
  "EXTENSION_NAME": {
    "pinnedVersion": "EXTENSION_NAME_VERSION",
    "stringConfig": "EXTENSION_NAME_CONFIG"
  }
},
"instanceSelectors": [
  {
    "labelSelector": {
      "inclusionLabels": {
        "KEY_1": "VALUE_1",
        "KEY_2": "VALUE_2"
      }
    }
  }
],
"priority": PRIORITY
}

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : zone Google Cloud où se trouve la règle d'extension de VM.
• POLICY_NAME : nom de la règle d'extension de VM à mettre à jour.
• DESCRIPTION : description de la règle d'extension de VM.
• EXTENSION_NAME : nom de l'extension à mettre à jour, utilisé comme clé dans le mappage extensionPolicies. Pour mettre à jour plusieurs extensions, incluez plusieurs entrées dans le mappage extensionPolicies.
• EXTENSION_NAME_VERSION : version de l'extension de VM.
• EXTENSION_NAME_CONFIG : paramètres de configuration de l'extension de VM, sous forme de chaîne intégrée.
• KEY_1:VALUE_1, KEY_2:VALUE_2 : paires clé-valeur qui définissent les libellés d'inclusion d'un sélecteur. Pour être ciblées, les VM doivent comporter toutes les étiquettes spécifiées dans un sélecteur. Pour spécifier plusieurs sélecteurs, incluez plusieurs objets dans le tableau instanceSelectors, chacun avec un champ labelSelector. Dans ce cas, VM Extension Manager cible les VM qui correspondent à n'importe lequel des sélecteurs fournis (OU logique). Si vous omettez instanceSelectors, la règle cible toutes les VM de la zone spécifiée dans votre projet.
• PRIORITY : entier compris entre 0 et 65535 qui définit la priorité de la stratégie. Plus le nombre est faible, plus la priorité est élevée. La valeur par défaut est 1000. Si plusieurs règles ont la même priorité, VM Extension Manager applique aux VM la règle mise à jour le plus récemment.

Désinstaller des extensions en supprimant une règle d'extension de VM

Lorsque vous supprimez une règle, VM Extension Manager désinstalle les extensions de toutes les VM gérées par cette règle. Toutefois, si une autre règle active de priorité inférieure s'applique à une VM et déclare la même extension, l'extension reste installée sur cette VM en fonction de la règle de priorité inférieure.

VM Extension Manager supprime les extensions de toutes les VM accessibles dans la minute qui suit la suppression de la règle. Si une VM est inaccessible parce que l'agent invité a été supprimé ou que la VM a été supprimée, VM Extension Manager ignore la suppression de l'extension. Si une telle VM redevient disponible, VM Extension Manager supprime les extensions à ce moment-là.

Désinstaller des extensions de VM 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.

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour supprimer une règle d'extension au niveau de l'organisation, demandez à votre administrateur de vous accorder le rôle IAM Administrateur des 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 l'autorisation compute.orgVmExtensionPolicies.delete, qui est nécessaire pour supprimer une règle d'extension limitée à l'organisation.

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

Pour supprimer une règle d'extension globale au niveau de l'organisation, sélectionnez l'une des options suivantes :

gcloud

Utilisez la commande gcloud preview compute global-vm-extension-policies delete avec l'option --organization pour supprimer une règle d'extension de VM globale existante au niveau de l'organisation :

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --organization=organizations/ORGANIZATION_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez supprimer.
• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• ROLLOUT_PLAN : spécifiez slow_rollout ou fast_rollout. Si vous devez utiliser un plan de déploiement personnalisé, spécifiez l'option --rollout-custom-plan au lieu de --rollout-predefined-plan au format suivant :

  --rollout-custom-plan=organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Remplacez les éléments suivants :

  • ORGANIZATION_ID : organisation dans laquelle le plan de déploiement est défini.
  • ROLLOUT_PLAN_NAME : nom du plan de déploiement personnalisé que vous avez défini.

  Si vous ne spécifiez pas d'option de plan de déploiement, VM Extension Manager utilise slow_rollout.

• RETRY_UUID : UUID permettant de réessayer de supprimer une règle d'extension. Ne définissez ce champ que lorsque vous relancez une demande de suppression pour une stratégie existante à l'état DELETING. La définition de ce champ lorsque la règle n'est pas à l'état DELETING entraîne une erreur. Pour en savoir plus, consultez Réessayer un déploiement.

REST

Pour supprimer une règle d'extension globale au niveau de l'organisation, envoyez une requête POST à la méthode organizationGlobalVmExtensionPolicies.delete.

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

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez supprimer.
• ORGANIZATION_ID : l'ID de votre organisation Google Cloud .
• ROLLOUT_PLAN : spécifiez SLOW_ROLLOUT ou FAST_ROLLOUT. Pour utiliser un plan de déploiement personnalisé, remplacez predefinedRolloutPlan par "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID : UUID permettant de réessayer de supprimer une règle d'extension. Ne définissez ce champ que lorsque vous relancez une demande de suppression pour une stratégie existante à l'état DELETING. La définition de ce champ lorsque la règle n'est pas à l'état DELETING entraîne une erreur. Pour en savoir plus, consultez Réessayer un déploiement.

Désinstaller des extensions de VM 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.

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour supprimer une règle d'extension limitée à un dossier, demandez à votre administrateur de vous accorder le rôle IAM 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 l'autorisation compute.folderVmExtensionPolicies.delete, qui est nécessaire pour supprimer une règle d'extension limitée à un dossier.

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

Pour supprimer une règle d'extension globale limitée à un dossier, sélectionnez l'une des options suivantes :

gcloud

Utilisez la commande gcloud preview compute global-vm-extension-policies delete avec l'option --folder pour supprimer une règle d'extension de VM globale existante limitée à un dossier :

gcloud preview compute global-vm-extension-policies delete POLICY_NAME \
  --folder=folders/FOLDER_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez supprimer.
• FOLDER_ID : ID de votre dossier Google Cloud .
• ROLLOUT_PLAN : spécifiez slow_rollout ou fast_rollout. Si vous devez utiliser un plan de déploiement personnalisé, spécifiez l'option --rollout-custom-plan au lieu de --rollout-predefined-plan au format suivant :

  --rollout-custom-plan=folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Remplacez les éléments suivants :

  • FOLDER_ID : dossier dans lequel le plan de déploiement est défini.
  • ROLLOUT_PLAN_NAME : nom du plan de déploiement personnalisé que vous avez défini.

  Si vous ne spécifiez pas d'option de plan de déploiement, VM Extension Manager utilise slow_rollout.

• RETRY_UUID : UUID permettant de réessayer de supprimer une règle d'extension. Ne définissez ce champ que lorsque vous relancez une demande de suppression pour une stratégie existante à l'état DELETING. La définition de ce champ lorsque la règle n'est pas à l'état DELETING entraîne une erreur. Pour en savoir plus, consultez Réessayer un déploiement.

REST

Pour supprimer une règle d'extension globale limitée à un dossier, envoyez une requête POST à la méthode folderGlobalVmExtensionPolicies.delete.

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

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez supprimer.
• FOLDER_ID : l'ID de votre dossier Google Cloud .
• ROLLOUT_PLAN : spécifiez SLOW_ROLLOUT ou FAST_ROLLOUT. Pour utiliser un plan de déploiement personnalisé, remplacez predefinedRolloutPlan par "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID : UUID permettant de réessayer de supprimer une règle d'extension. Ne définissez ce champ que lorsque vous relancez une demande de suppression pour une stratégie existante à l'état DELETING. La définition de ce champ lorsque la règle n'est pas à l'état DELETING entraîne une erreur. Pour en savoir plus, consultez Réessayer un déploiement.

Désinstaller des extensions de VM dans toutes les zones d'un projet

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour supprimer une règle d'extension limitée au projet, demandez à votre administrateur de vous accorder le rôle IAM 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 l'autorisation compute.vmExtensionPolicies.delete, qui est nécessaire pour supprimer une stratégie d'extension limitée au projet.

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

Pour supprimer une règle d'extension globale limitée au projet, sélectionnez l'une des options suivantes :

Console

Pour supprimer une règle d'extension de VM globale limitée au projet dans 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, puis sélectionnez la stratégie que vous souhaitez supprimer.
3. Cliquez sur Supprimer.
4. Dans la boîte de dialogue de confirmation, saisissez le nom de la stratégie, puis cliquez sur Supprimer.

gcloud

Exécutez la commande gcloud compute global-vm-extension-policies delete pour supprimer une règle d'extension de VM globale existante au niveau du projet :

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=ROLLOUT_PLAN \
  --rollout-retry-uuid=RETRY_UUID

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez supprimer.
• PROJECT_ID : ID de votre projet Google Cloud .
• ROLLOUT_PLAN : spécifiez slow_rollout ou fast_rollout. Si vous devez utiliser un plan de déploiement personnalisé, spécifiez l'option --rollout-custom-plan au lieu de --rollout-predefined-plan au format suivant :

  --rollout-custom-plan=projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME

  Remplacez les éléments suivants :

  • PROJECT_NUMBER : projet dans lequel le plan de déploiement est défini.
  • ROLLOUT_PLAN_NAME : nom du plan de déploiement personnalisé que vous avez défini.

  Si vous ne spécifiez pas d'option de plan de déploiement, VM Extension Manager utilise slow_rollout.

• RETRY_UUID : UUID permettant de réessayer de supprimer une règle d'extension. Ne définissez ce champ que lorsque vous relancez une demande de suppression pour une stratégie existante à l'état DELETING. La définition de ce champ lorsque la règle n'est pas à l'état DELETING entraîne une erreur. Pour en savoir plus, consultez Réessayer un déploiement.

REST

Pour supprimer une règle d'extension globale limitée au projet, envoyez une requête POST à la méthode globalVmExtensionPolicies.delete.

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

{
"retryUuid": "RETRY_UUID",
"predefinedRolloutPlan": "ROLLOUT_PLAN"
}

Remplacez les éléments suivants :

• POLICY_NAME : nom de la règle d'extension de VM que vous souhaitez supprimer.
• PROJECT_ID : ID de votre projet Google Cloud .
• ROLLOUT_PLAN : spécifiez SLOW_ROLLOUT ou FAST_ROLLOUT. Pour utiliser un plan de déploiement personnalisé, remplacez predefinedRolloutPlan par "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID : UUID permettant de réessayer de supprimer une règle d'extension. Ne définissez ce champ que lorsque vous relancez une demande de suppression pour une stratégie existante à l'état DELETING. La définition de ce champ lorsque la règle n'est pas à l'état DELETING entraîne une erreur. Pour en savoir plus, consultez Réessayer un déploiement.

Désinstaller des extensions de VM 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.

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour supprimer une règle d'extension au niveau de l'organisation, demandez à votre administrateur de vous accorder le rôle IAM Administrateur des 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 l'autorisation compute.orgVmExtensionPolicies.delete, qui est nécessaire pour supprimer une règle d'extension limitée à l'organisation.

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

Pour supprimer une règle d'extension zonale au niveau de l'organisation, sélectionnez l'une des options suivantes :

gcloud

Exécutez la commande gcloud preview compute zone-vm-extension-policies delete avec l'option --organization pour supprimer une règle d'extension de VM zonale existante au niveau de l'organisation :

gcloud preview compute zone-vm-extension-policies delete 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 supprimer.
• ORGANIZATION_ID : ID de votre organisation Google Cloud .
• ZONE : zone Google Cloud où se trouve la stratégie.

REST

Pour supprimer une règle d'extension zonale au niveau de l'organisation, envoyez une requête DELETE à la méthode organizationZoneVmExtensionPolicies.delete.

DELETE 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 supprimer.
• ORGANIZATION_ID : l'ID de votre organisation Google Cloud .
• ZONE : zone Google Cloud où se trouve la stratégie.

Désinstaller des extensions de VM 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.

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour supprimer une règle d'extension limitée à un dossier, demandez à votre administrateur de vous accorder le rôle IAM 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 l'autorisation compute.folderVmExtensionPolicies.delete, qui est nécessaire pour supprimer une règle d'extension limitée à un dossier.

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

Pour supprimer une règle d'extension zonale limitée à un dossier, sélectionnez l'une des options suivantes :

gcloud

Utilisez la commande gcloud preview compute zone-vm-extension-policies delete avec l'option --folder pour supprimer une règle d'extension de VM zonale existante au niveau du dossier :

gcloud preview compute zone-vm-extension-policies delete 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 supprimer.
• FOLDER_ID : ID de votre dossier Google Cloud .
• ZONE : zone Google Cloud où se trouve la stratégie.

REST

Pour supprimer une règle d'extension zonale limitée à un dossier, envoyez une requête DELETE à la méthode folderZoneVmExtensionPolicies.delete.

DELETE 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 supprimer.
• FOLDER_ID : l'ID de votre dossier Google Cloud .
• ZONE : zone Google Cloud où se trouve la stratégie.

Désinstaller des extensions de VM dans une zone d'un projet

Autorisations IAM requises

Pour obtenir l'autorisation nécessaire pour supprimer une règle d'extension limitée au projet, demandez à votre administrateur de vous accorder le rôle IAM 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 l'autorisation compute.vmExtensionPolicies.delete, qui est nécessaire pour supprimer une stratégie d'extension limitée au projet.

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

Pour supprimer une règle d'extension zonale limitée au projet, sélectionnez l'une des options suivantes :

Console

Pour supprimer une règle d'extension de VM zonale limitée au projet dans 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. Sélectionnez la stratégie que vous souhaitez supprimer.
3. Cliquez sur Supprimer.
4. Dans la boîte de dialogue de confirmation, cliquez sur Supprimer.

gcloud

Utilisez la commande gcloud compute zone-vm-extension-policies delete pour supprimer une règle d'extension de VM zonale existante au niveau du projet :

gcloud compute zone-vm-extension-policies delete 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 supprimer.
• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : zone Google Cloud où se trouve la stratégie.

REST

Pour supprimer une règle d'extension zonale limitée au projet, envoyez une requête DELETE à la méthode zoneVmExtensionPolicies.delete.

DELETE 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 supprimer.
• PROJECT_ID : ID de votre projet Google Cloud .
• ZONE : zone Google Cloud où se trouve la stratégie.

Étapes suivantes

• Pour inspecter la progression du déploiement et l'état de l'extension, consultez Afficher les détails et l'état d'une extension de VM.
• 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 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 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.