Gestire le estensioni VM utilizzando le relative policy

Il gestore di estensioni VM utilizza le policy di estensione per gestire le estensioni VM su larga scala. Per saperne di più, consulta Informazioni sul gestore di estensioni VM. Questo documento descrive come aggiornare ed eliminare le policy delle estensioni VM globali e di zona a livello di progetto o di cartella e organizzazione (disponibili in Anteprima). Per visualizzare le policy di estensione, le estensioni e le versioni delle VM e gli stati delle estensioni di runtime sulle istanze VM, consulta Visualizza i dettagli e lo stato delle estensioni VM. Per diagnosticare i problemi di installazione o runtime, consulta Risolvi i problemi relativi alle estensioni VM.

Limitazioni della gestione delle policy

Puoi aggiornare ed eliminare le policy delle estensioni VM con ambito cartella e organizzazione solo utilizzando Google Cloud CLI o l'API REST di Compute Engine. Non puoi gestire le policy con ambito cartella o organizzazione nella consoleGoogle Cloud .

Modifica le estensioni aggiornando una policy di estensione VM

Quando aggiorni una policy, il gestore di estensioni VM implementa le modifiche in tutte le VM applicabili, in genere entro un minuto. Se modifichi le etichette di inclusione, le estensioni potrebbero essere installate su nuove VM o disinstallate da VM esistenti in base alla corrispondenza con le etichette aggiornate.

Modifica le estensioni VM in tutte le zone di un'organizzazione

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per aggiornare una policy di estensione con ambito a livello di organizzazione, chiedi all'amministratore di concederti il ruolo IAM Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) sulla tua organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.orgVmExtensionPolicies.update necessaria per aggiornare una policy delle estensioni con ambito a livello di organizzazione.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per aggiornare una policy di estensione globale con ambito a livello di organizzazione, seleziona una delle seguenti opzioni:

gcloud

Utilizza il comando gcloud preview compute global-vm-extension-policies update con il flag --organization per modificare una policy delle estensioni VM globale esistente con ambito a livello di organizzazione. Quando aggiorni una policy utilizzando gcloud, la richiesta agisce come una sostituzione completa. Tutti i campi facoltativi omessi vengono ripristinati ai valori predefiniti anziché mantenere i valori esistenti della policy modificata.

Per aggiornare una policy di estensione VM globale con ambito a livello di organizzazione, esegui il seguente comando:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• ORGANIZATION_ID: il tuo ID organizzazione Google Cloud .
• DESCRIPTION: una descrizione facoltativa della policy.
• EXTENSION_NAME_1,EXTENSION_NAME_2: un elenco separato da virgole di estensioni da aggiungere alla policy. Devi specificare almeno un'estensione. Puoi specificare una delle seguenti estensioni supportate:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è la versione dell'estensione. Se non specifichi una versione per un'estensione, il gestore di estensioni VM utilizza l'ultima versione disponibile ed esegue l'upgrade automatico quando diventano disponibili nuove versioni.
  Nota: per ops-agent, il gestore di estensioni VM supporta l'installazione della versione 2.58.0 o di versioni successive. Per google-cloud-sap-extension e google-cloud-workload-extension, il gestore di estensioni VM supporta solo l'ultima versione.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è il percorso del file di configurazione per quell'estensione. Questo file si trova sulla VM in cui esegui il comando gcloud, non sulla VM in cui installi l'estensione.

  In alternativa, per fornire la configurazione come stringa incorporata, utilizza il flag --config anziché --config-from-file, ad esempio EXTENSION_NAME_1="CONFIG_1". Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.

• KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM in tutti i progetti e le zone discendenti dell'organizzazione.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.
• ROLLOUT_PLAN: specifica slow_rollout o fast_rollout. Se devi utilizzare un piano di rilascio personalizzato, specifica il flag --rollout-custom-plan anziché --rollout-predefined-plan utilizzando il seguente formato:

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

  Sostituisci quanto segue:

  • ORGANIZATION_ID: l'organizzazione in cui è definito il piano di rilascio.
  • ROLLOUT_PLAN_NAME: il nome del piano di rilascio personalizzato che hai definito.

  Se non specifichi un flag del piano di rilascio, il gestore di estensioni VM utilizza slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR: specifica il comportamento quando il gestore di estensioni VM rileva un conflitto tra una policy di zona e una policy globale. Puoi specificare uno dei seguenti comportamenti in caso di conflitto:
  • "" (stringa vuota): la policy globale non sovrascrive le policy di zona in conflitto con lo stesso nome. Questo comportamento in caso di conflitto è quello predefinito.
  • overwrite: la policy globale sovrascrive qualsiasi policy di zona con lo stesso nome, quindi gestisce i rollout delle policy nella zona.

  Per saperne di più, consulta il flag --rollout-conflict-behavior.

• RETRY_UUID: un UUID che identifica un tentativo di nuovo invio per l'implementazione di un aggiornamento della policy. Questo UUID ti consente di riprovare un aggiornamento senza modifiche. Se imposti questo flag e la policy viene modificata, si verifica un errore. Per saperne di più, consulta Riprova un'implementazione.

Esempio: aggiorna una policy globale con ambito a livello di organizzazione

Il seguente comando aggiorna la policy prod-frontend-policy nell'organizzazione 123456789 per aggiungere l'estensione google-cloud-workload-extension e sbloccare ops-agent in modo che monitori l'ultima versione utilizzando un piano di rilascio rapido:

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

Per aggiornare una policy di estensione globale con ambito a livello di organizzazione, invia una richiesta PATCH al metodo organizationGlobalVmExtensionPolicies.update. Quando aggiorni una policy utilizzando REST, devi fornire solo i campi che vuoi aggiornare. I campi omessi mantengono i valori esistenti.

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"
  }
}
}

Sostituisci quanto segue:

