Visualizza i dettagli e lo stato dell'estensione VM

Puoi installare le estensioni VM sulle istanze di macchine virtuali (VM) di Compute Engine creando policy di estensione globali o a livello di zona nell'organizzazione, nella cartella o nel progetto. Una singola policy può installare più estensioni su una singola VM e più policy possono essere applicate alla stessa VM.

Questo documento descrive come utilizzare i metodi di sola lettura get e list nella gerarchia delle risorse Google Cloud per eseguire le seguenti attività:

• Visualizza le policy di estensione nella gerarchia delle risorse. Elenca le policy di estensione delle VM globali o di zona per visualizzare i dettagli delle policy e lo stato di implementazione nell'organizzazione, nella cartella o nel progetto.
• Visualizza le estensioni e le versioni delle VM. Elenca le estensioni VM supportate dal gestore di estensioni VM o visualizza i dettagli delle estensioni, inclusi i numeri di versione e i livelli di assistenza, in tutte le zone o in una zona specifica della tua organizzazione, cartella o progetto.
• Visualizza lo stato delle estensioni installate su ogni VM. Elenca tutte le estensioni VM installate e i relativi stati di runtime su un'istanza quando una policy installa più estensioni su una VM oppure visualizza la configurazione effettiva finale e la policy di governance (policyId) quando più policy si applicano alla stessa VM.
• Risolvi i problemi relativi alle estensioni su un'istanza. Visualizza l'avanzamento dell'installazione, lo stato di integrità del runtime e i messaggi di diagnostica quando viene installata un'estensione imprevista o un'estensione non riesce su un'istanza VM.

Prima di iniziare

Prima di visualizzare le policy di estensione VM, recuperare i dettagli delle estensioni VM o esaminare gli stati delle estensioni sulle istanze VM, completa i seguenti prerequisiti:

• Leggi Informazioni sul gestore di estensioni VM per capire in che modo le policy di estensione gestiscono i plug-in degli agenti guest nel tuo parco risorse di VM.
• Se non hai ancora eseguito il deployment delle estensioni nelle tue istanze, crea prima una policy. Per saperne di più, consulta Installa le estensioni VM creando policy di estensione.
• Assicurati di disporre delle autorizzazioni di Identity and Access Management necessarie per visualizzare le policy delle estensioni, recuperare i dettagli delle estensioni e ispezionare gli stati delle estensioni delle istanze.

Limitazioni alla visualizzazione di norme ed estensioni

Quando visualizzi le policy di estensione VM, i dettagli delle estensioni e gli stati delle istanze, tieni presente i seguenti vincoli operativi:

• Puoi visualizzare le policy delle estensioni VM con ambito a livello di cartella e di organizzazione solo utilizzando Google Cloud CLI o l'API REST di Compute Engine.
• Puoi recuperare i dettagli delle estensioni VM e gli stati delle estensioni delle istanze solo utilizzando Google Cloud CLI o l'API REST di Compute Engine. Non puoi visualizzare i dettagli delle estensioni VM o gli stati delle estensioni per istanza nella consoleGoogle Cloud .
• Le API di stato delle estensioni delle istanze (getVmExtensionState e listVmExtensionStates) segnalano lo stato di runtime solo per le estensioni installate e gestite dalle policy del gestore di estensioni VM. Queste API non segnalano lo stato degli agenti autonomi installati manualmente al di fuori del gestore di estensioni VM.

Visualizza le policy di estensione

Puoi elencare le policy delle estensioni VM o esaminare i dettagli di configurazione di una policy specifica a livello di organizzazione, cartella o progetto.

Visualizza le policy di estensione globali 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.

Puoi elencare tutte le policy di estensione VM globali della tua organizzazione o ispezionare una policy globale specifica con ambito a livello di organizzazione per controllare i rollout delle estensioni a livello di parco risorse.

Autorizzazioni IAM obbligatorie

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

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le policy delle estensioni con ambito a livello di organizzazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le policy delle estensioni con ambito a livello di organizzazione sono necessarie le seguenti autorizzazioni:

• Elenca le policy di estensione: compute.orgVmExtensionPolicies.list
• Visualizza i dettagli di una policy di estensione: compute.orgVmExtensionPolicies.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le policy di estensione globali in un'organizzazione, seleziona una delle seguenti opzioni:

gcloud

Per visualizzare tutte le policy di estensione globali in un'organizzazione, esegui il comando gcloud preview compute global-vm-extension-policies list con il flag --organization:

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

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .
• PAGE_SIZE: il numero massimo di risultati da restituire per pagina.

