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
|
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 ( Ejemplo: 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:
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.
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:
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:
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:
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 ( Ejemplo: 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
- Obtén más información sobre los metadatos de VM.
- Obtén información para establecer metadatos personalizados.
- Aprende a configurar y consultar atributos de invitado.
- Obtén información sobre cómo ver y consultar metadatos de VM.