• ORGANIZATION_ID: il tuo ID organizzazione Google Cloud .
• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• DESCRIPTION: una descrizione della policy di estensione della VM.
• EXTENSION_NAME: il nome dell'estensione da aggiornare, utilizzato come chiave nella mappa extensionPolicies. Per aggiornare più estensioni, includi più voci nella mappa extensionPolicies.
• EXTENSION_NAME_VERSION: la versione dell'estensione VM.
• EXTENSION_NAME_CONFIG: le impostazioni di configurazione per l'estensione VM, come stringa incorporata.
• KEY_1:VALUE_1, KEY_2:VALUE_2: coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Per specificare più selettori, includi più oggetti nell'array instanceSelectors, ciascuno con un campo labelSelector. In questo caso, gestore di estensioni VM ha come target le VM che corrispondono a qualsiasi selettore fornito (OR logico). Se ometti instanceSelectors, la policy ha come target tutte le VM in tutti i progetti e le zone discendenti dell'organizzazione.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.
• ROLLOUT_CONFLICT_BEHAVIOR: specifica il comportamento quando il gestore di estensioni VM rileva un conflitto tra una policy di zona e una policy globale. Puoi specificare uno dei seguenti comportamenti in caso di conflitto:
  • "" (stringa vuota): la policy globale non sovrascrive le policy di zona in conflitto con lo stesso nome. Questo comportamento in caso di conflitto è quello predefinito.
  • overwrite: la policy globale sovrascrive qualsiasi policy di zona con lo stesso nome, quindi gestisce i rollout delle policy nella zona.

  Per saperne di più, consulta il flag --rollout-conflict-behavior.

• ROLLOUT_PLAN_NAME: il nome del piano di rilascio personalizzato che hai definito. Per utilizzare un piano di rilascio predefinito, sostituisci il campo name con predefinedRolloutPlan e specifica uno dei seguenti valori:
  • SLOW_ROLLOUT: implementa la policy nell'arco di cinque giorni. Questo piano predefinito è il piano di rilascio predefinito se non ne specifichi uno.
  • FAST_ROLLOUT: implementa immediatamente la policy in tutte le zone.
• RETRY_UUID: un UUID che identifica un tentativo di nuovo invio per l'implementazione di un aggiornamento della policy.

Modifica le estensioni VM in tutte le zone di una cartella

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per aggiornare una policy delle estensioni con ambito cartella, chiedi all'amministratore di concederti il ruolo IAM Amministratore delle policy delle estensioni delle VM di Compute a livello di cartella (roles/compute.folderVmExtensionPolicyAdmin) per la tua cartella. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.folderVmExtensionPolicies.update, necessaria per aggiornare una policy delle estensioni con ambito cartella.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per aggiornare una policy di estensione globale con ambito cartella, seleziona una delle seguenti opzioni:

gcloud

Utilizza il comando gcloud preview compute global-vm-extension-policies update con il flag --folder per modificare una policy delle estensioni VM globali con ambito cartella esistente. Quando aggiorni una policy utilizzando gcloud, la richiesta agisce come una sostituzione completa. Tutti i campi facoltativi omessi vengono ripristinati ai valori predefiniti anziché mantenere i valori esistenti della policy modificata.

Per aggiornare una policy di estensione VM globale con ambito cartella, esegui il seguente comando:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• FOLDER_ID: il tuo ID cartella Google Cloud .
• DESCRIPTION: una descrizione facoltativa della policy.
• EXTENSION_NAME_1,EXTENSION_NAME_2: un elenco separato da virgole di estensioni da aggiungere alla policy. Devi specificare almeno un'estensione. Puoi specificare una delle seguenti estensioni supportate:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è la versione dell'estensione. Se non specifichi una versione per un'estensione, il gestore di estensioni VM utilizza l'ultima versione disponibile ed esegue l'upgrade automatico quando diventano disponibili nuove versioni.
  Nota: per ops-agent, il gestore di estensioni VM supporta l'installazione della versione 2.58.0 o di versioni successive. Per google-cloud-sap-extension e google-cloud-workload-extension, il gestore di estensioni VM supporta solo l'ultima versione.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è il percorso del file di configurazione per quell'estensione. Questo file si trova sulla VM in cui esegui il comando gcloud, non sulla VM in cui installi l'estensione.

  In alternativa, per fornire la configurazione come stringa incorporata, utilizza il flag --config anziché --config-from-file, ad esempio EXTENSION_NAME_1="CONFIG_1". Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.

• KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM in tutti i progetti e le zone discendenti all'interno della cartella.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.
• ROLLOUT_PLAN: specifica slow_rollout o fast_rollout. Se devi utilizzare un piano di rilascio personalizzato, specifica il flag --rollout-custom-plan anziché --rollout-predefined-plan utilizzando il seguente formato:

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

  Sostituisci quanto segue:

  • FOLDER_ID: la cartella in cui è definito il piano di rilascio.
  • ROLLOUT_PLAN_NAME: il nome del piano di rilascio personalizzato che hai definito.

  Se non specifichi un flag del piano di rilascio, il gestore di estensioni VM utilizza slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR: specifica il comportamento quando il gestore di estensioni VM rileva un conflitto tra una policy di zona e una policy globale. Puoi specificare uno dei seguenti comportamenti in caso di conflitto:
  • "" (stringa vuota): la policy globale non sovrascrive le policy di zona in conflitto con lo stesso nome. Questo comportamento in caso di conflitto è quello predefinito.
  • overwrite: la policy globale sovrascrive qualsiasi policy di zona con lo stesso nome, quindi gestisce i rollout delle policy nella zona.

  Per saperne di più, consulta il flag --rollout-conflict-behavior.

• RETRY_UUID: un UUID che identifica un tentativo di nuovo invio per l'implementazione di un aggiornamento della policy. Questo UUID ti consente di riprovare un aggiornamento senza modifiche. Se imposti questo flag e la policy viene modificata, si verifica un errore. Per saperne di più, consulta Riprova un'implementazione.

REST