Per visualizzare i dettagli di una specifica policy delle estensioni globali in un'organizzazione, esegui il comando gcloud preview compute global-vm-extension-policies describe con il flag --organization:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy delle estensioni VM che vuoi visualizzare.
• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .

REST

Per visualizzare tutte le policy di estensione globali di un'organizzazione, invia una richiesta GET al metodo organizationGlobalVmExtensionPolicies.list:

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

Per visualizzare i dettagli di una policy di estensione globale specifica in un'organizzazione, invia una richiesta GET al metodo organizationGlobalVmExtensionPolicies.get:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi visualizzare.
• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .

Visualizza le policy di estensione globali 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.

Puoi elencare tutte le policy di estensione VM globali in una cartella o ispezionare una policy globale specifica con ambito cartella per verificare quali estensioni si applicano ai progetti in quella cartella.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare le policy di estensione con ambito cartella, chiedi all'amministratore di concederti il ruolo IAM Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) o Folder level Compute VM extension policies admin (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 le autorizzazioni necessarie per visualizzare le policy di estensione con ambito cartella. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le policy delle estensioni con ambito cartella sono necessarie le seguenti autorizzazioni:

• Elenca le policy di estensione: compute.folderVmExtensionPolicies.list
• Visualizza i dettagli di una policy di estensione: compute.folderVmExtensionPolicies.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le policy di estensione globali in una cartella, seleziona una delle seguenti opzioni:

gcloud

Per visualizzare tutte le policy di estensione globali in una cartella, esegui il comando gcloud preview compute global-vm-extension-policies list con il flag --folder:

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

Sostituisci quanto segue:

• FOLDER_ID: l'ID della cartella Google Cloud .
• PAGE_SIZE: il numero massimo di risultati da restituire per pagina.

Per visualizzare i dettagli di una specifica policy delle estensioni globali in una cartella, esegui il comando gcloud preview compute global-vm-extension-policies describe con il flag --folder:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy delle estensioni VM che vuoi visualizzare.
• FOLDER_ID: l'ID della cartella Google Cloud .

REST

Per visualizzare tutte le policy di estensione globali in una cartella, invia una richiesta GET al metodo folderGlobalVmExtensionPolicies.list:

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

Per visualizzare i dettagli di una policy di estensione globale specifica in una cartella, invia una richiesta GET al metodo folderGlobalVmExtensionPolicies.get:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi visualizzare.
• FOLDER_ID: l'ID della cartella Google Cloud .

Visualizza le policy di estensione globali in tutte le zone di un progetto

Puoi visualizzare le policy di estensione delle VM globali in un progetto per monitorare l'avanzamento dell'implementazione e ispezionare le configurazioni delle estensioni in tutte le zone del progetto.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare le policy delle estensioni con ambito a livello di progetto, chiedi all'amministratore di concederti il ruolo IAM Compute VM extension policies viewer (roles/compute.vmExtensionPolicyViewer) o Compute VM extension policies admin (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 le autorizzazioni necessarie per visualizzare le policy di estensione con ambito a livello di progetto. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le policy di estensione con ambito a livello di progetto sono necessarie le seguenti autorizzazioni:

• Elenca le policy di estensione: compute.vmExtensionPolicies.list
• Visualizza i dettagli di una policy di estensione: compute.vmExtensionPolicies.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le policy di estensione globali in un progetto, seleziona una delle seguenti opzioni:

Console

Per visualizzare le policy di estensione delle VM globali nel tuo progetto utilizzando la 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. Questa scheda elenca tutte le policy di estensione delle VM globali nel progetto.

gcloud

Per visualizzare tutte le policy delle estensioni globali in un progetto, esegui il comando gcloud compute global-vm-extension-policies list:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• PAGE_SIZE: il numero massimo di risultati da restituire per pagina.

Per visualizzare i dettagli di una specifica policy delle estensioni globali in un progetto, esegui il comando gcloud compute global-vm-extension-policies describe:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy delle estensioni VM che vuoi visualizzare.
• PROJECT_ID: l'ID del tuo progetto Google Cloud .

REST

Per visualizzare tutte le policy di estensione globali in un progetto, invia una richiesta GET al metodo globalVmExtensionPolicies.list:

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

Per visualizzare i dettagli di una specifica policy di estensione globale in un progetto, invia una richiesta GET al metodo globalVmExtensionPolicies.get:

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

Sostituisci quanto segue:

• POLICY_NAME: il nome della policy di estensione VM che vuoi visualizzare.
• PROJECT_ID: l'ID del tuo progetto Google Cloud .

