Valores predeterminados de metadatos de VM

Compute Engine define un conjunto de entradas de metadatos predeterminados que proporcionan información sobre tu instancia o proyecto de máquina virtual (VM). El servidor siempre define y establece los metadatos predeterminados. Las claves de metadatos predeterminadas distinguen entre mayúsculas y minúsculas.

Para obtener información sobre cómo consultar los valores de metadatos, visita Consulta metadatos de VM.

Cómo se organizan los valores de los metadatos

  • Metadatos de instancia y de proyecto: Los metadatos se pueden asignar a proyectos y a VM. Los metadatos del proyecto se propagan a todas las VM dentro de un proyecto, mientras que los metadatos de las instancias solo se aplican a una VM única.

  • Fichas del directorio: Algunas entradas de metadatos son directorios que contienen otras claves de metadatos. Esta diferencia se indica con una barra diagonal al final del nombre del metadato. Por ejemplo, attributes/ es un directorio que contiene otras claves de metadatos.

Metadatos del proyecto

Las entradas de metadatos del proyecto se almacenan en el siguiente directorio:

  • http://metadata.google.internal/computeMetadata/v1/project/
Entrada de metadatos Descripción
attributes/

Un directorio de valores de metadatos personalizados que se pasan a las VM de tu proyecto durante el inicio o el cierre. Estos valores personalizados pueden ser atributos de Google Cloud o valores de metadatos creados por el usuario.

Para obtener una lista de los atributos de Google Cloud a nivel de proyecto que puedes configurar, consulta Atributos de proyecto.

Para obtener más información sobre la configuración de los metadatos personalizados, consulta Configura metadatos personalizados.
numeric-project-id El ID del proyecto numérico (número de proyecto) de la instancia, que no es igual al nombre del proyecto que aparece en la consola de Google Cloud. Este valor es diferente del valor de entrada de metadatos project-id.
project-id El ID del proyecto.

Atributos del proyecto

Los atributos del proyecto se almacenan en el siguiente directorio:

  • http://metadata.google.internal/computeMetadata/v1/project/attributes/
Entrada de metadatos Descripción
disable-legacy-endpoints

Inhabilita los extremos del servidor de metadatos heredados para todas las VM del proyecto.

Los extremos heredados están obsoletos, siempre configura disable-legacy-endpoints=TRUE.

enable-guest-attributes

Configura los atributos de invitado para el proyecto.

Los atributos de invitado son valores de metadatos de instancia de VM personalizados que puedes usar para publicar notificaciones de estado poco frecuentes, datos de bajo volumen o datos de baja frecuencia. Estos valores son útiles para indicar cuándo finalizaron las secuencias de comandos de inicio o proporcionar otras notificaciones de estado poco frecuentes a otras aplicaciones.

Para obtener más información sobre los atributos de invitado, consulta Establece y consulta atributos de invitado.

enable-os-inventory

Habilita o inhabilita el inventario del SO para el proyecto.

Recopila y almacena información de SO. Esto incluye información como el nombre de host, la versión de kernel, la arquitectura y los detalles de paquetes instalados.

Para obtener más información sobre el inventario del SO, consulta Visualiza los detalles del sistema operativo.

enable-oslogin

Habilita o inhabilita la administración de claves SSH en tu proyecto.

Para obtener más información sobre el acceso al SO, consulta Configura el Acceso al SO.

enable-windows-ssh

Habilita o inhabilita SSH para las VMs de Windows.

Para obtener más información, consulta Conéctate a las VMs de Windows mediante SSH.

google-compute-default-region Si se configura, almacena la región predeterminada que usa el proyecto.

Para obtener más información sobre cómo establecer regiones predeterminadas, consulta Región y zona predeterminadas.

google-compute-default-zone Si se configura, almacena la zona predeterminada que usa el proyecto.

Para obtener más información sobre cómo configurar zonas predeterminadas, consulta Región y zona predeterminadas.

ssh-keys

Si administras Llaves SSH con metadatos, este atributo te permite configurar claves SSH públicas que pueden conectarse a las VM de este proyecto. Si hay varias claves SSH, cada una estará separada por un carácter de salto de línea (\n). El valor del atributo ssh-keys es una string.

Ejemplo: "user1:ssh-rsa mypublickey user1@host.com\nuser2:ssh-rsa mypublickey user2@host.com"

Las claves SSH administradas por el acceso al SO no son visibles en los metadatos.

sshKeys Obsoleto: Usa ssh-keys.
vmdnssetting

Habilita el DNS zonal y el DNS global para las VM de tu proyecto.

Para obtener más información sobre los nombres de DNS internos, consulta DNS interno.

Metadatos de la instancia de VM

Las entradas de metadatos de la VM se almacenan en el siguiente directorio:

  • http://metadata.google.internal/computeMetadata/v1/instance/
Entrada de metadatos Descripción
attributes/

Un directorio de valores de metadatos personalizados que se pasan a la VM durante el inicio o el apagado. Estos valores personalizados pueden ser atributos de Google Cloud o valores de metadatos creados por el usuario.

Para obtener una lista de los atributos de Google Cloud a nivel de instancia que puedes configurar, consulta Atributos de instancia.

Para obtener más información sobre cómo configurar metadatos personalizados, consulta Configura metadatos personalizados.
cpu-platform

Plataforma de CPU de la VM.

Para obtener información sobre las plataformas de CPU, consulta Plataformas de CPU.
description La descripción de texto libre de una instancia que se asigna con la marca --description mediante la CLI de Google Cloud o la API.
disks/

Un directorio de discos adjuntos a la VM. Para cada métrica, está disponible la siguiente información:

  • device-name
  • index
  • interface
  • mode
  • type

