Claves de metadatos predefinidas


Cada entrada de metadatos se almacena en el servidor de metadatos como pares clave-valor. Las claves de metadatos distinguen mayúsculas de minúsculas. Tus claves pueden ser claves predefinidas o personalizadas de metadatos.

Las claves de metadatos predefinidas son claves de metadatos que crea Compute Engine. Cuando creas una VM, Compute Engine configura automáticamente los valores de metadatos para algunas de estas claves en esa VM, por ejemplo, el ID de instancia de VM o el ID del proyecto. En el caso de las claves predefinidas en las que Compute Engine no establece automáticamente un valor, puedes elegir entre un conjunto de valores que están disponibles según la configuración del sistema. Por ejemplo, para habilitar el Acceso al SO para una VM, puedes configurar el valor de la clave predefinida enable-oslogin como TRUE para esa VM. Para inhabilitar el Acceso al SO para esa VM, puedes actualizar el valor de la clave a FALSE. Solo puedes actualizar los valores de estas claves, pero no las claves en sí.

En este documento, se proporciona información sobre las claves de metadatos predefinidas que proporciona Compute Engine en los directorios de metadatos instance/ y project/.

Para obtener información sobre cómo se definen, clasifican y organizan los metadatos de VMs de Compute Engine, consulta Información sobre los metadatos de VMs.

Claves de metadatos del proyecto predefinidas

Las claves de metadatos predefinidas para los metadatos del proyecto se almacenan en el siguiente directorio:

  • http://metadata.google.internal/computeMetadata/v1/project/

En la siguiente tabla, se proporciona una lista de claves y directorios de metadatos que Compute Engine crea de forma automática en el directorio de metadatos 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.

Claves de metadatos de atributos del proyecto predefinidas

Las claves de metadatos predefinidas para los atributos del proyecto se almacenan en el siguiente directorio:

  • http://metadata.google.internal/computeMetadata/v1/project/attributes/

En la siguiente tabla, se proporciona una lista de claves de metadatos que Compute Engine crea de forma automática en el directorio de metadatos 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 del SO. Esto incluye información como el nombre de host, la versión de kernel, la arquitectura y los 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 más información sobre el uso de nombres DNS zonales para las VMs, consulta Usa DNS Zonal para tu tipo de DNS interno.

Claves de metadatos de instancia predefinidos

Las claves de metadatos predefinidas para los metadatos de la instancia se almacenan en el siguiente directorio:

  • http://metadata.google.internal/computeMetadata/v1/instance/

En la siguiente tabla, se proporciona una lista de claves y directorios de metadatos que Compute Engine crea de forma automática en el directorio de metadatos 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.

gce-workload-certificates/(vista previa)

Almacena los siguientes extremos para el atributo de identidades de cargas de trabajo administradas que usan las aplicaciones que se ejecutan en la VM.

  • config-status: Contiene los errores en los valores de configuración que se proporcionan a través de los metadatos de la VM.
  • workload-identities: Contiene las identidades administradas por el plano de control de Compute Engine. Este extremo contiene el certificado X.509 y la clave privada para el dominio de confianza de la VM.
  • trust-anchors: Contiene un conjunto de certificados de confianza para la validación de la cadena de certificados del par X.509.

Para obtener más información, consulta Autentica cargas de trabajo en otras cargas de trabajo a través de mTLS.

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.

partner-attributes/(vista previa)

Directorio que contiene los espacios de nombres en los que se almacenan las entradas de metadatos. Los servicios de Google Cloud crean los espacios de nombres, que utilizan atributos de socio para almacenar sus configuraciones. Cuando no hay servicios que usen los atributos asociados, el directorio está vacío.

Por ejemplo, las identidades de carga de trabajo administradas usan atributos de socios para su configuración.

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 la identidad de una 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

Claves de metadatos de atributos de instancia predefinidas

Las claves de metadatos predefinidas para los atributos de instancia se almacenan en el siguiente directorio:

  • http://metadata.google.internal/computeMetadata/v1/instance/attributes/

En la siguiente tabla, se proporciona una lista de claves de metadatos que Compute Engine crea de forma automática en el directorio de metadatos 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 (vista previa)

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.

enable-workload-certificate (vista previa)

Habilita o inhabilita las identidades de cargas de trabajo administradas en una VM.

Para obtener más información, consulta Habilita identidades de carga de trabajo administradas para VMs individuales.

vmdnssetting

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

Para obtener más información sobre el uso de nombres DNS zonales para tus VMs de DNS, consulta Usa DNS zonal para tu tipo de 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.

Claves de metadatos de atributos de invitado predefinidas

Las claves de metadatos predefinidas para los atributos de invitado de instancias se almacenan en el siguiente directorio:

  • http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes/

En la siguiente tabla, se proporciona una lista de claves y directorios de metadatos que Compute Engine crea de forma automática en el directorio de metadatos 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