Visualizza le policy di estensione a livello di zona 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.

Puoi elencare le policy delle estensioni VM con ambito a livello di organizzazione in una zona specifica o esaminare una singola policy per controllare le regole di applicazione a livello di zona nell'intera organizzazione.

Autorizzazioni IAM obbligatorie

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

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le policy delle estensioni con ambito a livello di organizzazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le policy delle estensioni con ambito a livello di organizzazione sono necessarie le seguenti autorizzazioni:

• Elenca le policy di estensione: compute.orgVmExtensionPolicies.list
• Visualizza i dettagli di una policy di estensione: compute.orgVmExtensionPolicies.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le policy di estensione zonale in un'organizzazione, seleziona una delle seguenti opzioni:

gcloud

Per visualizzare tutte le policy delle estensioni con ambito a livello di organizzazione in una zona, esegui il comando gcloud preview compute zone-vm-extension-policies list con il flag --organization:

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

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .
• ZONE: il nome della zona in cui vuoi elencare le policy delle estensioni VM.
• PAGE_SIZE: il numero massimo di risultati da restituire per pagina.

Per visualizzare i dettagli di una specifica policy di estensione a livello di zona con ambito a livello di organizzazione, esegui il comando gcloud preview compute zone-vm-extension-policies describe con il flag --organization:

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

Sostituisci quanto segue:

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

REST

Per visualizzare tutte le policy di estensione a livello di zona in un'organizzazione, invia una richiesta GET al metodo organizationZoneVmExtensionPolicies.list:

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

Per visualizzare i dettagli di una specifica policy di estensione a livello di zona in un'organizzazione, invia una richiesta GET al metodo organizationZoneVmExtensionPolicies.get:

GET 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 visualizzare.
• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .
• ZONE: la Google Cloud zona in cui si trova la policy di estensione della VM.

Visualizza le policy di estensione a livello di zona 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.

Puoi elencare le policy delle estensioni VM con ambito cartella in una zona specifica o esaminare una singola policy per verificare le regole delle estensioni a livello di zona per i progetti nella tua cartella.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare le policy di estensione con ambito cartella, chiedi all'amministratore di concederti il ruolo IAM Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) o Folder level Compute VM extension policies admin (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 le autorizzazioni necessarie per visualizzare le policy di estensione con ambito cartella. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le policy delle estensioni con ambito cartella sono necessarie le seguenti autorizzazioni:

• Elenca le policy di estensione: compute.folderVmExtensionPolicies.list
• Visualizza i dettagli di una policy di estensione: compute.folderVmExtensionPolicies.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le policy di estensione a livello di zona in una cartella, seleziona una delle seguenti opzioni:

gcloud

Per visualizzare tutte le policy di estensione con ambito a livello di cartella in una zona, esegui il comando gcloud preview compute zone-vm-extension-policies list con il flag --folder:

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

Sostituisci quanto segue:

• FOLDER_ID: l'ID della cartella Google Cloud .
• ZONE: il nome della zona in cui vuoi elencare le policy delle estensioni VM.
• PAGE_SIZE: il numero massimo di risultati da restituire per pagina.

Per visualizzare i dettagli di una specifica policy di estensione a livello di zona con ambito cartella, esegui il comando gcloud preview compute zone-vm-extension-policies describe con il flag --folder:

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

Sostituisci quanto segue:

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

REST

Per visualizzare tutte le policy di estensione a livello di zona in una cartella, invia una richiesta GET al metodo folderZoneVmExtensionPolicies.list:

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

Per visualizzare i dettagli di una policy di estensione a livello di zona specifica in una cartella, invia una richiesta GET al metodo folderZoneVmExtensionPolicies.get:

GET 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 visualizzare.
• FOLDER_ID: l'ID della cartella Google Cloud .
• ZONE: la Google Cloud zona in cui si trova la policy di estensione della VM.

Visualizza le policy di estensione di zona in una zona di un progetto

Puoi elencare le policy delle estensioni VM con ambito di progetto in una zona specifica o ispezionare una singola policy per verificare quali estensioni si applicano alle istanze in quella zona.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare le policy delle estensioni con ambito a livello di progetto, chiedi all'amministratore di concederti il ruolo IAM Compute VM extension policies viewer (roles/compute.vmExtensionPolicyViewer) o Compute VM extension policies admin (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 le autorizzazioni necessarie per visualizzare le policy di estensione con ambito a livello di progetto. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le policy di estensione con ambito a livello di progetto sono necessarie le seguenti autorizzazioni:

• Elenca le policy di estensione: compute.vmExtensionPolicies.list
• Visualizza i dettagli di una policy di estensione: compute.vmExtensionPolicies.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le policy di estensione a livello di zona in un progetto, seleziona una delle seguenti opzioni:

Console

Per visualizzare le policy delle estensioni VM di zona nel tuo progetto utilizzando la 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. Per visualizzare i dettagli di una policy di estensione specifica, fai clic sul nome della policy.

gcloud

Per visualizzare tutte le policy delle estensioni con ambito a livello di progetto in una zona, esegui il comando gcloud compute zone-vm-extension-policies list:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• ZONE: il nome della zona in cui vuoi elencare le policy delle estensioni VM.
• PAGE_SIZE: il numero massimo di risultati da restituire per pagina.

Per visualizzare i dettagli di una specifica policy di estensione a livello di zona con ambito di progetto, esegui il comando gcloud compute zone-vm-extension-policies describe:

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

Sostituisci quanto segue:

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

REST

Per visualizzare tutte le policy di estensione a livello di zona in un progetto, invia una richiesta GET al metodo zoneVmExtensionPolicies.list:

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

Per visualizzare i dettagli di una specifica policy di estensione a livello di zona in un progetto, invia una richiesta GET al metodo zoneVmExtensionPolicies.get:

GET 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 visualizzare.
• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• ZONE: la Google Cloud zona in cui si trova la policy di estensione della VM.

Visualizza le estensioni e le versioni delle VM

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.

Puoi utilizzare i metodi di sola lettura get e list per visualizzare le estensioni VM supportate dal gestore di estensioni VM nella tua organizzazione, cartella o progetto. Puoi visualizzare i nomi delle estensioni, i numeri di versione e i livelli di supporto delle estensioni in tutte le zone o all'interno di una zona specifica.

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

Utilizza i metodi di sola lettura get e list per visualizzare le estensioni VM supportate dal gestore di estensioni VM in tutte le zone della tua organizzazione, inclusi i numeri di versione e i livelli di assistenza.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare le estensioni delle VM nella tua organizzazione, chiedi all'amministratore di concederti il ruolo IAM Organization level Compute VM extension policies viewer (roles/compute.orgVmExtensionPolicyViewer) o Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) nella tua organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le estensioni VM nell'organizzazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le estensioni delle VM nella tua organizzazione sono necessarie le seguenti autorizzazioni:

• Elenca le estensioni VM: compute.orgVmExtensions.list
• Visualizza i dettagli di un'estensione VM: compute.orgVmExtensions.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le estensioni e le versioni delle VM supportate dal gestore di estensioni VM in tutte le zone della tua organizzazione, seleziona una delle seguenti opzioni:

gcloud

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di assistenza in tutte le zone della tua organizzazione, esegui il comando gcloud preview compute global-vm-extension-policies extensions list con il flag --organization:

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

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .

L'output elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i relativi livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica nella tua organizzazione, esegui il comando gcloud preview compute global-vm-extension-policies extensions describe con il flag --organization:

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

Sostituisci quanto segue:

• EXTENSION_NAME: il nome dell'estensione della VM (ad esempio ops-agent, google-cloud-sap-extension o google-cloud-workload-extension).
• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .

REST

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di assistenza in tutte le zone della tua organizzazione, invia una richiesta GET al metodo organizationGlobalVmExtensionPolicies.listVmExtensions:

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

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .

La risposta elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica nella tua organizzazione, invia una richiesta GET al metodo organizationGlobalVmExtensionPolicies.getVmExtension:

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

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .
• EXTENSION_NAME: il nome dell'estensione VM (ad esempio ops-agent).

Visualizza le estensioni delle VM in tutte le zone di una cartella

Utilizza i metodi di sola lettura get e list per visualizzare le estensioni VM supportate dal gestore di estensioni VM in tutte le zone della cartella, inclusi i numeri di versione e i livelli di assistenza.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare le estensioni VM nella cartella, chiedi all'amministratore di concederti il ruolo IAM Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) o Folder level Compute VM extension policies admin (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 le autorizzazioni necessarie per visualizzare le estensioni VM nella cartella. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le estensioni VM nella cartella sono necessarie le seguenti autorizzazioni:

• Elenca le estensioni VM: compute.folderVmExtensions.list
• Visualizza i dettagli di un'estensione VM: compute.folderVmExtensions.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le estensioni e le versioni delle VM supportate dal gestore di estensioni VM in tutte le zone della cartella, seleziona una delle seguenti opzioni:

gcloud

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di assistenza in tutte le zone della cartella, esegui il comando gcloud preview compute global-vm-extension-policies extensions list con il flag --folder:

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