Para obtener más información sobre los discos, consulta Opciones de almacenamiento.

guest-attributes/

Configura los atributos de invitado para la VM. Estos valores personalizados pueden ser atributos de Google Cloud o valores de metadatos creados por el usuario.

Para obtener una lista de los atributos de Google Cloud a nivel de instancia que puedes establecer, consulta Atributos de invitado de instancias.

Para obtener más información sobre los atributos de invitado, consulta Establece y consulta atributos de invitado.

hostname El nombre de host de la VM.
id El ID de la VM. Este es un ID numérico único que genera Compute Engine. Esto es útil para identificar VM si no usas nombres de VM.
image La imagen del sistema operativo que usa la VM Este valor tiene el siguiente formato: projects/IMAGE_PROJECT/global/images/IMAGE_NAME.
legacy-endpoint-access/ Almacena la lista de extremos heredados. Los valores son 0.1 y v1beta1.
licenses/ Una lista de ID de código de licencia que se usan para adjuntar las licencias a imágenes, instantáneas y discos.
machine-type El tipo de máquina de esta VM. Este valor tiene el siguiente formato: projects/PROJECT_NUM/machineTypes/MACHINE_TYPE
maintenance-event Indica si un evento de mantenimiento está afectando a esta VM. Para obtener más información, consulta Migración en vivo.
name El nombre de la VM
network-interfaces/

Un directorio de interfaces de red. Para cada interfaz de red, está disponible la siguiente información:

  • access-configs/

    • external-ip
    • type
  • dns-servers
  • forwarded-ips/
  • gateway
  • ip
  • ip-aliases/
  • mac
  • mtu
  • network
  • subnetmask
  • target-instance-ips

Para obtener más información sobre las interfaces de red, consulta Descripción general de las interfaces de red múltiples.

preempted

Un valor booleano que indica si una VM está a punto de interrumpirse.
scheduling/

Establece las opciones de programación de la VM.

Los valores de programación de metadatos incluyen los siguientes:

  • on-host-maintenance: Indica si la VM finaliza o las migraciones en vivo durante el mantenimiento del host.
  • automatic-restart: Si este valor es TRUE, la VM se reinicia de forma automática después de un evento de mantenimiento o una falla.
  • preemptible: Si este valor es TRUE, la instancia es interrumpible. Este valor se establece cuando creas una VM y no se puede cambiar.

Para obtener más información sobre las opciones de programación, consulta Establece políticas de disponibilidad de instancias.

service-accounts/

Un directorio de cuentas de servicio asociadas a la VM. Para cada cuenta de servicio, está disponible la siguiente información:

  • aliases
  • email: La dirección de correo electrónico de la cuenta de servicio.
  • identity: Un token web JSON que es único de la VM. Debes incluir el parámetro audience en tu solicitud para el valor de metadatos de esta VM. Por ejemplo, ?audience=http://www.example.com.

    Para obtener información sobre cómo solicitar y verificar tokens de identidad de instancia, consulta Verifica identidad de VM.

  • scopes: Los niveles de acceso asignados a la cuenta de servicio.
  • token: El token de acceso OAuth2 que se puede usar para autenticar aplicaciones.

    Para obtener información sobre los tokens de acceso, consulta Autentica aplicaciones directamente con tokens de acceso.

Para obtener más información sobre cómo Compute Engine usa cuentas de servicio, consulta Cuentas de servicio.

tags

Enumera todas las etiquetas de red asociadas a la VM.

Para obtener más información sobre las etiquetas de red, consulta Agrega etiquetas de red.

zone La zona en la que se encuentra la VM Este valor tiene el siguiente formato: projects/PROJECT_NUM/zones/ZONE

Atributos de la instancia

Los atributos de instancias se almacenan en el siguiente directorio:

  • http://metadata.google.internal/computeMetadata/v1/instance/attributes/
Entrada de metadatos Descripción
physical_host

Una string de hash que representa la ubicación de una VM creada con una política de posición de compactación.

Para obtener más información sobre este atributo, consulta Verifica la ubicación física de una VM.

enable-oslogin

Habilita o inhabilita la administración de claves SSH en tu VM.

Para obtener más información sobre el acceso al SO, consulta Configura el Acceso al SO.

enable-windows-ssh

Habilita o inhabilita SSH para las VMs de Windows.

Para obtener más información, consulta Conéctate a las VMs de Windows mediante SSH.

vmdnssetting

Habilita el DNS zonal y el DNS global para la VM.

Para obtener más información sobre los nombres de DNS internos, consulta DNS interno.

ssh-keys

Si administras Llaves SSH con metadatos, este atributo te permite configurar claves SSH públicas que pueden conectarse a las VM de este proyecto. Si hay varias claves SSH, cada una estará separada por un carácter de salto de línea (\n). El valor del atributo ssh-keys es una string.

Ejemplo: "user1:ssh-rsa mypublickey user1@host.com\nuser2:ssh-rsa mypublickey user2@host.com"

Las claves SSH administradas por el acceso al SO no son visibles en los metadatos.

Atributos de invitado de instancias

Los atributos de invitado de instancias se almacenan en el siguiente directorio:

  • http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes
Entrada de metadatos Descripción
guestInventory/

Almacena el inventario del SO para la VM.

Recopila y almacena información de SO. Esto incluye información como el nombre de host, la versión de kernel, la arquitectura y los detalles de paquetes instalados.

Para obtener más información sobre el inventario del SO, consulta Visualiza los detalles del sistema operativo.

hostkeys/

Almacena claves del host SSH. Las claves de host se pueden usar para identificar un host o una máquina en particular.

Para obtener información sobre las claves de host, consulta Almacena claves de host mediante la habilitación de los atributos de invitado.

Próximos pasos