Per aggiornare una policy di estensione globale con ambito cartella, invia una richiesta PATCH al metodo folderGlobalVmExtensionPolicies.update. Quando aggiorni una policy utilizzando REST, devi fornire solo i campi che vuoi aggiornare. I campi omessi mantengono i valori esistenti.

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"
  }
}
}

Sostituisci quanto segue:

• FOLDER_ID: il tuo ID cartella Google Cloud .
• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• DESCRIPTION: una descrizione della policy di estensione della VM.
• EXTENSION_NAME: il nome dell'estensione da aggiornare, utilizzato come chiave nella mappa extensionPolicies. Per aggiornare più estensioni, includi più voci nella mappa extensionPolicies.
• EXTENSION_NAME_VERSION: la versione dell'estensione VM.
• EXTENSION_NAME_CONFIG: le impostazioni di configurazione per l'estensione VM, come stringa incorporata.
• KEY_1:VALUE_1, KEY_2:VALUE_2: coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Per specificare più selettori, includi più oggetti nell'array instanceSelectors, ciascuno con un campo labelSelector. In questo caso, gestore di estensioni VM ha come target le VM che corrispondono a qualsiasi selettore fornito (OR logico). Se ometti instanceSelectors, la policy ha come target tutte le VM in tutti i progetti e le zone discendenti all'interno della cartella.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.
• ROLLOUT_CONFLICT_BEHAVIOR: specifica il comportamento quando il gestore di estensioni VM rileva un conflitto tra una policy di zona e una policy globale. Puoi specificare uno dei seguenti comportamenti in caso di conflitto:
  • "" (stringa vuota): la policy globale non sovrascrive le policy di zona in conflitto con lo stesso nome. Questo comportamento in caso di conflitto è quello predefinito.
  • overwrite: la policy globale sovrascrive qualsiasi policy di zona con lo stesso nome, quindi gestisce i rollout delle policy nella zona.

  Per saperne di più, consulta il flag --rollout-conflict-behavior.

• ROLLOUT_PLAN_NAME: il nome del piano di rilascio personalizzato che hai definito. Per utilizzare un piano di rilascio predefinito, sostituisci il campo name con predefinedRolloutPlan e specifica uno dei seguenti valori:
  • SLOW_ROLLOUT: implementa la policy nell'arco di cinque giorni. Questo piano predefinito è il piano di rilascio predefinito se non ne specifichi uno.
  • FAST_ROLLOUT: implementa immediatamente la policy in tutte le zone.
• RETRY_UUID: un UUID che identifica un tentativo di nuovo invio per l'implementazione di un aggiornamento della policy.

Modifica le estensioni VM in tutte le zone di un progetto

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per aggiornare una policy di estensione con ambito a livello di progetto, chiedi all'amministratore di concederti il ruolo IAM Amministratore delle policy di estensione delle VM di Compute (roles/compute.vmExtensionPolicyAdmin) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.vmExtensionPolicies.update, necessaria per aggiornare una policy di estensione con ambito a livello di progetto.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per aggiornare una policy di estensione globale con ambito a livello di progetto, seleziona una delle seguenti opzioni:

Console

Per aggiornare una policy di estensione VM globale con ambito di progetto nella console Google Cloud , completa i seguenti passaggi:

1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

   Vai a Policy di estensione VM

2. Fai clic su Policy globali e poi seleziona la policy da modificare.
3. Fai clic su Modifica.
4. Nel campo Priority (Priorità), specifica un numero di priorità per risolvere i conflitti tra le policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000.
5. Nella sezione Gestisci estensioni, segui questi passaggi:
   • Per aggiungere altre estensioni, fai clic su Aggiungi estensione e seleziona l'estensione e la versione.
   • Per eliminare un'estensione gestita da questa policy, fai clic sul pulsante Elimina accanto al nome dell'estensione.
6. Se vuoi applicare etichette, aggiungile per le VM di destinazione nella sezione Istanze VM di destinazione.
7. Fai clic su Salva.

Nota: la console Google Cloud non supporta la modifica di un'implementazione. Per modificare un'implementazione, utilizza gcloud CLI o l'API REST.

gcloud

Utilizza il comando gcloud compute global-vm-extension-policies update per modificare una policy di estensione VM globale esistente con ambito a livello di progetto. Quando aggiorni una policy utilizzando gcloud, la richiesta agisce come una sostituzione completa. Tutti i campi facoltativi omessi vengono ripristinati ai valori predefiniti anziché mantenere i valori esistenti della policy modificata.

Per aggiornare una policy di estensione VM globale con ambito a livello di progetto, esegui il seguente comando:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• PROJECT_ID: il tuo ID progetto Google Cloud .
• DESCRIPTION: una descrizione facoltativa della policy.
• EXTENSION_NAME_1,EXTENSION_NAME_2: un elenco separato da virgole di estensioni da aggiungere alla policy. Devi specificare almeno un'estensione. Puoi specificare una delle seguenti estensioni supportate:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è la versione dell'estensione. Se non specifichi una versione per un'estensione, il gestore di estensioni VM utilizza l'ultima versione disponibile ed esegue l'upgrade automatico quando diventano disponibili nuove versioni.
  Nota: per ops-agent, il gestore di estensioni VM supporta l'installazione della versione 2.58.0 o di versioni successive. Per google-cloud-sap-extension e google-cloud-workload-extension, il gestore di estensioni VM supporta solo l'ultima versione.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è il percorso del file di configurazione per quell'estensione. Questo file si trova sulla VM in cui esegui il comando gcloud, non sulla VM in cui installi l'estensione.

  In alternativa, per fornire la configurazione come stringa incorporata, utilizza il flag --config anziché --config-from-file, ad esempio EXTENSION_NAME_1="CONFIG_1". Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.

• KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM in tutte le zone del progetto.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.
• ROLLOUT_PLAN: specifica slow_rollout o fast_rollout. Se devi utilizzare un piano di rilascio personalizzato, specifica il flag --rollout-custom-plan anziché --rollout-predefined-plan utilizzando il seguente formato:

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

  Sostituisci quanto segue:

  • PROJECT_NUMBER: il progetto in cui è definito il piano di rilascio.
  • ROLLOUT_PLAN_NAME: il nome del piano di rilascio personalizzato che hai definito.

  Se non specifichi un flag del piano di rilascio, il gestore di estensioni VM utilizza slow_rollout.

• ROLLOUT_CONFLICT_BEHAVIOR: specifica il comportamento quando il gestore di estensioni VM rileva un conflitto tra una policy di zona e una policy globale. Puoi specificare uno dei seguenti comportamenti in caso di conflitto:
  • "" (stringa vuota): la policy globale non sovrascrive le policy di zona in conflitto con lo stesso nome. Questo comportamento in caso di conflitto è quello predefinito.
  • overwrite: la policy globale sovrascrive qualsiasi policy di zona con lo stesso nome, quindi gestisce i rollout delle policy nella zona.

  Per saperne di più, consulta il flag --rollout-conflict-behavior.

• RETRY_UUID: un UUID che identifica un tentativo di nuovo invio per l'implementazione di un aggiornamento della policy. Questo UUID ti consente di riprovare un aggiornamento senza modifiche. Se imposti questo flag e la policy viene modificata, si verifica un errore. Per saperne di più, consulta Riprova un'implementazione.

REST

Per aggiornare una policy di estensione globale con ambito a livello di progetto, invia una richiesta PATCH al metodo globalVmExtensionPolicies.update. Quando aggiorni una policy utilizzando REST, devi fornire solo i campi che vuoi aggiornare. I campi omessi mantengono i valori esistenti.

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"
  }
}
}

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto Google Cloud .
• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• DESCRIPTION: una descrizione della policy di estensione della VM.
• EXTENSION_NAME: il nome dell'estensione da aggiornare, utilizzato come chiave nella mappa extensionPolicies. Per aggiornare più estensioni, includi più voci nella mappa extensionPolicies.
• EXTENSION_NAME_VERSION: la versione dell'estensione VM.
• EXTENSION_NAME_CONFIG: le impostazioni di configurazione per l'estensione VM, come stringa incorporata.
• KEY_1:VALUE_1, KEY_2:VALUE_2: coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Per specificare più selettori, includi più oggetti nell'array instanceSelectors, ciascuno con un campo labelSelector. In questo caso, gestore di estensioni VM ha come target le VM che corrispondono a qualsiasi selettore fornito (OR logico). Se ometti instanceSelectors, la policy ha come target tutte le VM in tutte le zone del progetto.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.
• ROLLOUT_CONFLICT_BEHAVIOR: specifica il comportamento quando il gestore di estensioni VM rileva un conflitto tra una policy di zona e una policy globale. Puoi specificare uno dei seguenti comportamenti in caso di conflitto:
  • "" (stringa vuota): la policy globale non sovrascrive le policy di zona in conflitto con lo stesso nome. Questo comportamento in caso di conflitto è quello predefinito.
  • overwrite: la policy globale sovrascrive qualsiasi policy di zona con lo stesso nome, quindi gestisce i rollout delle policy nella zona.

  Per saperne di più, consulta il flag --rollout-conflict-behavior.

• PROJECT_NUMBER: il progetto in cui è definito il piano di rilascio personalizzato.
• ROLLOUT_PLAN_NAME: il nome del piano di rilascio personalizzato che hai definito. Per utilizzare un piano di rilascio predefinito, sostituisci il campo name con predefinedRolloutPlan e specifica uno dei seguenti valori:
  • SLOW_ROLLOUT: implementa la policy nell'arco di cinque giorni. Questo piano predefinito è il piano di rilascio predefinito se non ne specifichi uno.
  • FAST_ROLLOUT: implementa immediatamente la policy in tutte le zone.
• RETRY_UUID: un UUID che identifica un tentativo di nuovo invio per l'implementazione di un aggiornamento della policy.

Modifica le estensioni VM in una zona di un'organizzazione

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per aggiornare una policy di estensione con ambito a livello di organizzazione, chiedi all'amministratore di concederti il ruolo IAM Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) sulla tua organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.orgVmExtensionPolicies.update, necessaria per aggiornare una policy delle estensioni con ambito a livello di organizzazione.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per aggiornare una policy di estensione a livello di zona con ambito a livello di organizzazione, seleziona una delle seguenti opzioni:

gcloud

Utilizza il comando gcloud preview compute zone-vm-extension-policies update con il flag --organization per modificare una policy delle estensioni delle VM a livello di zona esistente con ambito a livello di organizzazione. Quando aggiorni una policy utilizzando gcloud, la richiesta agisce come una sostituzione completa. I campi facoltativi omessi vengono ripristinati ai valori predefiniti anziché mantenere i valori esistenti della policy modificata.

Per aggiornare una policy di estensione VM a livello di zona con ambito a livello di organizzazione, esegui il seguente comando:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• ORGANIZATION_ID: il tuo ID organizzazione Google Cloud .
• ZONE: la zona Google Cloud in cui si applica la policy.
• DESCRIPTION: una descrizione facoltativa della policy.
• EXTENSION_NAME_1,EXTENSION_NAME_2: un elenco separato da virgole di estensioni da aggiungere alla policy. Devi specificare almeno un'estensione. Puoi specificare una delle seguenti estensioni supportate:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è la versione dell'estensione. Se non specifichi una versione per un'estensione, il gestore di estensioni VM utilizza l'ultima versione disponibile ed esegue l'upgrade automatico quando diventano disponibili nuove versioni.
  Nota: per ops-agent, il gestore di estensioni VM supporta l'installazione della versione 2.58.0 o di versioni successive. Per google-cloud-sap-extension e google-cloud-workload-extension, il gestore di estensioni VM supporta solo l'ultima versione.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è il percorso del file di configurazione per quell'estensione. Questo file si trova sulla VM in cui esegui il comando gcloud, non sulla VM in cui installi l'estensione.

  In alternativa, per fornire la configurazione come stringa incorporata, utilizza il flag --config anziché --config-from-file, ad esempio EXTENSION_NAME_1="CONFIG_1". Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.

• KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM nella zona specificata in tutti i progetti discendenti dell'organizzazione.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.

REST

Per aggiornare una policy di estensione a livello di zona con ambito a livello di organizzazione, invia una richiesta PATCH al metodo organizationZoneVmExtensionPolicies.update. Quando aggiorni una policy utilizzando REST, devi fornire solo i campi che vuoi aggiornare. I campi omessi mantengono i valori esistenti.

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
}

Sostituisci quanto segue:

• ORGANIZATION_ID: il tuo ID organizzazione Google Cloud .
• ZONE: la Google Cloud zona in cui si trova la policy di estensione della VM.
• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• DESCRIPTION: una descrizione della policy di estensione della VM.
• EXTENSION_NAME: il nome dell'estensione da aggiornare, utilizzato come chiave nella mappa extensionPolicies. Per aggiornare più estensioni, includi più voci nella mappa extensionPolicies.
• EXTENSION_NAME_VERSION: la versione dell'estensione VM.
• EXTENSION_NAME_CONFIG: le impostazioni di configurazione per l'estensione VM, come stringa incorporata.
• KEY_1:VALUE_1, KEY_2:VALUE_2: coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Per specificare più selettori, includi più oggetti nell'array instanceSelectors, ciascuno con un campo labelSelector. In questo caso, gestore di estensioni VM ha come target le VM che corrispondono a qualsiasi selettore fornito (OR logico). Se ometti instanceSelectors, la policy ha come target tutte le VM nella zona specificata in tutti i progetti discendenti dell'organizzazione.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.

Modifica le estensioni VM in una zona in una cartella

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per aggiornare una policy delle estensioni con ambito cartella, chiedi all'amministratore di concederti il ruolo IAM Amministratore delle policy delle estensioni delle VM di Compute a livello di cartella (roles/compute.folderVmExtensionPolicyAdmin) per la tua cartella. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.folderVmExtensionPolicies.update, necessaria per aggiornare una policy delle estensioni con ambito cartella.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per aggiornare una policy di estensione zonale con ambito a livello di cartella, seleziona una delle seguenti opzioni:

gcloud

Utilizza il comando gcloud preview compute zone-vm-extension-policies update con il flag --folder per modificare una policy di estensione delle VM a livello di zona con scope delle cartelle esistente. Quando aggiorni una policy utilizzando gcloud, la richiesta agisce come una sostituzione completa. I campi facoltativi omessi vengono ripristinati ai valori predefiniti anziché mantenere i valori esistenti della policy modificata.

Per aggiornare una policy di estensione VM a livello di zona con ambito cartella, esegui il seguente comando:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• FOLDER_ID: il tuo ID cartella Google Cloud .
• ZONE: la zona Google Cloud in cui si applica la policy.
• DESCRIPTION: una descrizione facoltativa della policy.
• EXTENSION_NAME_1,EXTENSION_NAME_2: un elenco separato da virgole di estensioni da aggiungere alla policy. Devi specificare almeno un'estensione. Puoi specificare una delle seguenti estensioni supportate:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è la versione dell'estensione. Se non specifichi una versione per un'estensione, il gestore di estensioni VM utilizza l'ultima versione disponibile ed esegue l'upgrade automatico quando diventano disponibili nuove versioni.
  Nota: per ops-agent, il gestore di estensioni VM supporta l'installazione della versione 2.58.0 o di versioni successive. Per google-cloud-sap-extension e google-cloud-workload-extension, il gestore di estensioni VM supporta solo l'ultima versione.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è il percorso del file di configurazione per quell'estensione. Questo file si trova sulla VM in cui esegui il comando gcloud, non sulla VM in cui installi l'estensione.

  In alternativa, per fornire la configurazione come stringa incorporata, utilizza il flag --config anziché --config-from-file, ad esempio EXTENSION_NAME_1="CONFIG_1". Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.

• KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM nella zona specificata in tutti i progetti discendenti all'interno della cartella.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.

REST

Per aggiornare una policy di estensione a livello di zona con scope delle cartelle, invia una richiesta PATCH al metodo folderZoneVmExtensionPolicies.update. Quando aggiorni una policy utilizzando REST, devi fornire solo i campi che vuoi aggiornare. I campi omessi mantengono i valori esistenti.

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
}

Sostituisci quanto segue:

• FOLDER_ID: il tuo ID cartella Google Cloud .
• ZONE: la Google Cloud zona in cui si trova la policy di estensione della VM.
• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• DESCRIPTION: una descrizione della policy di estensione della VM.
• EXTENSION_NAME: il nome dell'estensione da aggiornare, utilizzato come chiave nella mappa extensionPolicies. Per aggiornare più estensioni, includi più voci nella mappa extensionPolicies.
• EXTENSION_NAME_VERSION: la versione dell'estensione VM.
• EXTENSION_NAME_CONFIG: le impostazioni di configurazione per l'estensione VM, come stringa incorporata.
• KEY_1:VALUE_1, KEY_2:VALUE_2: coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Per specificare più selettori, includi più oggetti nell'array instanceSelectors, ciascuno con un campo labelSelector. In questo caso, gestore di estensioni VM ha come target le VM che corrispondono a qualsiasi selettore fornito (OR logico). Se ometti instanceSelectors, la policy ha come target tutte le VM nella zona specificata in tutti i progetti discendenti all'interno della cartella.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.

Modifica le estensioni VM in una zona di un progetto

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per aggiornare una policy di estensione con ambito a livello di progetto, chiedi all'amministratore di concederti il ruolo IAM Amministratore delle policy di estensione delle VM di Compute (roles/compute.vmExtensionPolicyAdmin) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.vmExtensionPolicies.update, necessaria per aggiornare una policy di estensione con ambito a livello di progetto.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per aggiornare una policy di estensione zonale con scope a livello di progetto, seleziona una delle seguenti opzioni:

Console

Per aggiornare una policy di estensione VM di zona con ambito a livello di progetto nella console Google Cloud , completa i seguenti passaggi:

1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

   Vai a Policy di estensione VM

2. Seleziona la policy che vuoi aggiornare.
3. Fai clic su Modifica.
4. Modifica la Descrizione, la Priorità, le Estensioni o le Istanze VM di destinazione.
5. Fai clic su Salva.

gcloud

Utilizza il comando gcloud compute zone-vm-extension-policies update per modificare una policy delle estensioni delle VM di zona esistente con ambito a livello di progetto. Quando aggiorni una policy utilizzando gcloud, la richiesta agisce come una sostituzione completa. I campi facoltativi omessi vengono ripristinati ai valori predefiniti anziché mantenere i valori esistenti della policy modificata.

Per aggiornare una policy di estensione VM a livello di zona con ambito di progetto, esegui questo comando:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• PROJECT_ID: il tuo ID progetto Google Cloud .
• ZONE: la zona Google Cloud in cui si applica la policy.
• DESCRIPTION: una descrizione facoltativa della policy.
• EXTENSION_NAME_1,EXTENSION_NAME_2: un elenco separato da virgole di estensioni da aggiungere alla policy. Devi specificare almeno un'estensione. Puoi specificare una delle seguenti estensioni supportate:
  • ops-agent
  • google-cloud-sap-extension
  • google-cloud-workload-extension
• EXTENSION_NAME_1=VERSION_1,EXTENSION_NAME_2=VERSION_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è la versione dell'estensione. Se non specifichi una versione per un'estensione, il gestore di estensioni VM utilizza l'ultima versione disponibile ed esegue l'upgrade automatico quando diventano disponibili nuove versioni.
  Nota: per ops-agent, il gestore di estensioni VM supporta l'installazione della versione 2.58.0 o di versioni successive. Per google-cloud-sap-extension e google-cloud-workload-extension, il gestore di estensioni VM supporta solo l'ultima versione.
• EXTENSION_NAME_1=CONFIG_FILE_PATH_1,EXTENSION_NAME_2=CONFIG_FILE_PATH_2: un elenco separato da virgole di coppie chiave-valore in cui la chiave è il nome dell'estensione e il valore è il percorso del file di configurazione per quell'estensione. Questo file si trova sulla VM in cui esegui il comando gcloud, non sulla VM in cui installi l'estensione.

  In alternativa, per fornire la configurazione come stringa incorporata, utilizza il flag --config anziché --config-from-file, ad esempio EXTENSION_NAME_1="CONFIG_1". Puoi utilizzare --config-from-file o --config, ma non entrambi nello stesso comando.

• KEY_1=VALUE_1: un elenco separato da virgole di coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Se specifichi --inclusion-labels più volte, la policy ha come target le VM che corrispondono a uno dei selettori forniti (OR logico). Se ometti questo flag, la policy ha come target tutte le VM nella zona specificata all'interno del progetto.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.

REST

Per aggiornare una policy di estensione a livello di zona con scope del progetto, invia una richiesta PATCH al metodo zoneVmExtensionPolicies.update. Quando aggiorni una policy utilizzando REST, devi fornire solo i campi che vuoi aggiornare. I campi omessi mantengono i valori esistenti.

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
}

Sostituisci quanto segue:

• PROJECT_ID: il tuo ID progetto Google Cloud .
• ZONE: la Google Cloud zona in cui si trova la policy di estensione della VM.
• POLICY_NAME: il nome della policy di estensione della VM da aggiornare.
• DESCRIPTION: una descrizione della policy di estensione della VM.
• EXTENSION_NAME: il nome dell'estensione da aggiornare, utilizzato come chiave nella mappa extensionPolicies. Per aggiornare più estensioni, includi più voci nella mappa extensionPolicies.
• EXTENSION_NAME_VERSION: la versione dell'estensione VM.
• EXTENSION_NAME_CONFIG: le impostazioni di configurazione per l'estensione VM, come stringa incorporata.
• KEY_1:VALUE_1, KEY_2:VALUE_2: coppie chiave-valore che definiscono le etichette di inclusione per un selettore. Le VM devono avere tutte le etichette specificate in un selettore per essere scelte come target. Per specificare più selettori, includi più oggetti nell'array instanceSelectors, ciascuno con un campo labelSelector. In questo caso, gestore di estensioni VM ha come target le VM che corrispondono a qualsiasi selettore fornito (OR logico). Se ometti instanceSelectors, la policy ha come target tutte le VM nella zona specificata all'interno del progetto.
• PRIORITY: un numero intero compreso tra 0 e 65535 che definisce la priorità della policy. I numeri più bassi indicano una priorità più alta. Il valore predefinito è 1000. Se più policy hanno la stessa priorità, il gestore di estensioni VM applica alle VM la policy aggiornata più di recente.

Disinstalla le estensioni eliminando una policy di estensione VM

Quando elimini una policy, gestore di estensioni VM disinstalla le estensioni da tutte le VM gestite da quella policy. Tuttavia, se un'altra policy attiva con priorità inferiore si applica a una VM e dichiara la stessa estensione, l'estensione rimane installata su quella VM in base alla policy con priorità inferiore.

Il gestore di estensioni VM rimuove le estensioni da tutte le VM accessibili entro un minuto dall'eliminazione della policy. Se una VM è inaccessibile perché l'agente guest è stato rimosso o la VM è stata eliminata, il gestore di estensioni VM salta l'eliminazione dell'estensione. Se una VM di questo tipo torna disponibile, il gestore di estensioni VM rimuove le estensioni in quel momento.