Sostituisci quanto segue:

• FOLDER_ID: l'ID della cartella Google Cloud .

L'output elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i relativi livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica nella cartella, esegui il comando gcloud preview compute global-vm-extension-policies extensions describe con il flag --folder:

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

Sostituisci quanto segue:

• EXTENSION_NAME: il nome dell'estensione della VM (ad esempio ops-agent, google-cloud-sap-extension o google-cloud-workload-extension).
• FOLDER_ID: l'ID della cartella Google Cloud .

REST

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di assistenza in tutte le zone della cartella, invia una richiesta GET al metodo folderGlobalVmExtensionPolicies.listVmExtensions:

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

Sostituisci quanto segue:

• FOLDER_ID: l'ID della cartella Google Cloud .

La risposta elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica nella cartella, invia una richiesta GET al metodo folderGlobalVmExtensionPolicies.getVmExtension:

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

Sostituisci quanto segue:

• FOLDER_ID: l'ID della cartella Google Cloud .
• EXTENSION_NAME: il nome dell'estensione VM (ad esempio ops-agent).

Visualizza le estensioni VM in tutte le zone di un progetto

Utilizza i metodi di sola lettura get e list per visualizzare le estensioni VM supportate dal gestore di estensioni VM in tutte le zone del progetto, inclusi i numeri di versione e i livelli di assistenza.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare le estensioni delle VM nel tuo progetto, chiedi all'amministratore di concederti il ruolo IAM Compute VM extension policies viewer (roles/compute.vmExtensionPolicyViewer) o 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 le autorizzazioni necessarie per visualizzare le estensioni VM nel progetto. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le estensioni VM nel progetto sono necessarie le seguenti autorizzazioni:

• Elenca le estensioni VM: compute.vmExtensions.list
• Visualizza i dettagli di un'estensione VM: compute.vmExtensions.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le estensioni e le versioni delle VM supportate dal gestore di estensioni VM in tutte le zone del progetto, seleziona una delle seguenti opzioni:

gcloud

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di assistenza in tutte le zone del progetto, esegui il comando gcloud preview compute global-vm-extension-policies extensions list:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud .

L'output elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i relativi livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica nel progetto, esegui il comando gcloud preview compute global-vm-extension-policies extensions describe:

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

Sostituisci quanto segue:

• EXTENSION_NAME: il nome dell'estensione della VM (ad esempio ops-agent, google-cloud-sap-extension o google-cloud-workload-extension).
• PROJECT_ID: l'ID del tuo progetto Google Cloud .

REST

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di assistenza in tutte le zone del progetto, invia una richiesta GET al metodo globalVmExtensionPolicies.listVmExtensions:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud .

Il seguente snippet JSON mostra un esempio di risposta che elenca le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di supporto delle estensioni:

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

Per visualizzare i dettagli di un'estensione VM specifica nel progetto, invia una richiesta GET al metodo globalVmExtensionPolicies.getVmExtension:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• EXTENSION_NAME: il nome dell'estensione VM (ad esempio ops-agent).

Visualizza le estensioni VM in una zona di un'organizzazione

Utilizza i metodi di sola lettura get e list per visualizzare le estensioni VM supportate dal gestore di estensioni VM in una zona specifica della tua organizzazione, inclusi i numeri di versione e i livelli di assistenza.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare le estensioni delle VM in una zona della tua organizzazione, chiedi all'amministratore di concederti il ruolo IAM Organization level Compute VM extension policies viewer (roles/compute.orgVmExtensionPolicyViewer) o Organization level Compute VM extension policies admin (roles/compute.orgVmExtensionPolicyAdmin) per la tua organizzazione. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare le estensioni VM in una zona della tua organizzazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le estensioni VM in una zona della tua organizzazione sono necessarie le seguenti autorizzazioni:

• Elenca le estensioni VM: compute.orgVmExtensions.list
• Visualizza i dettagli di un'estensione VM: compute.orgVmExtensions.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le estensioni e le versioni delle VM supportate dal gestore di estensioni VM in una zona della tua organizzazione, seleziona una delle seguenti opzioni:

gcloud

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di assistenza in una zona specifica della tua organizzazione, esegui il comando gcloud preview compute zone-vm-extension-policies extensions list con il flag --organization:

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

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .
• ZONE: la zona Google Cloud in cui vuoi elencare le estensioni VM (ad esempio, us-central1-a).

L'output elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i relativi livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica in una zona della tua organizzazione, esegui il comando gcloud preview compute zone-vm-extension-policies extensions describe con il flag --organization:

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

