Cada entrada de metadatos se almacena en el servidor de metadatos como pares clave-valor. Las claves de metadatos distinguen entre mayúsculas y minúsculas. Sus claves pueden ser claves de metadatos predefinidas o personalizadas.
Las claves de metadatos predefinidas son claves de metadatos creadas por Compute Engine. Cuando creas una VM, Compute Engine establece automáticamente los valores de metadatos para algunas de estas claves en esa VM, por ejemplo, el ID de la instancia de la VM o el ID del proyecto. Para las claves predefinidas en las que Compute Engine no establece un valor automáticamente, puedes elegir entre un conjunto de valores que están disponibles según la configuración del sistema.Por ejemplo, para habilitar el inicio de sesión en el sistema operativo para una máquina virtual, puede establecer el valor de la clave predefinida enable-oslogin en TRUE para esa máquina virtual. Para deshabilitar el inicio de sesión del sistema operativo para esa VM, puede actualizar el valor de la clave a FALSE .Solo puede actualizar los valores de estas claves, pero no las claves en sí.
Este documento proporciona información sobre las claves de metadatos predefinidas que Compute Engine proporciona en tus directorios de metadatos instance/ y project/ .
Para obtener información sobre cómo se definen, categorizan y organizan los metadatos de VM para Compute Engine, consulte Acerca de los metadatos de VM .
Claves de metadatos de 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/
La siguiente tabla proporciona una lista de claves y directorios de metadatos que Compute Engine crea automáticamente en el directorio project/ metadatos:
| Entrada de metadatos | Descripción |
|---|---|
attributes/ | Un directorio de valores de metadatos personalizados pasados a las máquinas virtuales de su proyecto durante el inicio o el apagado. Estos valores personalizados pueden ser Google Cloud atributos o valores de metadatos creados por el usuario. Para obtener una lista de niveles de proyecto Google Cloud atributos que puede configurar, consulte Atributos del proyecto . Para obtener más información sobre cómo configurar metadatos personalizados, consulte Establecer metadatos personalizados . |
numeric-project-id | El ID numérico del proyecto (número de proyecto) de la instancia, que no es el mismo que el nombre del proyecto visible en la consola de Google Cloud . Este valor es diferente del valor de entrada de metadatos project-id . |
project-id | El identificador del proyecto . |
Claves de metadatos de atributos de proyecto predefinidos
Las claves de metadatos predefinidas para los atributos del proyecto se almacenan en el siguiente directorio:
-
http://metadata.google.internal/computeMetadata/v1/project/attributes/
La siguiente tabla proporciona una lista de claves de metadatos que Compute Engine crea automáticamente en el directorio project/attributes/ metadatos:
| Entrada de metadatos | Descripción |
|---|---|
disable-legacy-endpoints | Deshabilita los puntos finales del servidor de metadatos heredados para todas las máquinas virtuales de su proyecto. Los puntos finales heredados están en desuso, siempre establezca |
enable-guest-attributes | Establece atributos de invitado para el proyecto. Los atributos de invitado son valores de metadatos de instancia de VM personalizados que puede utilizar 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 los scripts de inicio o para proporcionar otras notificaciones de estado poco frecuentes a otras aplicaciones. Para obtener más información sobre los atributos de los invitados, consulte Establecer y consultar atributos de los invitados . |
enable-os-inventory | Habilita o deshabilita el inventario del sistema operativo para el proyecto. Recopila y almacena información del sistema operativo. Esto incluye información como el nombre de host, la versión del kernel, la arquitectura y los paquetes instalados. Para obtener más información sobre el inventario del sistema operativo, consulte Ver detalles del sistema operativo . |
enable-oslogin | Habilita o deshabilita la administración de claves SSH en su proyecto. Para obtener más información sobre el inicio de sesión en el sistema operativo, consulte Configurar el inicio de sesión en el sistema operativo . |
enable-windows-ssh |
Habilita o deshabilita SSH para máquinas virtuales Windows. Para obtener más información, consulte Conexión a máquinas virtuales Windows mediante SSH . |
google-compute-default-data-protection | Si se establece, almacena la opción predeterminada que se utiliza para realizar copias de seguridad de nuevas instancias creadas en el proyecto. Para obtener más información, consulte Configurar la configuración de copia de seguridad predeterminada para la consola . |
google-compute-default-region | Si se establece, almacena la región predeterminada que utiliza el proyecto. Para obtener más información sobre cómo configurar regiones predeterminadas, consulte Región y zona predeterminadas . |
google-compute-default-zone | Si se establece, almacena la zona predeterminada que utiliza el proyecto. Para obtener más información sobre cómo configurar zonas predeterminadas, consulte Región y zona predeterminadas . |
ssh-keys | Si administra claves SSH mediante metadatos , este atributo le permite configurar claves SSH públicas que pueden conectarse a las máquinas virtuales de este proyecto. Si hay varias claves SSH, cada clave está separada por un carácter de nueva línea ( Ejemplo: Las claves SSH administradas por el inicio de sesión del sistema operativo no son visibles en los metadatos. |
sshKeys | En desuso: utilice ssh-keys . |
vmdnssetting | Habilite el DNS zonal y el DNS global para las máquinas virtuales de su proyecto. Para obtener más información sobre el uso de nombres DNS zonales para sus máquinas virtuales, consulte Usar DNS zonal para su tipo de DNS interno . |
Claves de metadatos de instancia predefinidas
Las claves de metadatos predefinidas, por ejemplo, los metadatos, se almacenan en el siguiente directorio:
-
http://metadata.google.internal/computeMetadata/v1/instance/
La siguiente tabla proporciona una lista de claves y directorios de metadatos que Compute Engine crea automáticamente en el directorio instance/ metadatos:
| Entrada de metadatos | Descripción |
|---|---|
attributes/ | Un directorio de valores de metadatos personalizados pasados a la VM durante el inicio o el apagado. Estos valores personalizados pueden ser Google Cloudatributos o valores de metadatos creados por el usuario. Para obtener una lista de nivel de instancia Google Cloud atributos que puede configurar, consulte Atributos de instancia Para obtener más información sobre cómo configurar metadatos personalizados, consulte Establecer metadatos personalizados . |
cpu-platform | Plataforma CPU de la VM. Para obtener información sobre las plataformas de CPU, consulte Plataformas de CPU . |
description | La descripción de texto libre de una instancia que se asigna mediante el indicador --description mediante la CLI o la API de Google Cloud. |
disks/ | Un directorio de discos que están conectados a la VM. Para cada disco, está disponible la siguiente información:
Para obtener más información sobre los discos, consulte Opciones de almacenamiento . |
gce-workload-certificates/ ( Vista previa ) | Almacena los siguientes puntos finales para la función de identidades de carga de trabajo administradas que utilizan las aplicaciones que se ejecutan en la máquina virtual.
Para obtener más información, consulte Autenticar cargas de trabajo en otras cargas de trabajo a través de mTLS . |
guest-attributes/ | Establece atributos de invitado para la VM. Estos valores personalizados pueden ser Google Cloudatributos o valores de metadatos creados por el usuario. Para obtener una lista de nivel de instancia Google Cloud atributos que puede configurar, consulte Atributos de invitado de instancia Para obtener más información sobre los atributos de los invitados, consulte Establecer y consultar atributos de los invitados . |
hostname | El nombre de host de la VM. |
id | El ID de la máquina virtual. Esta es una identificación numérica única generada por Compute Engine para su proyecto y la zona de la VM. Puede usar este ID para identificar su VM, especialmente si no le ha asignado un nombre personalizado. |
image | La imagen del sistema operativo utilizada por la VM. Este valor tiene el siguiente formato: projects/ IMAGE_PROJECT /global/images/ IMAGE_NAME . |
legacy-endpoint-access/ | Almacena la lista de puntos finales heredados. Los valores son 0.1 y v1beta1 . |
licenses/ | Una lista de ID de códigos de licencia que se utilizan para adjuntar las licencias a imágenes, instantáneas y discos. |
machine-type | El tipo de máquina para 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 máquina virtual. Para obtener más información, consulte Migración en vivo . |
name | El nombre de la máquina virtual. |
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, consulte Descripción general de varias interfaces de red . |
partner-attributes/ ( Vista previa ) | Un directorio que contiene espacios de nombres dentro de los cuales se almacenan las entradas de metadatos. Los espacios de nombres son creados por Google Cloud servicios, que utilizan atributos de socios para almacenar sus configuraciones. Cuando no hay servicios que utilicen los atributos de socio, el directorio está vacío. Por ejemplo, las identidades de carga de trabajo administradas utilizan atributos de socio para sus configuraciones. |
preempted | Un valor booleano que indica si una VM está a punto de ser reemplazada. |
scheduling/ | Establece las opciones de programación para la VM. Los valores de metadatos de programación incluyen lo siguiente:
Para obtener más información sobre las opciones de programación, consulte Establecer políticas de disponibilidad de instancias . |
service-accounts/ | Un directorio de cuentas de servicio asociadas con la VM. Para cada cuenta de servicio, la siguiente información está disponible:
Para obtener más información sobre cómo Compute Engine usa las cuentas de servicio, consulta Cuentas de servicio . |
tags | Enumera las etiquetas de red asociadas con la VM. Para obtener más información sobre las etiquetas de red, consulte Agregar etiquetas de red . |
zone | La zona donde se encuentra esta VM. Este valor tiene el siguiente formato: projects/ PROJECT_NUM /zones/ ZONE |
Claves de metadatos de atributos de instancia predefinidos
Las claves de metadatos predefinidas, por ejemplo, los atributos, se almacenan en el siguiente directorio:
-
http://metadata.google.internal/computeMetadata/v1/instance/attributes/
La siguiente tabla proporciona una lista de claves de metadatos que Compute Engine crea automáticamente en el directorio instance/attributes/ metadatos:
| Entrada de metadatos | Descripción |
|---|---|
physical_host | Una cadena hash que representa la ubicación de una máquina virtual creada con una política de ubicación compacta. Para obtener más información sobre este atributo, consulte Verificar la ubicación física de una VM . |
enable-oslogin | Habilita o deshabilita la administración de claves SSH en su VM. Para obtener más información sobre el inicio de sesión en el sistema operativo, consulte Configurar el inicio de sesión en el sistema operativo . |
enable-windows-ssh ( vista previa ) | Habilita o deshabilita SSH para máquinas virtuales Windows. Para obtener más información, consulte Conexión a máquinas virtuales Windows mediante SSH . |
enable-workload-certificate ( Vista previa ) | Habilita o deshabilita las identidades de cargas de trabajo administradas en una máquina virtual. Para obtener más información, consulte Habilitar identidades de cargas de trabajo administradas para máquinas virtuales individuales . |
vmdnssetting | Habilite el DNS zonal y el DNS global para la máquina virtual. Para obtener más información sobre el uso de nombres DNS zonales para el DNS de sus máquinas virtuales, consulte Usar DNS zonal para su tipo de DNS interno . |
ssh-keys | Si administra claves SSH mediante metadatos , este atributo le permite configurar claves SSH públicas que pueden conectarse a las máquinas virtuales de este proyecto. Si hay varias claves SSH, cada clave está separada por un carácter de nueva línea ( Ejemplo: Las claves SSH administradas por el inicio de sesión del sistema operativo no son visibles en los metadatos. |
block-project-ssh-keys | Bloquee las claves SSH del proyecto de las máquinas virtuales que utilizan claves SSH basadas en metadatos. Para obtener más información, consulte Restringir claves SSH de máquinas virtuales . |
Claves de metadatos de atributos de invitados predefinidos
Las claves de metadatos predefinidas, por ejemplo, los atributos de invitado, se almacenan en el siguiente directorio:
-
http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes/
La siguiente tabla proporciona una lista de claves y directorios de metadatos que Compute Engine crea automáticamente en el directorio instance/guest-attributes/ metadatos:
| Entrada de metadatos | Descripción |
|---|---|
guestInventory/ | Almacena el inventario del sistema operativo para la máquina virtual. Recopila y almacena información detallada del sistema operativo. Esto incluye información como el nombre de host, la versión del kernel, la arquitectura y los detalles de los paquetes instalados. Para obtener más información sobre el inventario del sistema operativo, consulte Ver detalles del sistema operativo . |
hostkeys/ | Almacena claves de host SSH. Las claves de host se pueden utilizar para identificar un host o máquina en particular. Para obtener información sobre claves de host, consulte Almacenamiento de claves de host habilitando atributos de invitado . |
¿Qué sigue?
- Obtenga más información sobre los metadatos de VM .
- Aprenda a configurar metadatos personalizados .
- Aprenda a configurar y consultar atributos de invitados .
- Aprenda a ver y consultar metadatos de VM .