Disinstalla le estensioni VM in tutte le zone di un'organizzazione

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per eliminare una policy delle estensioni con ambito a livello di organizzazione, chiedi all'amministratore di concederti il ruolo IAM Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) sulla tua organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.orgVmExtensionPolicies.delete, necessaria per eliminare una policy di estensione con ambito a livello di organizzazione.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per eliminare una policy di estensione globale con ambito a livello di organizzazione, seleziona una delle seguenti opzioni:

gcloud

Utilizza il comando gcloud preview compute global-vm-extension-policies delete con il flag --organization per eliminare una policy delle estensioni VM globali esistente con ambito a livello di organizzazione:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi eliminare.
• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .
• ROLLOUT_PLAN: specifica slow_rollout o fast_rollout. Se devi utilizzare un piano di rilascio personalizzato, specifica il flag --rollout-custom-plan anziché --rollout-predefined-plan utilizzando il seguente formato:

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

  Sostituisci quanto segue:

  • ORGANIZATION_ID: l'organizzazione in cui è definito il piano di rilascio.
  • ROLLOUT_PLAN_NAME: il nome del piano di rilascio personalizzato che hai definito.

  Se non specifichi un flag del piano di rilascio, il gestore di estensioni VM utilizza slow_rollout.

• RETRY_UUID_\ Imposta questo campo solo quando riprovi una richiesta di eliminazione per una policy esistente che si trova nello stato DELETING. Se imposti questo campo quando la policy non è nello stato DELETING, viene generato un errore. Per saperne di più, consulta Riprova un'implementazione.

REST

Per eliminare una policy di estensione globale con ambito a livello di organizzazione, invia una richiesta POST al metodo 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"
}

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy delle estensioni VM che vuoi eliminare.
• ORGANIZATION_ID: il tuo ID organizzazione Google Cloud .
• ROLLOUT_PLAN: specifica SLOW_ROLLOUT o FAST_ROLLOUT. Per utilizzare un piano di rilascio personalizzato, sostituisci predefinedRolloutPlan con "name": "organizations/ORGANIZATION_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID_\ Imposta questo campo solo quando riprovi una richiesta di eliminazione per una policy esistente che si trova nello stato DELETING. Se imposti questo campo quando la policy non è nello stato DELETING, viene generato un errore. Per saperne di più, consulta Riprova un'implementazione.

Disinstalla le estensioni VM in tutte le zone di una cartella

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per eliminare una policy di estensione con ambito cartella, chiedi all'amministratore di concederti il ruolo IAM Amministratore delle policy di estensione delle VM di Compute a livello di cartella (roles/compute.folderVmExtensionPolicyAdmin) nella cartella. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.folderVmExtensionPolicies.delete, necessaria per eliminare una policy delle estensioni con ambito cartella.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per eliminare una policy di estensione globale con ambito a livello di cartella, seleziona una delle seguenti opzioni:

gcloud

Utilizza il comando gcloud preview compute global-vm-extension-policies delete con il flag --folder per eliminare una policy di estensione VM globale esistente con ambito cartella:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi eliminare.
• FOLDER_ID: l'ID della cartella Google Cloud .
• ROLLOUT_PLAN: specifica slow_rollout o fast_rollout. Se devi utilizzare un piano di rilascio personalizzato, specifica il flag --rollout-custom-plan anziché --rollout-predefined-plan utilizzando il seguente formato:

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

  Sostituisci quanto segue:

  • FOLDER_ID: la cartella in cui è definito il piano di rilascio.
  • ROLLOUT_PLAN_NAME: il nome del piano di rilascio personalizzato che hai definito.

  Se non specifichi un flag del piano di rilascio, il gestore di estensioni VM utilizza slow_rollout.

• RETRY_UUID_\ Imposta questo campo solo quando riprovi una richiesta di eliminazione per una policy esistente che si trova nello stato DELETING. Se imposti questo campo quando la policy non è nello stato DELETING, viene generato un errore. Per saperne di più, consulta Riprova un'implementazione.

REST

Per eliminare una policy di estensione globale con ambito cartella, invia una richiesta POST al metodo 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"
}

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy delle estensioni VM che vuoi eliminare.
• FOLDER_ID: il tuo ID cartella Google Cloud .
• ROLLOUT_PLAN: specifica SLOW_ROLLOUT o FAST_ROLLOUT. Per utilizzare un piano di rilascio personalizzato, sostituisci predefinedRolloutPlan con "name": "folders/FOLDER_ID/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID_\ Imposta questo campo solo quando riprovi una richiesta di eliminazione per una policy esistente che si trova nello stato DELETING. Se questo campo viene impostato quando la policy non è nello stato DELETING, viene generato un errore. Per saperne di più, consulta Riprova un'implementazione.

Disinstalla le estensioni VM in tutte le zone di un progetto

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per eliminare una policy di estensione con ambito a livello di progetto, chiedi all'amministratore di concederti il ruolo IAM Compute VM extension policies admin (roles/compute.vmExtensionPolicyAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.vmExtensionPolicies.delete necessaria per eliminare una policy di estensione con ambito a livello di progetto.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per eliminare una policy di estensione globale con ambito a livello di progetto, seleziona una delle seguenti opzioni:

Console

Per eliminare una policy di estensione VM globale con ambito di progetto nella console Google Cloud , completa i seguenti passaggi:

1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

   Vai a Policy di estensione VM

2. Fai clic su Policy globali, quindi seleziona la policy che vuoi eliminare.
3. Fai clic su Elimina.
4. Nella finestra di dialogo di conferma, inserisci il nome della policy e fai clic su Elimina.

gcloud

Utilizza il comando gcloud compute global-vm-extension-policies delete per eliminare una policy di estensione VM globale esistente con ambito a livello di progetto:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi eliminare.
• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• ROLLOUT_PLAN: specifica slow_rollout o fast_rollout. Se devi utilizzare un piano di rilascio personalizzato, specifica il flag --rollout-custom-plan anziché --rollout-predefined-plan utilizzando il seguente formato:

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

  Sostituisci quanto segue:

  • PROJECT_NUMBER: il progetto in cui è definito il piano di rilascio.
  • ROLLOUT_PLAN_NAME: il nome del piano di rilascio personalizzato che hai definito.

  Se non specifichi un flag del piano di rilascio, il gestore di estensioni VM utilizza slow_rollout.