Sostituisci quanto segue:

• EXTENSION_NAME: il nome dell'estensione VM (ad esempio ops-agent).
• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .
• ZONE: la zona in cui vuoi visualizzare i dettagli dell'estensione.

REST

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di supporto in una zona specifica della tua organizzazione, invia una richiesta GET al metodo organizationZoneVmExtensionPolicies.listVmExtensions:

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

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .
• ZONE: il nome della zona (ad esempio us-central1-a).

La risposta elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica in una zona della tua organizzazione, invia una richiesta GET al metodo organizationZoneVmExtensionPolicies.getVmExtension:

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

Sostituisci quanto segue:

• ORGANIZATION_ID: l'ID della tua organizzazione Google Cloud .
• ZONE: il nome della zona
• EXTENSION_NAME: il nome dell'estensione VM.

Visualizza le estensioni delle VM in una zona in una cartella

Utilizza i metodi di sola lettura get e list per visualizzare le estensioni VM supportate dal gestore di estensioni VM in una zona specifica della cartella, inclusi i numeri di versione e i livelli di assistenza.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare le estensioni VM in una zona della cartella, chiedi all'amministratore di concederti il ruolo IAM Folder level Compute VM extension policies viewer (roles/compute.folderVmExtensionPolicyViewer) o Folder level Compute VM extension policies admin (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 le autorizzazioni necessarie per visualizzare le estensioni VM in una zona della cartella. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le estensioni delle VM in una zona della cartella, sono necessarie le seguenti autorizzazioni:

• Elenca le estensioni VM: compute.folderVmExtensions.list
• Visualizza i dettagli di un'estensione VM: compute.folderVmExtensions.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le estensioni e le versioni delle VM supportate dal gestore di estensioni VM in una zona della cartella, seleziona una delle seguenti opzioni:

gcloud

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di assistenza in una zona specifica della cartella, esegui il comando gcloud preview compute zone-vm-extension-policies extensions list con il flag --folder:

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

Sostituisci quanto segue:

• FOLDER_ID: l'ID della cartella Google Cloud .
• ZONE: la zona Google Cloud in cui vuoi elencare le estensioni VM (ad esempio, us-central1-a).

L'output elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i relativi livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica in una zona della cartella, esegui il comando gcloud preview compute zone-vm-extension-policies extensions describe con il flag --folder:

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

Sostituisci quanto segue:

• EXTENSION_NAME: il nome dell'estensione VM (ad esempio ops-agent).
• FOLDER_ID: l'ID della cartella Google Cloud .
• ZONE: la zona in cui vuoi visualizzare i dettagli dell'estensione.

REST

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di supporto in una zona specifica della cartella, invia una richiesta GET al metodo folderZoneVmExtensionPolicies.listVmExtensions:

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

Sostituisci quanto segue:

• FOLDER_ID: l'ID della cartella Google Cloud .
• ZONE: il nome della zona (ad esempio us-central1-a).

La risposta elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica in una zona della cartella, invia una richiesta GET al metodo folderZoneVmExtensionPolicies.getVmExtension:

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

Sostituisci quanto segue:

• FOLDER_ID: l'ID della cartella Google Cloud .
• ZONE: il nome della zona
• EXTENSION_NAME: il nome dell'estensione VM.

Visualizza le estensioni VM in una zona di un progetto

Utilizza i metodi di sola lettura get e list per visualizzare le estensioni VM supportate dal gestore di estensioni VM in una zona specifica del tuo progetto, inclusi i numeri di versione e i livelli di assistenza.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare le estensioni delle VM in una zona del progetto, chiedi all'amministratore di concederti il ruolo IAM Compute VM extension policies viewer (roles/compute.vmExtensionPolicyViewer) o Compute VM extension policies admin (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 le autorizzazioni necessarie per visualizzare le estensioni VM in una zona del progetto. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare le estensioni VM in una zona del progetto, sono necessarie le seguenti autorizzazioni:

• Elenca le estensioni VM: compute.vmExtensions.list
• Visualizza i dettagli di un'estensione VM: compute.vmExtensions.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per visualizzare le estensioni e le versioni delle VM supportate dal gestore di estensioni VM in una zona del progetto, seleziona una delle seguenti opzioni:

gcloud

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di supporto in una zona specifica del progetto, esegui il comando gcloud preview compute zone-vm-extension-policies extensions list:

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

Sostituisci quanto segue:

• ZONE: la zona Google Cloud in cui vuoi elencare le estensioni VM (ad esempio, us-central1-a).
• PROJECT_ID: l'ID del tuo progetto Google Cloud .

