Visualiza los detalles y el estado de la extensión de VM

Para instalar extensiones de VM en instancias de máquina virtual (VM) de Compute Engine, crea políticas de extensión globales o zonales a nivel de la organización, la carpeta o el proyecto. Una sola política puede instalar varias extensiones en una sola VM, y se pueden aplicar varias políticas a la misma VM.

En este documento, se describe cómo usar los métodos get y list de solo lectura en tu jerarquía de recursos de Cloud de Confiance by S3NS para realizar las siguientes tareas:

  • Consulta las políticas de extensiones en tu jerarquía de recursos. Enumera las políticas de extensión de VM globales o zonales para ver los detalles de las políticas y el estado del lanzamiento en tu organización, carpeta o proyecto.
  • Consulta las extensiones y versiones de las VMs. Enumera las extensiones de VM que admite el Gestor de extensiones de VM o consulta los detalles de las extensiones, incluidos los números de versión y los niveles de asistencia, en todas las zonas o en una zona específica de tu organización, carpeta o proyecto.
  • Consulta el estado de las extensiones instaladas en cada VM. Enumera todas las extensiones de VM instaladas y sus estados de entorno de ejecución en una instancia cuando una política instala varias extensiones en una VM, o consulta la configuración efectiva final y la política de administración (policyId) cuando se aplican varias políticas a la misma VM.
  • Soluciona problemas de extensiones en una instancia. Consulta el progreso de la instalación, el estado del entorno de ejecución y los mensajes de diagnóstico cuando se instala una extensión inesperada o cuando una extensión falla en una instancia de VM.

Antes de comenzar

Antes de ver las políticas de extensión de VM, recuperar los detalles de la extensión de VM o inspeccionar los estados de extensión en tus instancias de VM, completa los siguientes requisitos previos:

  • Lee Acerca del Gestor de extensiones de VM para comprender cómo las políticas de extensiones administran los complementos de agentes invitados en tu flota de VMs.
  • Si aún no implementaste extensiones en tus instancias, primero crea una política. Para obtener más información, consulta Instala extensiones de VM creando políticas de extensión.
  • Asegúrate de tener los permisos de Identity and Access Management necesarios para ver las políticas de extensiones, recuperar los detalles de las extensiones y, además, inspeccionar los estados de las extensiones de las instancias.

Limitaciones de visualización de políticas y extensiones

Cuando veas las políticas de extensión de VM, los detalles de la extensión y los estados de las instancias, ten en cuenta las siguientes restricciones operativas:

  • Solo puedes ver las políticas de extensión de VM con alcance de carpeta y de organización con Google Cloud CLI o la API de REST de Compute Engine.
  • Solo puedes recuperar los detalles de la extensión de VM y los estados de la extensión de instancia con Google Cloud CLI o la API de REST de Compute Engine. No puedes ver los detalles de la extensión de VM ni los estados de la extensión por instancia en la consola deCloud de Confiance .
  • Las APIs de estado de extensión de instancia (getVmExtensionState y listVmExtensionStates) informan el estado del entorno de ejecución solo para las extensiones que instalan y administran las políticas del Gestor de extensiones de VM. Estas APIs no informan el estado de los agentes independientes que instalas de forma manual fuera del Gestor de extensiones de VM.

Ver las políticas de extensiones

Puedes enumerar las políticas de extensiones de VM o inspeccionar los detalles de configuración de una política específica a nivel de la organización, la carpeta o el proyecto.

Visualiza las políticas de extensión globales en todas las zonas de una organización

Puedes enumerar todas las políticas de extensión de VM globales de tu organización o inspeccionar una política global específica con alcance de organización para auditar los lanzamientos de extensiones en toda la flota.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las políticas de extensión con alcance de organización, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de políticas de extensión de VM de Compute a nivel de la organización (roles/compute.orgVmExtensionPolicyViewer) o Administrador de políticas de extensión de VM de Compute a nivel de la organización (roles/compute.orgVmExtensionPolicyAdmin) en tu organización. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de extensión con alcance de organización. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las políticas de extensiones con alcance de organización:

  • Enumera las políticas de extensión: compute.orgVmExtensionPolicies.list
  • Consulta los detalles de una política de extensión: compute.orgVmExtensionPolicies.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las políticas de extensiones globales de una organización, selecciona una de las siguientes opciones:

gcloud

Para ver todas las políticas de extensión globales de una organización, ejecuta el comando gcloud preview compute global-vm-extension-policies list con la marca --organization:

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