• RETRY_UUID_\ Imposta questo campo solo quando riprovi una richiesta di eliminazione per una policy esistente che si trova nello stato DELETING. Se imposti questo campo quando la policy non è nello stato DELETING, viene generato un errore. Per saperne di più, consulta Riprova un'implementazione.

REST

Per eliminare una policy di estensione globale con scope a livello di progetto, invia una richiesta POST al metodo globalVmExtensionPolicies.delete.

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

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy delle estensioni VM che vuoi eliminare.
• PROJECT_ID: il tuo ID progetto Google Cloud .
• ROLLOUT_PLAN: specifica SLOW_ROLLOUT o FAST_ROLLOUT. Per utilizzare un piano di rilascio personalizzato, sostituisci predefinedRolloutPlan con "name": "projects/PROJECT_NUMBER/locations/global/rolloutPlans/ROLLOUT_PLAN_NAME".
• RETRY_UUID_\ Imposta questo campo solo quando riprovi una richiesta di eliminazione per una policy esistente che si trova nello stato DELETING. Se imposti questo campo quando la policy non è nello stato DELETING, viene generato un errore. Per saperne di più, consulta Riprova un'implementazione.

Disinstalla le estensioni VM in una zona di un'organizzazione

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per eliminare una policy delle estensioni con ambito a livello di organizzazione, chiedi all'amministratore di concederti il ruolo IAM Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) sulla tua organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.orgVmExtensionPolicies.delete, necessaria per eliminare una policy di estensione con ambito a livello di organizzazione.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per eliminare una policy di estensione a livello di zona con ambito a livello di organizzazione, seleziona una delle seguenti opzioni:

gcloud

Utilizza il comando gcloud preview compute zone-vm-extension-policies delete con il flag --organization per eliminare una policy di estensione VM di zona esistente con ambito a livello di organizzazione:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi eliminare.
• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .
• ZONE: la zona Google Cloud in cui si trova la policy.

REST

Per eliminare una policy di estensione a livello di zona con ambito dell'organizzazione, invia una richiesta DELETE al metodo organizationZoneVmExtensionPolicies.delete.

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi eliminare.
• ORGANIZATION_ID: il tuo ID organizzazione Google Cloud .
• ZONE: la zona Google Cloud in cui si trova la policy.

Disinstalla le estensioni VM in una zona di una cartella

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per eliminare una policy di estensione con ambito cartella, chiedi all'amministratore di concederti il ruolo IAM Amministratore delle policy di estensione delle VM di Compute a livello di cartella (roles/compute.folderVmExtensionPolicyAdmin) nella cartella. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.folderVmExtensionPolicies.delete, necessaria per eliminare una policy delle estensioni con ambito cartella.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per eliminare una policy di estensione a livello di zona con ambito cartella, seleziona una delle seguenti opzioni:

gcloud

Utilizza il comando gcloud preview compute zone-vm-extension-policies delete con il flag --folder per eliminare una policy di estensione VM a livello di zona con ambito cartella esistente:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi eliminare.
• FOLDER_ID: l'ID della cartella Google Cloud .
• ZONE: la zona Google Cloud in cui si trova la policy.

REST

Per eliminare una policy di estensione a livello di zona con ambito cartella, invia una richiesta DELETE al metodo folderZoneVmExtensionPolicies.delete.

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi eliminare.
• FOLDER_ID: il tuo ID cartella Google Cloud .
• ZONE: la zona Google Cloud in cui si trova la policy.

Disinstalla le estensioni VM in una zona di un progetto

Autorizzazioni IAM obbligatorie

Per ottenere l'autorizzazione necessaria per eliminare una policy di estensione con ambito a livello di progetto, chiedi all'amministratore di concederti il ruolo IAM Compute VM extension policies admin (roles/compute.vmExtensionPolicyAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione compute.vmExtensionPolicies.delete necessaria per eliminare una policy di estensione con ambito a livello di progetto.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Per eliminare una policy di estensione a livello di zona con ambito di progetto, seleziona una delle seguenti opzioni:

Console

Per eliminare una policy delle estensioni delle VM di zona con ambito di progetto nella console Google Cloud , completa i seguenti passaggi:

1. Nella console Google Cloud , vai alla pagina Policy delle estensioni VM.

   Vai a Policy di estensione VM

2. Seleziona la policy che vuoi eliminare.
3. Fai clic su Elimina.
4. Nella finestra di dialogo di conferma, fai clic su Elimina.

gcloud

Utilizza il comando gcloud compute zone-vm-extension-policies delete per eliminare una policy di estensione VM a livello di zona esistente con ambito a livello di progetto:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi eliminare.
• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• ZONE: la zona Google Cloud in cui si trova la policy.

REST

Per eliminare una policy di estensione a livello di zona con scope del progetto, invia una richiesta DELETE al metodo zoneVmExtensionPolicies.delete.

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi eliminare.
• PROJECT_ID: il tuo ID progetto Google Cloud .
• ZONE: la zona Google Cloud in cui si trova la policy.

Passaggi successivi

• Per esaminare l'avanzamento dell'implementazione e lo stato di integrità delle estensioni, consulta Visualizza i dettagli e lo stato delle estensioni VM.
• Per diagnosticare i rollout non riusciti, controllare i processi guest in esecuzione o ispezionare i log di debug dell'agente guest, consulta Risolvi i problemi relativi alle estensioni VM.
• Per creare dashboard di Cloud Monitoring e configurare avvisi per l'integrità dell'agente, l'utilizzo della CPU e della memoria utilizzata, consulta Monitora le estensioni VM.
• Per eseguire query sugli eventi di applicazione storici e controllare i record di installazione o arresto anomalo in Cloud Logging, consulta Visualizza i log delle estensioni VM.