Algumas ou todas as informações nesta página podem não se aplicar ao Cloud de Confiance da S3NS. Consulte Diferenças do Google Cloud para saber mais.

O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Ver detalhes e status da extensão de VM

Para instalar extensões de VM em instâncias de máquina virtual (VM) do Compute Engine, crie políticas de extensão globais ou zonais no nível da organização, da pasta ou do projeto. Uma única política pode instalar várias extensões em uma única VM, e várias políticas podem ser aplicadas à mesma VM.

Neste documento, descrevemos como usar os métodos get e list somente leitura na hierarquia de recursos do Cloud de Confiance by S3NS para realizar as seguintes tarefas:

Veja as políticas de extensão na sua hierarquia de recursos. Liste as políticas de extensão de VM globais ou zonais para conferir os detalhes da política e o estado de lançamento na sua organização, pasta ou projeto.
Ver extensões e versões de VM. Liste as extensões de VM compatíveis com o Gerenciador de Extensões de VM ou confira os detalhes das extensões, incluindo números de versão e níveis de suporte, em todas as zonas ou em uma zona específica na sua organização, pasta ou projeto.
Confira o status das extensões instaladas em cada VM. Liste todas as extensões de VM instaladas e os estados de ambiente de execução delas em uma instância quando uma política instala várias extensões em uma VM ou confira a configuração efetiva final e a política de controle (policyId) quando várias políticas se aplicam à mesma VM.
Resolver problemas de extensões em uma instância. Confira o progresso da instalação, o status de integridade do ambiente de execução e as mensagens de diagnóstico quando uma extensão inesperada for instalada ou uma extensão falhar em uma instância de VM.

Antes de começar

Antes de visualizar as políticas de extensão de VM, recuperar detalhes da extensão de VM ou inspecionar os estados da extensão nas instâncias de VM, conclua os seguintes pré-requisitos:

Leia Sobre o Gerenciador de extensões de VM para entender como as políticas de extensão gerenciam plug-ins de agentes convidados na sua frota de VMs.
Se você ainda não implantou extensões nas suas instâncias, crie uma política primeiro. Para mais informações, consulte Instalar extensões de VM criando políticas de extensão.
Verifique se você tem as permissões necessárias do Identity and Access Management para visualizar as políticas de extensão, recuperar detalhes da extensão e inspecionar os estados da extensão da instância.

Limitações de visualização de políticas e extensões

Ao visualizar políticas de extensão de VM, detalhes de extensão e estados de instância, considere as seguintes restrições operacionais:

Só é possível visualizar as políticas de extensão de VM com escopo de pasta e de organização usando a Google Cloud CLI ou a API REST do Compute Engine.
Só é possível recuperar detalhes de extensões de VM e estados de extensões de instância usando a Google Cloud CLI ou a API REST do Compute Engine. Não é possível ver os detalhes da extensão de VM ou os estados da extensão por instância no console doCloud de Confiance .
As APIs de estado de extensão de instância (getVmExtensionState e listVmExtensionStates) informam o status do ambiente de execução apenas para extensões que as políticas do Gerenciador de extensões de VM instalam e gerenciam. Essas APIs não informam o status de agentes independentes que você instala manualmente fora do Gerenciador de Extensões de VM.

Ver políticas de extensão

É possível listar as políticas de extensão de VM ou inspecionar os detalhes de configuração de uma política específica no nível da organização, da pasta ou do projeto.

Ver as políticas de extensão globais em todas as zonas de uma organização

É possível listar todas as políticas globais de extensão de VM na sua organização ou inspecionar uma política global específica com escopo da organização para auditar as implantações de extensão em toda a frota.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para visualizar as políticas de extensão no escopo da organização, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute no nível da organização (roles/compute.orgVmExtensionPolicyViewer) ou Administrador de políticas de extensão de VM do Compute no nível da organização (roles/compute.orgVmExtensionPolicyAdmin) na sua organização. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar as políticas de extensão no escopo da organização. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para visualizar as políticas de extensão no escopo da organização:

Listar políticas de extensão: compute.orgVmExtensionPolicies.list
Confira os detalhes de uma política de extensão: compute.orgVmExtensionPolicies.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as políticas de extensão globais em uma organização, selecione uma das seguintes opções:

gcloud

Para ver todas as políticas de extensão globais em uma organização, execute o comando gcloud preview compute global-vm-extension-policies list com a flag --organization:

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

Substitua:

ORGANIZATION_ID: o ID da organização do Cloud de Confiance .
PAGE_SIZE: o número máximo de resultados a serem retornados por página.

Para ver detalhes de uma política de extensão global específica em uma organização, execute o comando gcloud preview compute global-vm-extension-policies describe com a flag --organization:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
ORGANIZATION_ID: o ID da organização do Cloud de Confiance .

REST

Para conferir todas as políticas de extensão globais em uma organização, envie uma solicitação GET ao método organizationGlobalVmExtensionPolicies.list:

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