L'output elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i relativi livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica in una zona del progetto, esegui il comando gcloud preview compute zone-vm-extension-policies extensions describe:

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

Sostituisci quanto segue:

• EXTENSION_NAME: il nome dell'estensione VM (ad esempio ops-agent).
• ZONE: la zona in cui vuoi visualizzare i dettagli dell'estensione.
• PROJECT_ID: l'ID del tuo progetto Google Cloud .

REST

Per elencare tutte le estensioni VM supportate dal gestore di estensioni VM e i relativi livelli di supporto in una zona specifica del progetto, invia una richiesta GET al metodo zoneVmExtensionPolicies.listVmExtensions:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• ZONE: il nome della zona (ad esempio us-central1-a).

La risposta elenca le estensioni VM supportate dal gestore di estensioni VM, le relative versioni e i livelli di supporto delle estensioni.

Per visualizzare i dettagli di un'estensione VM specifica in una zona del progetto, invia una richiesta GET al metodo zoneVmExtensionPolicies.getVmExtension:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• ZONE: il nome della zona
• EXTENSION_NAME: il nome dell'estensione VM.

Visualizza gli stati delle estensioni VM su un'istanza

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.

Puoi installare le estensioni VM sulle VM creando policy di estensione globali o di zona a livello di organizzazione, cartella o progetto. Una singola policy può installare più estensioni su una singola VM e più policy nella gerarchia delle risorse possono essere applicate alla stessa VM. Utilizza i metodi di sola lettura list e get dello stato dell'estensione dell'istanza per visualizzare lo stato di runtime delle estensioni installate su ogni VM senza connetterti alle singole macchine. Questi metodi ti aiutano a visualizzare la configurazione finale effettiva e la policy di gestione (policyId) per ogni estensione installata o a risolvere i problemi quando viene installata un'estensione imprevista o un'estensione non funziona su un'istanza.

Autorizzazioni IAM obbligatorie

Per ottenere le autorizzazioni necessarie per visualizzare gli stati delle estensioni VM su un'istanza, chiedi all'amministratore di concederti il ruolo IAM Compute Viewer (roles/compute.viewer), Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) o Compute Admin (roles/compute.admin) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare gli stati delle estensioni VM su un'istanza. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per visualizzare gli stati delle estensioni VM su un'istanza sono necessarie le seguenti autorizzazioni:

• Elenca tutti gli stati delle estensioni VM su un'istanza: compute.instances.listVmExtensionStates
• Recupera lo stato di un'estensione VM specifica su un'istanza: compute.instances.getVmExtensionState

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Elenca tutti gli stati delle estensioni VM su un'istanza

Quando una policy installa più estensioni su una VM, quando più policy si applicano alla stessa istanza o quando trovi un'estensione imprevista durante la risoluzione dei problemi, elenca tutti gli stati delle estensioni sulla VM per visualizzare la configurazione effettiva finale e lo stato di runtime di ogni estensione installata. La risposta mostra la versione attiva, lo stato di applicazione, lo stato di integrità e la policy di gestione (policyId) di ogni estensione.

Per visualizzare gli stati di tutte le estensioni VM installate su un'istanza, seleziona una delle seguenti opzioni:

gcloud

Per elencare tutte le estensioni VM installate e visualizzare i relativi stati attuali su un'istanza, esegui il comando gcloud beta compute instances list-vm-extension-states:

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

Sostituisci le seguenti variabili con i valori del tuo ambiente:

• INSTANCE_NAME: il nome dell'istanza VM.
• ZONE: la zona in cui si trova l'istanza (ad esempio us-central1-a).
• PROJECT_ID: l'ID del tuo progetto Google Cloud .

Il comando restituisce una tabella che elenca il nome, lo stato di applicazione e lo stato di integrità di ogni estensione installata:

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

REST

Per elencare tutte le estensioni VM installate e visualizzare i relativi stati attuali su un'istanza, invia una richiesta GET al metodo instances.listVmExtensionStates:

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

Sostituisci le seguenti variabili con i valori del tuo ambiente:

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• ZONE: la zona in cui si trova l'istanza
• INSTANCE_NAME: il nome o l'ID dell'istanza VM.

Il seguente snippet JSON mostra un esempio di risposta che elenca gli stati delle estensioni installate su un'istanza:

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

Visualizza lo stato di un'estensione VM specifica su un'istanza

Quando più policy hanno come target una VM o un'estensione installata non viene eseguita come previsto, visualizza lo stato di quell'estensione specifica per vedere la sua configurazione effettiva finale (policyId e versione) e i messaggi di stato della diagnostica.