Reemplaza lo siguiente:

  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .
  • PAGE_SIZE: Es la cantidad máxima de resultados que se mostrarán por página.

Para ver los detalles de una política de extensión global específica en una organización, ejecuta el comando gcloud preview compute global-vm-extension-policies describe con la marca --organization:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .

REST

Para ver todas las políticas de extensión globales de una organización, envía una solicitud GET al método organizationGlobalVmExtensionPolicies.list:

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

Para ver los detalles de una política de extensión global específica en una organización, envía una solicitud GET al método organizationGlobalVmExtensionPolicies.get:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .

Visualiza las políticas de extensión globales en todas las zonas de una carpeta

Puedes enumerar todas las políticas de extensión de VM globales en una carpeta o inspeccionar una política global específica con alcance de carpeta para verificar qué extensiones se aplican en los proyectos de esa carpeta.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las políticas de extensión con alcance de carpeta, pídele a tu administrador que te otorgue el rol de IAM Visualizador de políticas de extensión de VM de Compute a nivel de carpeta (roles/compute.folderVmExtensionPolicyViewer) o Administrador de políticas de extensión de VM de Compute a nivel de carpeta (roles/compute.folderVmExtensionPolicyAdmin) en tu carpeta. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de extensión con alcance de carpeta. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las políticas de extensión con alcance de carpeta:

  • Enumera las políticas de extensión: compute.folderVmExtensionPolicies.list
  • Consulta los detalles de una política de extensión: compute.folderVmExtensionPolicies.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las políticas de extensiones globales en una carpeta, selecciona una de las siguientes opciones:

gcloud

Para ver todas las políticas de extensión globales de una carpeta, ejecuta el comando gcloud preview compute global-vm-extension-policies list con la marca --folder:

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

Reemplaza lo siguiente:

  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .
  • PAGE_SIZE: Es la cantidad máxima de resultados que se mostrarán por página.

Para ver los detalles de una política de extensión global específica en una carpeta, ejecuta el comando gcloud preview compute global-vm-extension-policies describe con la marca --folder:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .

REST

Para ver todas las políticas de extensión globales de una carpeta, envía una solicitud GET al método folderGlobalVmExtensionPolicies.list:

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

Para ver los detalles de una política de extensión global específica en una carpeta, envía una solicitud GET al método folderGlobalVmExtensionPolicies.get:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .

Ver las políticas de extensión globales en todas las zonas de un proyecto