Para ver detalhes de uma política de extensão global específica em uma organização, envie uma solicitação GET ao método organizationGlobalVmExtensionPolicies.get:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
ORGANIZATION_ID: o ID da organização do Cloud de Confiance .

Ver políticas de extensão globais em todas as zonas de uma pasta

É possível listar todas as políticas globais de extensão de VM em uma pasta ou inspecionar uma política global específica com escopo de pasta para verificar quais extensões se aplicam aos projetos nessa pasta.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para visualizar as políticas de extensão com escopo de pasta, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute no nível da pasta (roles/compute.folderVmExtensionPolicyViewer) ou Administrador de políticas de extensão de VM do Compute no nível da pasta (roles/compute.folderVmExtensionPolicyAdmin) na pasta. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar políticas de extensão com escopo de pasta. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para visualizar as políticas de extensão com escopo de pasta:

Listar políticas de extensão: compute.folderVmExtensionPolicies.list
Confira os detalhes de uma política de extensão: compute.folderVmExtensionPolicies.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as políticas de extensão globais em uma pasta, selecione uma das seguintes opções:

gcloud

Para ver todas as políticas de extensão globais em uma pasta, execute o comando gcloud preview compute global-vm-extension-policies list com a flag --folder:

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

Substitua:

FOLDER_ID: o ID da pasta do Cloud de Confiance .
PAGE_SIZE: o número máximo de resultados a serem retornados por página.

Para ver detalhes de uma política de extensão global específica em uma pasta, execute o comando gcloud preview compute global-vm-extension-policies describe com a flag --folder:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
FOLDER_ID: o ID da pasta do Cloud de Confiance .

REST

Para ver todas as políticas de extensão globais em uma pasta, envie uma solicitação GET ao método folderGlobalVmExtensionPolicies.list:

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

Para ver detalhes de uma política de extensão global específica em uma pasta, envie uma solicitação GET ao método folderGlobalVmExtensionPolicies.get:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
FOLDER_ID: o ID da pasta do Cloud de Confiance .

Ver políticas de extensão globais em todas as zonas de um projeto