Per visualizzare lo stato effettivo e la policy di gestione di un'estensione VM specifica su un'istanza, seleziona una delle seguenti opzioni:

gcloud

Per recuperare lo stato effettivo, la versione attiva e la policy di gestione di un'estensione VM specifica su un'istanza, esegui il comando gcloud beta compute instances get-vm-extension-state:

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

Sostituisci le seguenti variabili con i valori del tuo ambiente:

• INSTANCE_NAME: il nome dell'istanza VM.
• EXTENSION_NAME: il nome dell'estensione che vuoi ispezionare (ad esempio, ops-agent).
• ZONE: la zona in cui risiede l'istanza.
• PROJECT_ID: l'ID del tuo progetto Google Cloud .

REST

Per recuperare lo stato effettivo, la versione attiva e la policy di gestione di un'estensione VM specifica su un'istanza, invia una richiesta GET al metodo instances.getVmExtensionState:

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

Sostituisci le seguenti variabili con i valori del tuo ambiente:

• PROJECT_ID: l'ID del tuo progetto Google Cloud .
• ZONE: la zona in cui risiede l'istanza.
• INSTANCE_NAME: il nome o l'ID dell'istanza VM.
• EXTENSION_NAME: il nome dell'estensione VM (ad esempio ops-agent).

Il seguente snippet JSON mostra un esempio di risposta per lo stato di un'estensione VM singola su un'istanza:

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

Interpreta i campi di stato dell'estensione VM

Quando recuperi lo stato di un'estensione VM su un'istanza, la risposta include campi che indicano la policy applicata, la versione attiva, l'avanzamento dell'installazione e l'integrità del runtime del plug-in.

La tabella seguente descrive i campi restituiti da una risorsa VmExtensionState:

Campo	Descrizione
name	L'identificatore dell'estensione VM (ad esempio ops-agent).
version	La versione attiva dell'estensione installata sull'istanza VM.
policyId	L'identificatore della policy di estensione VM effettiva che applica questa estensione all'istanza. Se più policy hanno come target la VM, questo campo indica la policy vincente dopo la risoluzione della priorità.
enforcementState	Lo stato attuale del ciclo di vita del processo di applicazione delle norme relative alle estensioni. I valori possibili includono: ENFORCEMENT_STATE_UNSPECIFIED: lo stato di applicazione non è specificato. INSTALLING: l'agente guest sta installando l'estensione. INSTALLED: l'estensione è installata nell'istanza. INSTALL_FAILED: l'installazione non è riuscita e non è disponibile una revisione stabile precedente per il rollback. ROLLING_BACK: l'agente guest sta eseguendo il rollback dell'estensione all'ultima revisione stabile registrata. ROLLED_BACK: è stato eseguito il rollback dell'estensione all'ultima revisione stabile. ROLLBACK_FAILED: il tentativo di rollback non è riuscito. INCOMPATIBLE: nessuna delle revisioni disponibili per la versione dell'estensione è compatibile con il sistema operativo o l'architettura della VM. REMOVING: l'agente guest sta rimuovendo l'estensione dall'istanza. SERVICE_DISABLED: l'API di servizio richiesta per questa estensione è disattivata nel progetto. APPLYING_CONFIG: l'agente guest sta applicando una nuova configurazione all'estensione, il che potrebbe comportare il riavvio del plug-in.
enforcementMsg	Un messaggio di stato diagnostico restituito dall'agente guest se l'estensione non riesce ad applicare l'applicazione o rileva un errore di installazione.
healthStatus	Lo stato di integrità del runtime del plug-in di estensione applicato. Se l'estensione non è ancora applicata, questo valore non è specificato. I valori possibili includono: HEALTH_STATUS_UNSPECIFIED: lo stato di integrità non è specificato. STARTING: il processo di estensione è in fase di avvio. RUNNING: il processo dell'estensione è in esecuzione normalmente. STOPPING: il processo di estensione è in fase di arresto. STOPPED: il processo di estensione viene interrotto. CRASHED: il processo dell'estensione è stato avviato, ma l'esecuzione è stata interrotta in modo imprevisto.
healthMsg	Un messaggio di diagnostica che l'estensione segnala in merito al suo stato di integrità (ad esempio, Plugin is running ok).

Passaggi successivi

• 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 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.
• 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 modificare le impostazioni di configurazione, cambiare le versioni bloccate o rimuovere gli agenti di cui è stato eseguito il deployment, consulta Gestisci le estensioni VM utilizzando le policy delle estensioni.