Puedes ver las políticas de extensión de VM globales en un proyecto para supervisar el progreso del lanzamiento y, además, inspeccionar las configuraciones de las extensiones en todas las zonas de ese proyecto.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las políticas de extensión con alcance de proyecto, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de políticas de extensión de VM de Compute (roles/compute.vmExtensionPolicyViewer) o Administrador de políticas de extensión de VM de Compute (roles/compute.vmExtensionPolicyAdmin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de extensión con alcance de proyecto. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las políticas de extensión con alcance de proyecto:

  • Enumera las políticas de extensión: compute.vmExtensionPolicies.list
  • Consulta los detalles de una política de extensión: compute.vmExtensionPolicies.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las políticas de extensión globales en un proyecto, selecciona una de las siguientes opciones:

Console

Para ver las políticas de extensiones de VM globales en tu proyecto con la consola de Cloud de Confiance , completa los siguientes pasos:

  1. En la consola de Cloud de Confiance , ve a la página Políticas de extensiones de VM.

    Ir a Políticas de extensión de VM

  2. Haz clic en Políticas globales. En esta pestaña, se enumeran todas las políticas de extensión de VM globales de tu proyecto.

gcloud

Para ver todas las políticas de extensión globales de un proyecto, ejecuta el comando gcloud compute global-vm-extension-policies list:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .
  • PAGE_SIZE: Es la cantidad máxima de resultados que se mostrarán por página.

Para ver los detalles de una política de extensión global específica en un proyecto, ejecuta el comando gcloud compute global-vm-extension-policies describe:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .

REST

Para ver todas las políticas de extensión globales de un proyecto, envía una solicitud GET al método globalVmExtensionPolicies.list:

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

Para ver los detalles de una política de extensión global específica en un proyecto, envía una solicitud GET al método globalVmExtensionPolicies.get:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .

Visualiza las políticas de extensión zonales en una zona de una organización

Puedes enumerar las políticas de extensión de VM con alcance de organización en una zona específica o inspeccionar una sola política para auditar las reglas de aplicación de políticas a nivel de zona en toda tu organización.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las políticas de extensión con alcance de organización, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de políticas de extensión de VM de Compute a nivel de la organización (roles/compute.orgVmExtensionPolicyViewer) o Administrador de políticas de extensión de VM de Compute a nivel de la organización (roles/compute.orgVmExtensionPolicyAdmin) en tu organización. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de extensión con alcance de organización. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las políticas de extensiones con alcance de organización:

  • Enumera las políticas de extensión: compute.orgVmExtensionPolicies.list
  • Consulta los detalles de una política de extensión: compute.orgVmExtensionPolicies.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las políticas de extensión zonal en una organización, selecciona una de las siguientes opciones:

gcloud

Para ver todas las políticas de extensión con alcance de la organización en una zona, ejecuta el comando gcloud preview compute zone-vm-extension-policies list con la marca --organization:

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

Reemplaza lo siguiente:

  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .
  • ZONE: Es el nombre de la zona en la que deseas enumerar las políticas de extensión de VM.
  • PAGE_SIZE: Es la cantidad máxima de resultados que se mostrarán por página.

Para ver los detalles de una política de extensión zonal específica con alcance de organización, ejecuta el comando gcloud preview compute zone-vm-extension-policies describe con la marca --organization:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .
  • ZONE: la zona de Cloud de Confiance en la que se encuentra la política de extensión de VM.

REST

Para ver todas las políticas de extensión zonal de una organización, envía una solicitud GET al método organizationZoneVmExtensionPolicies.list:

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

Para ver los detalles de una política de extensión zonal específica en una organización, envía una solicitud GET al método organizationZoneVmExtensionPolicies.get:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .
  • ZONE: la zona de Cloud de Confiance en la que se encuentra la política de extensión de VM.

Ver las políticas de extensión zonales en una zona de una carpeta

Puedes enumerar las políticas de extensión de VM con alcance de carpeta en una zona específica o inspeccionar una sola política para verificar las reglas de extensión a nivel de zona para los proyectos de tu carpeta.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las políticas de extensión con alcance de carpeta, pídele a tu administrador que te otorgue el rol de IAM Visualizador de políticas de extensión de VM de Compute a nivel de carpeta (roles/compute.folderVmExtensionPolicyViewer) o Administrador de políticas de extensión de VM de Compute a nivel de carpeta (roles/compute.folderVmExtensionPolicyAdmin) en tu carpeta. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de extensión con alcance de carpeta. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las políticas de extensión con alcance de carpeta:

  • Enumera las políticas de extensión: compute.folderVmExtensionPolicies.list
  • Consulta los detalles de una política de extensión: compute.folderVmExtensionPolicies.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las políticas de extensión zonal en una carpeta, selecciona una de las siguientes opciones:

gcloud

Para ver todas las políticas de extensión con alcance de carpeta en una zona, ejecuta el comando gcloud preview compute zone-vm-extension-policies list con la marca --folder:

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

Reemplaza lo siguiente:

  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .
  • ZONE: Es el nombre de la zona en la que deseas enumerar las políticas de extensión de VM.
  • PAGE_SIZE: Es la cantidad máxima de resultados que se mostrarán por página.

Para ver los detalles de una política de extensión zonal específica con alcance de carpeta, ejecuta el comando gcloud preview compute zone-vm-extension-policies describe con la marca --folder:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .
  • ZONE: la zona de Cloud de Confiance en la que se encuentra la política de extensión de VM.

REST

Para ver todas las políticas de extensión zonal de una carpeta, envía una solicitud GET al método folderZoneVmExtensionPolicies.list:

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

Para ver los detalles de una política de extensión zonal específica en una carpeta, envía una solicitud GET al método folderZoneVmExtensionPolicies.get:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .
  • ZONE: la zona de Cloud de Confiance en la que se encuentra la política de extensión de VM.

Consulta las políticas de extensión zonales en una zona de un proyecto

Puedes enumerar las políticas de extensiones de VM con alcance de proyecto en una zona específica o inspeccionar una sola política para verificar qué extensiones se aplican a las instancias de esa zona.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las políticas de extensión con alcance de proyecto, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de políticas de extensión de VM de Compute (roles/compute.vmExtensionPolicyViewer) o Administrador de políticas de extensión de VM de Compute (roles/compute.vmExtensionPolicyAdmin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de extensión con alcance de proyecto. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las políticas de extensión con alcance de proyecto:

  • Enumera las políticas de extensión: compute.vmExtensionPolicies.list
  • Consulta los detalles de una política de extensión: compute.vmExtensionPolicies.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las políticas de extensión zonal en un proyecto, selecciona una de las siguientes opciones:

Console

Para ver las políticas de extensión de VM zonales en tu proyecto con la consola de Cloud de Confiance , completa los siguientes pasos:

  1. En la consola de Cloud de Confiance , ve a la página Políticas de extensiones de VM.

    Ir a Políticas de extensión de VM

  2. Para ver los detalles de una política de extensión específica, haz clic en el nombre de la política.

gcloud

Para ver todas las políticas de extensión con alcance de proyecto en una zona, ejecuta el comando gcloud compute zone-vm-extension-policies list:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .
  • ZONE: Es el nombre de la zona en la que deseas enumerar las políticas de extensión de VM.
  • PAGE_SIZE: Es la cantidad máxima de resultados que se mostrarán por página.

Para ver los detalles de una política de extensión zonal específica con alcance de proyecto, ejecuta el comando gcloud compute zone-vm-extension-policies describe:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .
  • ZONE: la zona de Cloud de Confiance en la que se encuentra la política de extensión de VM.

REST

Para ver todas las políticas de extensión zonal de un proyecto, envía una solicitud GET al método zoneVmExtensionPolicies.list:

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

Para ver los detalles de una política de extensión zonal específica en un proyecto, envía una solicitud GET al método zoneVmExtensionPolicies.get:

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas ver.
  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .
  • ZONE: la zona de Cloud de Confiance en la que se encuentra la política de extensión de VM.

Ver las extensiones y versiones de VM

Puedes usar los métodos get y list de solo lectura para ver las extensiones de VM que admite el Gestor de extensiones de VM en tu organización, carpeta o proyecto. Puedes ver los nombres de las extensiones, los números de versión y los niveles de compatibilidad de las extensiones en todas las zonas o en una zona específica.

Visualiza las extensiones de VM en todas las zonas de una organización

Usa los métodos get y list de solo lectura para ver las extensiones de VM que admite el Gestor de extensiones de VM en todas las zonas de tu organización, incluidos sus números de versión y niveles de asistencia.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las extensiones de VM en toda tu organización, pídele a tu administrador que te otorgue el rol de IAM Visualizador de políticas de extensión de VM de Compute a nivel de la organización (roles/compute.orgVmExtensionPolicyViewer) o Administrador de políticas de extensión de VM de Compute a nivel de la organización (roles/compute.orgVmExtensionPolicyAdmin) en tu organización. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las extensiones de VM en toda tu organización. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las extensiones de VM en tu organización:

  • Enumera las extensiones de VM: compute.orgVmExtensions.list
  • Consulta los detalles de una extensión de VM: compute.orgVmExtensions.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las extensiones y versiones de VM que admite el Gestor de extensiones de VM en todas las zonas de tu organización, selecciona una de las siguientes opciones:

gcloud

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en todas las zonas de tu organización, ejecuta el comando gcloud preview compute global-vm-extension-policies extensions list con la marca --organization:

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

Reemplaza lo siguiente:

  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .

En el resultado, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en tu organización, ejecuta el comando gcloud preview compute global-vm-extension-policies extensions describe con la marca --organization:

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

Reemplaza lo siguiente:

  • EXTENSION_NAME: Es el nombre de la extensión de VM (por ejemplo, ops-agent, google-cloud-sap-extension o google-cloud-workload-extension).
  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .

REST

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en todas las zonas de tu organización, envía una solicitud GET al método organizationGlobalVmExtensionPolicies.listVmExtensions:

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

Reemplaza lo siguiente:

  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .

En la respuesta, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en tu organización, envía una solicitud GET al método organizationGlobalVmExtensionPolicies.getVmExtension:

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

Reemplaza lo siguiente:

  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .
  • EXTENSION_NAME: Es el nombre de la extensión de VM (por ejemplo, ops-agent).

Visualiza las extensiones de VM en todas las zonas de una carpeta

Usa los métodos de solo lectura get y list para ver las extensiones de VM que admite el Gestor de extensiones de VM en todas las zonas de tu carpeta, incluidos sus números de versión y niveles de asistencia.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las extensiones de VM en tu carpeta, pídele a tu administrador que te otorgue el rol de IAM Visualizador de políticas de extensión de VM de Compute a nivel de carpeta (roles/compute.folderVmExtensionPolicyViewer) o Administrador de políticas de extensión de VM de Compute a nivel de carpeta (roles/compute.folderVmExtensionPolicyAdmin) en tu carpeta. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las extensiones de VM en tu carpeta. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las extensiones de VM en tu carpeta:

  • Enumera las extensiones de VM: compute.folderVmExtensions.list
  • Consulta los detalles de una extensión de VM: compute.folderVmExtensions.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las extensiones y versiones de VM que admite el Gestor de extensiones de VM en todas las zonas de tu carpeta, selecciona una de las siguientes opciones:

gcloud

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en todas las zonas de tu carpeta, ejecuta el comando gcloud preview compute global-vm-extension-policies extensions list con la marca --folder:

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

Reemplaza lo siguiente:

  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .

En el resultado, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en tu carpeta, ejecuta el comando gcloud preview compute global-vm-extension-policies extensions describe con la marca --folder:

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

Reemplaza lo siguiente:

  • EXTENSION_NAME: Es el nombre de la extensión de VM (por ejemplo, ops-agent, google-cloud-sap-extension o google-cloud-workload-extension).
  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .

REST

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en todas las zonas de tu carpeta, envía una solicitud GET al método folderGlobalVmExtensionPolicies.listVmExtensions:

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

Reemplaza lo siguiente:

  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .

En la respuesta, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en tu carpeta, envía una solicitud GET al método folderGlobalVmExtensionPolicies.getVmExtension:

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

Reemplaza lo siguiente:

  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .
  • EXTENSION_NAME: Es el nombre de la extensión de VM (por ejemplo, ops-agent).

Ver las extensiones de VM en todas las zonas de un proyecto

Usa los métodos de solo lectura get y list para ver las extensiones de VM que admite el Gestor de extensiones de VM en todas las zonas de tu proyecto, incluidos sus números de versión y niveles de asistencia.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las extensiones de VM en tu proyecto, pídele a tu administrador que te otorgue el rol de IAM Visualizador de políticas de extensiones de VM de Compute (roles/compute.vmExtensionPolicyViewer) o Administrador de políticas de extensiones de VM de Compute (roles/compute.vmExtensionPolicyAdmin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las extensiones de VM en tu proyecto. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las extensiones de VM en tu proyecto:

  • Enumera las extensiones de VM: compute.vmExtensions.list
  • Consulta los detalles de una extensión de VM: compute.vmExtensions.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las extensiones y versiones de VM que admite el Gestor de extensiones de VM en todas las zonas de tu proyecto, selecciona una de las siguientes opciones:

gcloud

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en todas las zonas de tu proyecto, ejecuta el comando gcloud preview compute global-vm-extension-policies extensions list:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .

En el resultado, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en tu proyecto, ejecuta el comando gcloud preview compute global-vm-extension-policies extensions describe:

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

Reemplaza lo siguiente:

  • EXTENSION_NAME: Es el nombre de la extensión de VM (por ejemplo, ops-agent, google-cloud-sap-extension o google-cloud-workload-extension).
  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .

REST

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de asistencia en todas las zonas de tu proyecto, envía una solicitud GET al método globalVmExtensionPolicies.listVmExtensions:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .

En el siguiente fragmento de JSON, se muestra un ejemplo de respuesta en la que se enumeran las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad con extensiones:

{
  "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 los detalles de una extensión de VM específica en tu proyecto, envía una solicitud GET al método globalVmExtensionPolicies.getVmExtension:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .
  • EXTENSION_NAME: Es el nombre de la extensión de VM (por ejemplo, ops-agent).

Visualiza las extensiones de VM en una zona de una organización

Usa los métodos de solo lectura get y list para ver las extensiones de VM que admite el Gestor de extensiones de VM en una zona específica de tu organización, incluidos sus números de versión y niveles de asistencia.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las extensiones de VM en una zona de tu organización, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de políticas de extensión de VM de Compute a nivel de la organización (roles/compute.orgVmExtensionPolicyViewer) o Administrador de políticas de extensión de VM de Compute a nivel de la organización (roles/compute.orgVmExtensionPolicyAdmin) en tu organización. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las extensiones de VM en una zona de tu organización. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las extensiones de VM en una zona de tu organización:

  • Enumera las extensiones de VM: compute.orgVmExtensions.list
  • Consulta los detalles de una extensión de VM: compute.orgVmExtensions.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las extensiones y versiones de VM que admite el Gestor de extensiones de VM en una zona de tu organización, selecciona una de las siguientes opciones:

gcloud

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en una zona específica de tu organización, ejecuta el comando gcloud preview compute zone-vm-extension-policies extensions list con la marca --organization:

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

Reemplaza lo siguiente:

  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .
  • ZONE: Es la zona de Cloud de Confiance en la que deseas enumerar las extensiones de VM (por ejemplo, us-central1-a).

En el resultado, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en una zona de tu organización, ejecuta el comando gcloud preview compute zone-vm-extension-policies extensions describe con la marca --organization:

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

Reemplaza lo siguiente:

  • EXTENSION_NAME: Es el nombre de la extensión de VM (por ejemplo, ops-agent).
  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .
  • ZONE: Es la zona en la que deseas ver los detalles de la extensión.

REST

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en una zona específica de tu organización, envía una solicitud GET al método organizationZoneVmExtensionPolicies.listVmExtensions:

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

Reemplaza lo siguiente:

  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .
  • ZONE: Es el nombre de la zona (por ejemplo, us-central1-a).

En la respuesta, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en una zona de tu organización, envía una solicitud GET al método organizationZoneVmExtensionPolicies.getVmExtension:

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

Reemplaza lo siguiente:

  • ORGANIZATION_ID: Es el ID de tu organización de Cloud de Confiance .
  • ZONE: el nombre de la zona
  • EXTENSION_NAME: Es el nombre de la extensión de VM.

Visualiza las extensiones de VM en una zona de una carpeta

Usa los métodos de solo lectura get y list para ver las extensiones de VM que admite el Gestor de extensiones de VM en una zona específica de tu carpeta, incluidos sus números de versión y niveles de asistencia.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las extensiones de VM en una zona de tu carpeta, pídele a tu administrador que te otorgue el rol de IAM Visualizador de políticas de extensión de VM de Compute a nivel de carpeta (roles/compute.folderVmExtensionPolicyViewer) o Administrador de políticas de extensión de VM de Compute a nivel de carpeta (roles/compute.folderVmExtensionPolicyAdmin) en tu carpeta. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las extensiones de VM en una zona de tu carpeta. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las extensiones de VM en una zona de tu carpeta:

  • Enumera las extensiones de VM: compute.folderVmExtensions.list
  • Consulta los detalles de una extensión de VM: compute.folderVmExtensions.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las extensiones y versiones de VM que admite el Gestor de extensiones de VM en una zona de tu carpeta, selecciona una de las siguientes opciones:

gcloud

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en una zona específica de tu carpeta, ejecuta el comando gcloud preview compute zone-vm-extension-policies extensions list con la marca --folder:

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

Reemplaza lo siguiente:

  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .
  • ZONE: Es la zona de Cloud de Confiance en la que deseas enumerar las extensiones de VM (por ejemplo, us-central1-a).

En el resultado, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en una zona de tu carpeta, ejecuta el comando gcloud preview compute zone-vm-extension-policies extensions describe con la marca --folder:

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

Reemplaza lo siguiente:

  • EXTENSION_NAME: Es el nombre de la extensión de VM (por ejemplo, ops-agent).
  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .
  • ZONE: Es la zona en la que deseas ver los detalles de la extensión.

REST

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en una zona específica de tu carpeta, envía una solicitud GET al método folderZoneVmExtensionPolicies.listVmExtensions:

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

Reemplaza lo siguiente:

  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .
  • ZONE: Es el nombre de la zona (por ejemplo, us-central1-a).

En la respuesta, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en una zona de tu carpeta, envía una solicitud GET al método folderZoneVmExtensionPolicies.getVmExtension:

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

Reemplaza lo siguiente:

  • FOLDER_ID: Es el ID de tu carpeta de Cloud de Confiance .
  • ZONE: el nombre de la zona
  • EXTENSION_NAME: Es el nombre de la extensión de VM.

Visualiza las extensiones de VM en una zona de un proyecto

Usa los métodos get y list de solo lectura para ver las extensiones de VM que admite el Gestor de extensiones de VM en una zona específica de tu proyecto, incluidos sus números de versión y niveles de asistencia.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver las extensiones de VM en una zona de tu proyecto, pídele a tu administrador que te otorgue el rol de IAM Visualizador de políticas de extensiones de VM de Compute (roles/compute.vmExtensionPolicyViewer) o Administrador de políticas de extensiones de VM de Compute (roles/compute.vmExtensionPolicyAdmin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las extensiones de VM en una zona de tu proyecto. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las extensiones de VM en una zona de tu proyecto:

  • Enumera las extensiones de VM: compute.vmExtensions.list
  • Consulta los detalles de una extensión de VM: compute.vmExtensions.get

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para ver las extensiones y versiones de VM que admite el Gestor de extensiones de VM en una zona de tu proyecto, selecciona una de las siguientes opciones:

gcloud

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en una zona específica de tu proyecto, ejecuta el comando gcloud preview compute zone-vm-extension-policies extensions list:

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

Reemplaza lo siguiente:

  • ZONE: Es la zona de Cloud de Confiance en la que deseas enumerar las extensiones de VM (por ejemplo, us-central1-a).
  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .

En el resultado, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en una zona de tu proyecto, ejecuta el 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

Reemplaza lo siguiente:

  • EXTENSION_NAME: Es el nombre de la extensión de VM (por ejemplo, ops-agent).
  • ZONE: Es la zona en la que deseas ver los detalles de la extensión.
  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .

REST

Para enumerar todas las extensiones de VM que admite el Gestor de extensiones de VM y sus niveles de compatibilidad en una zona específica de tu proyecto, envía una solicitud GET al método zoneVmExtensionPolicies.listVmExtensions:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .
  • ZONE: Es el nombre de la zona (por ejemplo, us-central1-a).

En la respuesta, se enumeran las extensiones de VM que admite el Gestor de extensiones de VM, sus versiones y sus niveles de compatibilidad con extensiones.

Para ver los detalles de una extensión de VM específica en una zona de tu proyecto, envía una solicitud GET al método zoneVmExtensionPolicies.getVmExtension:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .
  • ZONE: el nombre de la zona
  • EXTENSION_NAME: Es el nombre de la extensión de VM.

Visualiza los estados de las extensiones de VM en una instancia

Para instalar extensiones de VM en las VMs, crea políticas de extensión globales o zonales a nivel de la organización, la carpeta o el proyecto. Una sola política puede instalar varias extensiones en una sola VM, y se pueden aplicar varias políticas en tu jerarquía de recursos a la misma VM. Usa los métodos de estado de extensión de instancia de solo lectura list y get para ver el estado del entorno de ejecución de las extensiones instaladas en cada VM sin conectarte a máquinas individuales. Estos métodos te ayudan a ver la configuración final efectiva y la política de administración (policyId) de cada extensión instalada, o a solucionar problemas cuando se instala una extensión inesperada o cuando una extensión falla en una instancia.

Permisos de IAM obligatorios

Para obtener los permisos que necesitas para ver los estados de las extensiones de VM en una instancia, pídele a tu administrador que te otorgue el rol de IAM Visualizador de Compute (roles/compute.viewer), Administrador de instancias de Compute (v1) (roles/compute.instanceAdmin.v1) o Administrador de Compute (roles/compute.admin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver los estados de las extensiones de VM en una instancia. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver los estados de las extensiones de VM en una instancia:

  • Enumera todos los estados de las extensiones de VM en una instancia: compute.instances.listVmExtensionStates
  • Obtén el estado de una extensión de VM específica en una instancia: compute.instances.getVmExtensionState

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Enumera todos los estados de las extensiones de VM en una instancia

Cuando una política instala varias extensiones en una VM, cuando se aplican varias políticas a la misma instancia o cuando encuentras una extensión inesperada durante la solución de problemas, enumera todos los estados de las extensiones en la VM para ver la configuración efectiva final y el estado del entorno de ejecución de cada extensión instalada. En la respuesta, se muestra la versión activa de cada extensión, el estado de aplicación de medidas por incumplimiento, el estado y la política que rige (policyId).

Para ver los estados de todas las extensiones de VM instaladas en una instancia, selecciona una de las siguientes opciones:

gcloud

Para enumerar todas las extensiones de VM instaladas y ver sus estados actuales en una instancia, ejecuta el comando gcloud beta compute instances list-vm-extension-states:

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

Reemplaza las siguientes variables por valores para tu entorno:

  • INSTANCE_NAME: El nombre de la instancia de VM
  • ZONE: Es la zona en la que se encuentra la instancia (por ejemplo, us-central1-a).
  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .

El comando devuelve una tabla que enumera el nombre, el estado de aplicación de políticas y el estado de cada extensión instalada:

EXTENSION_NAME  ENFORCEMENT_STATE  HEALTH_STATUS
ops-agent       INSTALLED          RUNNING

REST

Para enumerar todas las extensiones de VM instaladas y ver sus estados actuales en una instancia, envía una solicitud GET al método instances.listVmExtensionStates:

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

Reemplaza las siguientes variables por valores para tu entorno:

  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .
  • ZONE: Es la zona en la que se encuentra la instancia.
  • INSTANCE_NAME: Es el nombre o el ID de la instancia de VM.

En el siguiente fragmento de JSON, se muestra un ejemplo de respuesta que enumera los estados de las extensiones instaladas en una instancia:

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

Consulta el estado de una extensión de VM específica en una instancia

Cuando varias políticas se orientan a una VM o una extensión instalada no se ejecuta como se espera, consulta el estado de esa extensión específica para ver su configuración efectiva final (policyId y versión) y los mensajes de estado de diagnóstico.

Para ver el estado efectivo y la política de administración de una extensión de VM específica en una instancia, selecciona una de las siguientes opciones:

gcloud

Para recuperar el estado efectivo, la versión activa y la política de administración de una extensión de VM específica en una instancia, ejecuta el 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

Reemplaza las siguientes variables por valores para tu entorno:

  • INSTANCE_NAME: El nombre de la instancia de VM
  • EXTENSION_NAME: Es el nombre de la extensión que deseas inspeccionar (por ejemplo, ops-agent).
  • ZONE: Es la zona en la que reside la instancia.
  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .

REST

Para recuperar el estado efectivo, la versión activa y la política de administración de una extensión de VM específica en una instancia, envía una solicitud GET al método instances.getVmExtensionState:

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

Reemplaza las siguientes variables por valores para tu entorno:

  • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance .
  • ZONE: Es la zona en la que reside la instancia.
  • INSTANCE_NAME: Es el nombre o el ID de la instancia de VM.
  • EXTENSION_NAME: Es el nombre de la extensión de VM (por ejemplo, ops-agent).

En el siguiente fragmento de JSON, se muestra un ejemplo de respuesta para un solo estado de extensión de VM en una instancia:

{
  "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 los campos de estado de la extensión de VM

Cuando recuperas el estado de una extensión de VM en una instancia, la respuesta incluye campos que informan la política aplicada, la versión activa, el progreso de la instalación y el estado del entorno de ejecución del complemento.

En la siguiente tabla, se describen los campos que devuelve un recurso VmExtensionState:

Campo Descripción
name Es el identificador de la extensión de VM (por ejemplo, ops-agent).
version Es la versión activa de la extensión que está instalada en la instancia de VM.
policyId Es el identificador de la política de extensión de VM vigente que aplica esta extensión en la instancia. Si varias políticas se orientan a la VM, este campo indica la política ganadora después de la resolución de prioridad.
enforcementState Es el estado actual del ciclo de vida del proceso de aplicación de medidas por incumplimiento de la extensión. Entre los valores posibles, se incluyen los siguientes:
  • ENFORCEMENT_STATE_UNSPECIFIED: No se especifica el estado de aplicación de medidas por incumplimiento.
  • INSTALLING: El agente invitado está instalando la extensión.
  • INSTALLED: La extensión se instala en la instancia.
  • INSTALL_FAILED: Se produjo un error en la instalación y no hay ninguna revisión estable anterior disponible para la reversión.
  • ROLLING_BACK: El agente invitado está revirtiendo la extensión a la última revisión estable registrada.
  • ROLLED_BACK: La extensión se revirtió a la última revisión estable.
  • ROLLBACK_FAILED: No se pudo realizar el intento de reversión.
  • INCOMPATIBLE: Ninguna de las revisiones disponibles para la versión de la extensión es compatible con el sistema operativo o la arquitectura de la VM.
  • REMOVING: El agente invitado está quitando la extensión de la instancia.
  • SERVICE_DISABLED: La API de servicio requerida para esta extensión está inhabilitada en el proyecto.
  • APPLYING_CONFIG: El agente invitado está aplicando una configuración nueva a la extensión, lo que podría implicar reiniciar el complemento.
enforcementMsg Es un mensaje de estado de diagnóstico que devuelve el agente invitado si la extensión no aplica o encuentra un error de instalación.
healthStatus Es el estado del entorno de ejecución del complemento de extensión aplicado. Si aún no se aplica la extensión, este valor no se especifica. Entre los valores posibles, se incluyen los siguientes:
  • HEALTH_STATUS_UNSPECIFIED: No se especifica el estado.
  • STARTING: Se está iniciando el proceso de la extensión.
  • RUNNING: El proceso de extensión se ejecuta con normalidad.
  • STOPPING: El proceso de la extensión se está deteniendo.
  • STOPPED: Se detiene el proceso de la extensión.
  • CRASHED: El proceso de extensión se inició, pero dejó de ejecutarse de forma inesperada.
healthMsg Es un mensaje de diagnóstico que informa la extensión sobre su estado (por ejemplo, Plugin is running ok).

¿Qué sigue?