É possível visualizar as políticas globais de extensão de VM em um projeto para monitorar o progresso do lançamento e inspecionar as configurações de extensão em todas as zonas desse projeto.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para visualizar as políticas de extensão com escopo de projeto, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute (roles/compute.vmExtensionPolicyViewer) ou Administrador de políticas de extensão de VM do Compute (roles/compute.vmExtensionPolicyAdmin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar políticas de extensão com escopo de projeto. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para visualizar as políticas de extensão com escopo de projeto:

Listar políticas de extensão: compute.vmExtensionPolicies.list
Confira os detalhes de uma política de extensão: compute.vmExtensionPolicies.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as políticas de extensão globais em um projeto, selecione uma das seguintes opções:

Console

Para ver as políticas globais de extensão de VM no seu projeto usando o console do Cloud de Confiance , siga estas etapas:

No console do Cloud de Confiance , acesse a página Políticas de extensão de VM.
Acessar as políticas de extensão de VM
Clique em Políticas globais. Nesta guia, listamos todas as políticas globais de extensão de VM no seu projeto.

gcloud

Para conferir todas as políticas de extensão globais em um projeto, execute o comando gcloud compute global-vm-extension-policies list:

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

Substitua:

PROJECT_ID: o ID do seu projeto do Cloud de Confiance .
PAGE_SIZE: o número máximo de resultados a serem retornados por página.

Para ver detalhes de uma política de extensão global específica em um projeto, execute o comando gcloud compute global-vm-extension-policies describe:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
PROJECT_ID: o ID do seu projeto do Cloud de Confiance .

REST

Para conferir todas as políticas de extensão globais em um projeto, envie uma solicitação GET ao método globalVmExtensionPolicies.list:

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

Para ver detalhes de uma política de extensão global específica em um projeto, envie uma solicitação GET ao método globalVmExtensionPolicies.get:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
PROJECT_ID: o ID do seu projeto do Cloud de Confiance .

Ver políticas de extensão zonais em uma zona de uma organização

É possível listar políticas de extensão de VM com escopo de organização em uma zona específica ou inspecionar uma única política para auditar regras de aplicação no nível da zona em toda a organização.

Permissões do IAM obrigatórias

Permissões necessárias

As permissões a seguir são necessárias para visualizar as políticas de extensão no escopo da organização:

Listar políticas de extensão: compute.orgVmExtensionPolicies.list
Confira os detalhes de uma política de extensão: compute.orgVmExtensionPolicies.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as políticas de extensão zonal em uma organização, selecione uma das seguintes opções:

gcloud

Para ver todas as políticas de extensão no escopo da organização em uma zona, execute o comando gcloud preview compute zone-vm-extension-policies list com a flag --organization:

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

Substitua:

ORGANIZATION_ID: o ID da organização do Cloud de Confiance .
ZONE: o nome da zona em que você quer listar as políticas de extensão de VM.
PAGE_SIZE: o número máximo de resultados a serem retornados por página.

Para conferir detalhes de uma política de extensão zonal específica no escopo da organização, execute o comando gcloud preview compute zone-vm-extension-policies describe com a flag --organization:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
ORGANIZATION_ID: o ID da organização do Cloud de Confiance .
ZONE: a Cloud de Confiance zona em que a política de extensão de VM está localizada.

REST

Para ver todas as políticas de extensão zonal em uma organização, envie uma solicitação GET para o método organizationZoneVmExtensionPolicies.list:

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

Para conferir detalhes de uma política de extensão zonal específica em uma organização, envie uma solicitação GET ao método organizationZoneVmExtensionPolicies.get:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
ORGANIZATION_ID: o ID da organização do Cloud de Confiance .
ZONE: a Cloud de Confiance zona em que a política de extensão de VM está localizada.

Ver políticas de extensão zonais em uma zona em uma pasta

É possível listar políticas de extensão de VM com escopo de pasta em uma zona específica ou inspecionar uma única política para verificar as regras de extensão no nível da zona para projetos na sua pasta.

Permissões do IAM obrigatórias

Permissões necessárias

As seguintes permissões são necessárias para visualizar as políticas de extensão com escopo de pasta:

Listar políticas de extensão: compute.folderVmExtensionPolicies.list
Confira os detalhes de uma política de extensão: compute.folderVmExtensionPolicies.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as políticas de extensão zonal em uma pasta, selecione uma das seguintes opções:

gcloud

Para ver todas as políticas de extensão com escopo de pasta em uma zona, execute o comando gcloud preview compute zone-vm-extension-policies list com a flag --folder:

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

Substitua:

FOLDER_ID: o ID da pasta do Cloud de Confiance .
ZONE: o nome da zona em que você quer listar as políticas de extensão de VM.
PAGE_SIZE: o número máximo de resultados a serem retornados por página.

Para conferir os detalhes de uma política de extensão zonal específica com escopo de pasta, execute o comando gcloud preview compute zone-vm-extension-policies describe com a flag --folder:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
FOLDER_ID: o ID da pasta do Cloud de Confiance .
ZONE: a Cloud de Confiance zona em que a política de extensão de VM está localizada.

REST

Para ver todas as políticas de extensão zonal em uma pasta, envie uma solicitação GET ao método folderZoneVmExtensionPolicies.list:

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

Para ver detalhes de uma política de extensão zonal específica em uma pasta, envie uma solicitação GET ao método folderZoneVmExtensionPolicies.get:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
FOLDER_ID: o ID da pasta do Cloud de Confiance .
ZONE: a Cloud de Confiance zona em que a política de extensão de VM está localizada.

Ver políticas de extensão zonais em uma zona de um projeto

É possível listar políticas de extensão de VM com escopo de projeto em uma zona específica ou inspecionar uma única política para verificar quais extensões se aplicam às instâncias nessa zona.

Permissões do IAM obrigatórias

Permissões necessárias

As seguintes permissões são necessárias para visualizar as políticas de extensão com escopo de projeto:

Listar políticas de extensão: compute.vmExtensionPolicies.list
Confira os detalhes de uma política de extensão: compute.vmExtensionPolicies.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as políticas de extensão zonal em um projeto, selecione uma das seguintes opções:

Console

Para ver as políticas de extensão de VM zonal no seu projeto usando o console do Cloud de Confiance , siga estas etapas:

No console do Cloud de Confiance , acesse a página Políticas de extensão de VM.
Acessar as políticas de extensão de VM
Para ver detalhes de uma política de extensão específica, clique no nome dela.

gcloud

Para conferir todas as políticas de extensão com escopo de projeto em uma zona, execute o comando gcloud compute zone-vm-extension-policies list:

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

Substitua:

PROJECT_ID: o ID do seu projeto do Cloud de Confiance .
ZONE: o nome da zona em que você quer listar as políticas de extensão de VM.
PAGE_SIZE: o número máximo de resultados a serem retornados por página.

Para ver detalhes de uma política de extensão zonal específica com escopo de projeto, execute o comando gcloud compute zone-vm-extension-policies describe:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
PROJECT_ID: o ID do seu projeto do Cloud de Confiance .
ZONE: a Cloud de Confiance zona em que a política de extensão de VM está localizada.

REST

Para conferir todas as políticas de extensão zonal em um projeto, envie uma solicitação GET ao método zoneVmExtensionPolicies.list:

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

Para ver detalhes de uma política de extensão zonal específica em um projeto, envie uma solicitação GET ao método zoneVmExtensionPolicies.get:

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

Substitua:

POLICY_NAME: o nome da política de extensão de VM que você quer visualizar.
PROJECT_ID: o ID do seu projeto do Cloud de Confiance .
ZONE: a Cloud de Confiance zona em que a política de extensão de VM está localizada.

Ver extensões e versões de VM

É possível usar os métodos somente leitura get e list para conferir as extensões de VM que o Gerenciador de extensões de VM aceita na organização, pasta ou projeto. É possível conferir os nomes das extensões, os números de versão e os níveis de suporte de extensão em todas as zonas ou em uma zona específica.

Ver extensões de VM em todas as zonas de uma organização

Use os métodos somente leitura get e list para conferir as extensões de VM compatíveis com o Gerenciador de extensões de VM em todas as zonas da sua organização, incluindo os números de versão e os níveis de suporte.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para visualizar as extensões de VM em toda a organização, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute no nível da organização (roles/compute.orgVmExtensionPolicyViewer) ou Administrador de políticas de extensão de VM do Compute no nível da organização (roles/compute.orgVmExtensionPolicyAdmin) na organização. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar as extensões de VM em toda a organização. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para visualizar as extensões de VM na sua organização:

Liste as extensões de VM: compute.orgVmExtensions.list
Veja os detalhes de uma extensão de VM: compute.orgVmExtensions.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as extensões e versões de VM compatíveis com o Gerenciador de extensões de VM em todas as zonas da sua organização, selecione uma das seguintes opções:

gcloud

Para listar todas as extensões de VM compatíveis com o Gerenciador de Extensões de VM e os níveis de suporte delas em todas as zonas da sua organização, execute o comando gcloud preview compute global-vm-extension-policies extensions list com a flag --organization:

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

Substitua:

ORGANIZATION_ID: o ID da organização do Cloud de Confiance .

A saída lista as extensões de VM compatíveis com o Gerenciador de Extensões de VM, as versões delas e os níveis de suporte de extensão.

Para conferir os detalhes de uma extensão de VM específica na sua organização, execute o comando gcloud preview compute global-vm-extension-policies extensions describe com a flag --organization:

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

Substitua:

EXTENSION_NAME: o nome da extensão de VM (por exemplo, ops-agent, google-cloud-sap-extension ou google-cloud-workload-extension).
ORGANIZATION_ID: o ID da organização do Cloud de Confiance .

REST

Para listar todas as extensões de VM compatíveis com o Gerenciador de extensões de VM e os níveis de suporte delas em todas as zonas da sua organização, envie uma solicitação GET para o método organizationGlobalVmExtensionPolicies.listVmExtensions:

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

Substitua:

ORGANIZATION_ID: o ID da organização do Cloud de Confiance .

A resposta lista as extensões de VM compatíveis com o Gerenciador de extensões de VM, as versões delas e os níveis de suporte de extensão.

Para conferir os detalhes de uma extensão de VM específica na sua organização, envie uma solicitação GET ao método organizationGlobalVmExtensionPolicies.getVmExtension:

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

Substitua:

ORGANIZATION_ID: o ID da organização do Cloud de Confiance .
EXTENSION_NAME: o nome da extensão da VM (por exemplo, ops-agent).

Ver extensões de VM em todas as zonas de uma pasta

Use os métodos somente leitura get e list para conferir as extensões de VM que o Gerenciador de Extensões de VM aceita em todas as zonas da sua pasta, incluindo os números de versão e os níveis de suporte.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para visualizar as extensões de VM na sua pasta, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute no nível da pasta (roles/compute.folderVmExtensionPolicyViewer) ou Administrador de políticas de extensão de VM do Compute no nível da pasta (roles/compute.folderVmExtensionPolicyAdmin) na sua pasta. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar as extensões de VM na sua pasta. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para visualizar as extensões de VM na sua pasta:

Liste as extensões de VM: compute.folderVmExtensions.list
Veja os detalhes de uma extensão de VM: compute.folderVmExtensions.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as extensões e versões de VM compatíveis com o Gerenciador de Extensões de VM em todas as zonas da sua pasta, selecione uma das seguintes opções:

gcloud

Para listar todas as extensões de VM compatíveis com o Gerenciador de extensões de VM e os níveis de suporte delas em todas as zonas da pasta, execute o comando gcloud preview compute global-vm-extension-policies extensions list com a flag --folder:

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

Substitua:

FOLDER_ID: o ID da pasta do Cloud de Confiance .

A saída lista as extensões de VM compatíveis com o Gerenciador de Extensões de VM, as versões delas e os níveis de suporte de extensão.

Para conferir os detalhes de uma extensão de VM específica na sua pasta, execute o comando gcloud preview compute global-vm-extension-policies extensions describe com a flag --folder:

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

Substitua:

EXTENSION_NAME: o nome da extensão de VM (por exemplo, ops-agent, google-cloud-sap-extension ou google-cloud-workload-extension).
FOLDER_ID: o ID da pasta do Cloud de Confiance .

REST

Para listar todas as extensões de VM compatíveis com o Gerenciador de extensões de VM e os níveis de suporte delas em todas as zonas da pasta, envie uma solicitação GET para o método folderGlobalVmExtensionPolicies.listVmExtensions:

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

Substitua:

FOLDER_ID: o ID da pasta do Cloud de Confiance .

A resposta lista as extensões de VM compatíveis com o Gerenciador de extensões de VM, as versões delas e os níveis de suporte de extensão.

Para ver os detalhes de uma extensão de VM específica na sua pasta, envie uma solicitação GET ao método folderGlobalVmExtensionPolicies.getVmExtension:

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

Substitua:

FOLDER_ID: o ID da pasta do Cloud de Confiance .
EXTENSION_NAME: o nome da extensão da VM (por exemplo, ops-agent).

Ver extensões de VM em todas as zonas de um projeto

Use os métodos somente leitura get e list para conferir as extensões de VM compatíveis com o Gerenciador de extensões de VM em todas as zonas do projeto, incluindo os números de versão e os níveis de suporte.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para visualizar as extensões de VM no projeto, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute (roles/compute.vmExtensionPolicyViewer) ou Administrador de políticas de extensão de VM do Compute (roles/compute.vmExtensionPolicyAdmin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar as extensões de VM no seu projeto. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para visualizar as extensões de VM no projeto:

Liste as extensões de VM: compute.vmExtensions.list
Veja os detalhes de uma extensão de VM: compute.vmExtensions.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as extensões e versões de VM compatíveis com o Gerenciador de Extensões de VM em todas as zonas do seu projeto, selecione uma das seguintes opções:

gcloud

Para listar todas as extensões de VM compatíveis com o Gerenciador de extensões de VM e os níveis de suporte delas em todas as zonas do projeto, execute o comando gcloud preview compute global-vm-extension-policies extensions list:

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

Substitua:

PROJECT_ID: o ID do seu projeto do Cloud de Confiance .

A saída lista as extensões de VM compatíveis com o Gerenciador de Extensões de VM, as versões delas e os níveis de suporte de extensão.

Para conferir os detalhes de uma extensão de VM específica no seu projeto, execute o comando gcloud preview compute global-vm-extension-policies extensions describe:

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

Substitua:

EXTENSION_NAME: o nome da extensão de VM (por exemplo, ops-agent, google-cloud-sap-extension ou google-cloud-workload-extension).
PROJECT_ID: o ID do seu projeto do Cloud de Confiance .

REST

Para listar todas as extensões de VM compatíveis com o Gerenciador de Extensões de VM e os níveis de suporte delas em todas as zonas do projeto, envie uma solicitação GET para o método globalVmExtensionPolicies.listVmExtensions:

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

Substitua:

PROJECT_ID: o ID do seu projeto do Cloud de Confiance .

O snippet JSON a seguir mostra um exemplo de resposta que lista as extensões de VM compatíveis com o Gerenciador de extensões de VM e os níveis de suporte de extensão:

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

Para ver os detalhes de uma extensão de VM específica no seu projeto, envie uma solicitação GET ao método globalVmExtensionPolicies.getVmExtension:

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

Substitua:

PROJECT_ID: o ID do seu projeto do Cloud de Confiance .
EXTENSION_NAME: o nome da extensão da VM (por exemplo, ops-agent).

Ver extensões de VM em uma zona de uma organização

Use os métodos somente leitura get e list para conferir as extensões de VM que o Gerenciador de Extensões de VM aceita em uma zona específica da sua organização, incluindo os números de versão e os níveis de suporte.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para visualizar as extensões de VM em uma zona na sua organização, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute no nível da organização (roles/compute.orgVmExtensionPolicyViewer) ou Administrador de políticas de extensão de VM do Compute no nível da organização (roles/compute.orgVmExtensionPolicyAdmin) na sua organização. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar as extensões de VM em uma zona na sua organização. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para visualizar as extensões de VM em uma zona na sua organização:

Liste as extensões de VM: compute.orgVmExtensions.list
Veja os detalhes de uma extensão de VM: compute.orgVmExtensions.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as extensões e versões de VM compatíveis com o Gerenciador de extensões de VM em uma zona da sua organização, selecione uma das seguintes opções:

gcloud

Para listar todas as extensões de VM compatíveis com o Gerenciador de extensões de VM e os níveis de suporte delas em uma zona específica da organização, execute o comando gcloud preview compute zone-vm-extension-policies extensions list com a flag --organization:

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

Substitua:

ORGANIZATION_ID: o ID da organização do Cloud de Confiance .
ZONE: a zona do Cloud de Confiance em que você quer listar as extensões de VM (por exemplo, us-central1-a).

A saída lista as extensões de VM compatíveis com o Gerenciador de Extensões de VM, as versões delas e os níveis de suporte de extensão.

Para conferir os detalhes de uma extensão de VM específica em uma zona da sua organização, execute o comando gcloud preview compute zone-vm-extension-policies extensions describe com a flag --organization:

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

Substitua:

EXTENSION_NAME: o nome da extensão da VM (por exemplo, ops-agent).
ORGANIZATION_ID: o ID da organização do Cloud de Confiance .
ZONE: a zona em que você quer ver os detalhes da extensão.

REST

Para listar todas as extensões de VM compatíveis com o Gerenciador de extensões de VM e os níveis de suporte delas em uma zona específica da sua organização, envie uma solicitação GET para o método organizationZoneVmExtensionPolicies.listVmExtensions:

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

Substitua:

ORGANIZATION_ID: o ID da organização do Cloud de Confiance .
ZONE: o nome da zona (por exemplo, us-central1-a).

A resposta lista as extensões de VM compatíveis com o Gerenciador de extensões de VM, as versões delas e os níveis de suporte de extensão.

Para ver os detalhes de uma extensão de VM específica em uma zona da sua organização, envie uma solicitação GET ao método organizationZoneVmExtensionPolicies.getVmExtension:

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

Substitua:

ORGANIZATION_ID: o ID da organização do Cloud de Confiance .
ZONE: o nome da zona.
EXTENSION_NAME: o nome da extensão da VM.

Ver extensões de VM em uma zona em uma pasta

Use os métodos get e list somente leitura para conferir as extensões de VM que o Gerenciador de extensões de VM aceita em uma zona específica na sua pasta, incluindo os números de versão e os níveis de suporte.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para visualizar as extensões de VM em uma zona na sua pasta, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute no nível da pasta (roles/compute.folderVmExtensionPolicyViewer) ou Administrador de políticas de extensão de VM do Compute no nível da pasta (roles/compute.folderVmExtensionPolicyAdmin) na sua pasta. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar as extensões de VM em uma zona na sua pasta. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para visualizar as extensões de VM em uma zona na sua pasta:

Liste as extensões de VM: compute.folderVmExtensions.list
Veja os detalhes de uma extensão de VM: compute.folderVmExtensions.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as extensões e versões de VM compatíveis com o Gerenciador de extensões de VM em uma zona da sua pasta, selecione uma das seguintes opções:

gcloud

Para listar todas as extensões de VM compatíveis com o Gerenciador de extensões de VM e os níveis de suporte delas em uma zona específica da pasta, execute o comando gcloud preview compute zone-vm-extension-policies extensions list com a flag --folder:

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

Substitua:

FOLDER_ID: o ID da pasta do Cloud de Confiance .
ZONE: a zona do Cloud de Confiance em que você quer listar as extensões de VM (por exemplo, us-central1-a).

A saída lista as extensões de VM compatíveis com o Gerenciador de Extensões de VM, as versões delas e os níveis de suporte de extensão.

Para ver os detalhes de uma extensão de VM específica em uma zona na sua pasta, execute o comando gcloud preview compute zone-vm-extension-policies extensions describe com a flag --folder:

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

Substitua:

EXTENSION_NAME: o nome da extensão da VM (por exemplo, ops-agent).
FOLDER_ID: o ID da pasta do Cloud de Confiance .
ZONE: a zona em que você quer ver os detalhes da extensão.

REST

Para listar todas as extensões de VM compatíveis com o Gerenciador de extensões de VM e os níveis de suporte delas em uma zona específica da pasta, envie uma solicitação GET para o método folderZoneVmExtensionPolicies.listVmExtensions:

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

Substitua:

FOLDER_ID: o ID da pasta do Cloud de Confiance .
ZONE: o nome da zona (por exemplo, us-central1-a).

A resposta lista as extensões de VM compatíveis com o Gerenciador de extensões de VM, as versões delas e os níveis de suporte de extensão.

Para ver os detalhes de uma extensão de VM específica em uma zona da sua pasta, envie uma solicitação GET ao método folderZoneVmExtensionPolicies.getVmExtension:

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

Substitua:

FOLDER_ID: o ID da pasta do Cloud de Confiance .
ZONE: o nome da zona.
EXTENSION_NAME: o nome da extensão da VM.

Ver extensões de VM em uma zona de um projeto

Use os métodos somente leitura get e list para conferir as extensões de VM que o Gerenciador de extensões de VM aceita em uma zona específica do seu projeto, incluindo os números de versão e os níveis de suporte.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para visualizar as extensões de VM em uma zona do projeto, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute (roles/compute.vmExtensionPolicyViewer) ou Administrador de políticas de extensão de VM do Compute (roles/compute.vmExtensionPolicyAdmin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar as extensões de VM em uma zona do seu projeto. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para visualizar as extensões de VM em uma zona do seu projeto:

Liste as extensões de VM: compute.vmExtensions.list
Veja os detalhes de uma extensão de VM: compute.vmExtensions.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as extensões e versões de VM compatíveis com o Gerenciador de Extensões de VM em uma zona do seu projeto, selecione uma das seguintes opções:

gcloud

Para listar todas as extensões de VM compatíveis com o Gerenciador de extensões de VM e os níveis de suporte delas em uma zona específica do projeto, execute o comando gcloud preview compute zone-vm-extension-policies extensions list:

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

Substitua:

ZONE: a zona do Cloud de Confiance em que você quer listar as extensões de VM (por exemplo, us-central1-a).
PROJECT_ID: o ID do seu projeto do Cloud de Confiance .

A saída lista as extensões de VM compatíveis com o Gerenciador de Extensões de VM, as versões delas e os níveis de suporte de extensão.

Para ver os detalhes de uma extensão de VM específica em uma zona do seu projeto, execute o 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

Substitua:

EXTENSION_NAME: o nome da extensão da VM (por exemplo, ops-agent).
ZONE: a zona em que você quer ver os detalhes da extensão.
PROJECT_ID: o ID do seu projeto do Cloud de Confiance .

REST

Para listar todas as extensões de VM compatíveis com o Gerenciador de Extensões de VM e os níveis de suporte delas em uma zona específica do projeto, envie uma solicitação GET ao método zoneVmExtensionPolicies.listVmExtensions:

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

Substitua:

PROJECT_ID: o ID do seu projeto do Cloud de Confiance .
ZONE: o nome da zona (por exemplo, us-central1-a).

A resposta lista as extensões de VM compatíveis com o Gerenciador de extensões de VM, as versões delas e os níveis de suporte de extensão.

Para conferir os detalhes de uma extensão de VM específica em uma zona do seu projeto, envie uma solicitação GET para o método zoneVmExtensionPolicies.getVmExtension:

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

Substitua:

PROJECT_ID: o ID do seu projeto do Cloud de Confiance .
ZONE: o nome da zona.
EXTENSION_NAME: o nome da extensão da VM.

Ver estados de extensão de VM em uma instância

Para instalar extensões de VM em VMs, crie políticas de extensão globais ou zonais no nível da organização, da pasta ou do projeto. Uma única política pode instalar várias extensões em uma única VM, e várias políticas na hierarquia de recursos podem ser aplicadas à mesma VM. Use os métodos list e get de estado de extensão de instância somente leitura para conferir o status de execução das extensões instaladas em cada VM sem se conectar a máquinas individuais. Esses métodos ajudam você a ver a configuração final efetiva e a política de controle (policyId) de cada extensão instalada ou a resolver problemas quando uma extensão inesperada é instalada ou uma extensão falha em uma instância.

Permissões do IAM obrigatórias

Para receber as permissões necessárias para visualizar os estados de extensão de VM em uma instância, peça ao administrador para conceder a você o papel do IAM de Leitor do Compute (roles/compute.viewer), Administrador da instância do Compute (v1) (roles/compute.instanceAdmin.v1) ou Administrador do Compute (roles/compute.admin) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar os estados de extensão de VM em uma instância. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para visualizar os estados de extensão de VM em uma instância:

Liste todos os estados de extensão de VM em uma instância: compute.instances.listVmExtensionStates
Receba o estado de uma extensão de VM específica em uma instância: compute.instances.getVmExtensionState

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Listar todos os estados de extensão de VM em uma instância

Quando uma política instala várias extensões em uma VM, quando várias políticas se aplicam à mesma instância ou quando você encontra uma extensão inesperada durante a solução de problemas, liste todos os estados de extensão na VM para conferir a configuração efetiva final e o status de execução de cada extensão instalada. A resposta mostra a versão ativa, o estado de aplicação, o status de integridade e a política de controle (policyId) de cada extensão.

Para conferir os estados de todas as extensões de VM instaladas em uma instância, selecione uma das seguintes opções:

gcloud

Para listar todas as extensões de VM instaladas e conferir os estados atuais delas em uma instância, execute o comando gcloud beta compute instances list-vm-extension-states:

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

Substitua as seguintes variáveis por valores do seu ambiente:

INSTANCE_NAME: o nome da instância de VM.
ZONE: a zona em que a instância está localizada (por exemplo, us-central1-a).
PROJECT_ID: o ID do seu projeto do Cloud de Confiance .

O comando retorna uma tabela que lista o nome, o estado de aplicação e o status de integridade de cada extensão instalada:

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

REST

Para listar todas as extensões de VM instaladas e conferir os estados atuais delas em uma instância, envie uma solicitação GET ao método instances.listVmExtensionStates:

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

Substitua as seguintes variáveis por valores do seu ambiente:

PROJECT_ID: o ID do seu projeto do Cloud de Confiance .
ZONE: a zona em que a instância está.
INSTANCE_NAME: o nome ou ID da instância de VM.

O snippet JSON a seguir mostra um exemplo de resposta que lista os estados das extensões instaladas em uma instância:

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

Ver o estado de uma extensão de VM específica em uma instância

Quando várias políticas segmentam uma VM ou uma extensão instalada não está funcionando como esperado, confira o estado dessa extensão específica para ver a configuração final efetiva (policyId e versão) e as mensagens de status de diagnóstico.

Para conferir o estado efetivo e a política de controle de uma extensão de VM específica em uma instância, selecione uma das seguintes opções:

gcloud

Para recuperar o estado efetivo, a versão ativa e a política de controle de uma extensão de VM específica em uma instância, execute o 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

Substitua as seguintes variáveis por valores do seu ambiente:

INSTANCE_NAME: o nome da instância de VM.
EXTENSION_NAME: o nome da extensão que você quer inspecionar (por exemplo, ops-agent).
ZONE: a zona em que a instância está localizada.
PROJECT_ID: o ID do seu projeto do Cloud de Confiance .

REST

Para recuperar o estado efetivo, a versão ativa e a política de controle de uma extensão de VM específica em uma instância, envie uma solicitação GET ao método instances.getVmExtensionState:

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

Substitua as seguintes variáveis por valores do seu ambiente:

PROJECT_ID: o ID do seu projeto do Cloud de Confiance .
ZONE: a zona em que a instância está localizada.
INSTANCE_NAME: o nome ou ID da instância de VM.
EXTENSION_NAME: o nome da extensão da VM (por exemplo, ops-agent).

O snippet JSON a seguir mostra um exemplo de resposta para um único estado de extensão de VM em uma instância:

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

Interpretar campos de estado da extensão de VM

Quando você recupera o estado de uma extensão de VM em uma instância, a resposta inclui campos que informam a política aplicada, a versão ativa, o progresso da instalação e a integridade do ambiente de execução do plug-in.

A tabela a seguir descreve os campos que um recurso VmExtensionState retorna:

Campo	Descrição
`name`	O identificador da extensão de VM (por exemplo, `ops-agent`).
`version`	A versão ativa da extensão instalada na instância de VM.
`policyId`	O identificador da política de extensão de VM em vigor que aplica essa extensão na instância. Se várias políticas forem aplicadas à VM, esse campo vai indicar a política vencedora após a resolução de prioridade.
`enforcementState`	O estado atual do ciclo de vida do processo de aplicação da extensão. Os valores possíveis incluem o seguinte: `ENFORCEMENT_STATE_UNSPECIFIED`: o estado de aplicação não foi especificado. `INSTALLING`: o agente convidado está instalando a extensão. `INSTALLED`: a extensão está instalada na instância. `INSTALL_FAILED`: a instalação falhou e não há uma revisão estável anterior disponível para reversão. `ROLLING_BACK`: o agente convidado está revertendo a extensão para a última revisão estável registrada. `ROLLED_BACK`: a extensão foi revertida para a última revisão estável. `ROLLBACK_FAILED`: falha na tentativa de reversão. `INCOMPATIBLE`: nenhuma das revisões disponíveis para a versão da extensão é compatível com o sistema operacional ou a arquitetura da VM. `REMOVING`: o agente convidado está removendo a extensão da instância. `SERVICE_DISABLED`: a API de serviço necessária para essa extensão está desativada no projeto. `APPLYING_CONFIG`: o agente convidado está aplicando uma nova configuração à extensão, o que pode envolver a reinicialização do plug-in.
`enforcementMsg`	Uma mensagem de status de diagnóstico que o agente convidado retorna se a extensão não consegue aplicar ou encontra um erro de instalação.
`healthStatus`	O status de integridade do ambiente de execução do plug-in de extensão aplicado. Se a extensão ainda não estiver em vigor, esse valor não será especificado. Os valores possíveis incluem o seguinte: `HEALTH_STATUS_UNSPECIFIED`: o status de integridade não foi especificado. `STARTING`: o processo de extensão está sendo iniciado. `RUNNING`: o processo de extensão está sendo executado normalmente. `STOPPING`: o processo de extensão está sendo interrompido. `STOPPED`: o processo da extensão foi interrompido. `CRASHED`: o processo de extensão foi iniciado, mas parou de ser executado inesperadamente.
`healthMsg`	Uma mensagem de diagnóstico que a extensão informa sobre o status de integridade (por exemplo, `Plugin is running ok`).

A seguir

Para diagnosticar lançamentos com falha, verificar processos de convidado em execução ou inspecionar registros de depuração do agente convidado, consulte Resolver problemas de extensões de VM.
Para consultar eventos de aplicação históricos e auditar registros de instalação ou falha no Cloud Logging, consulte Ver registros de extensão de VM.
Para criar painéis do Cloud Monitoring e configurar alertas de integridade do agente, uso da CPU e uso da memória, consulte Monitorar extensões de VM.
Para modificar as definições de configuração, alterar as versões fixadas ou remover os agentes implantados, consulte Gerenciar extensões de VM usando políticas de extensão.