Ogni voce di metadati viene archiviata sul server dei metadati come coppia chiave-valore in coppia. Le chiavi dei metadati sono sensibili alle maiuscole. Le chiavi possono essere predefinite o chiavi di metadati personalizzate.
Le chiavi dei metadati predefinite sono chiavi di metadati create da Compute Engine.
Quando crei una VM, Compute Engine imposta automaticamente
i valori dei metadati per alcune di queste chiavi su quella VM, ad esempio la VM
l'ID istanza o l'ID progetto. Per le chiavi predefinite in cui Compute Engine
impostare automaticamente un valore, puoi scegliere tra una serie di valori disponibili
a seconda della configurazione del sistema.
Per
Ad esempio, per abilitare OS Login per una VM, puoi impostare il valore enable-oslogin
chiave predefinita TRUE
per quella VM. Per disabilitare OS Login per quella VM, puoi aggiornare
il valore della chiave per FALSE
.
Puoi aggiornare solo i valori per queste chiavi, ma non le chiavi stesse.
Questo documento fornisce informazioni sulle chiavi di metadati predefinite che
Compute Engine fornisce nei tuoi metadati instance/
e project/
.
Per informazioni su come vengono definiti, classificati e organizzati i metadati delle VM per Compute Engine, consulta Informazioni sui metadati della VM.
Chiavi dei metadati di progetto predefinite
Le chiavi dei metadati predefinite per i metadati di progetto sono archiviate in quanto segue directory:
http://metadata.google.internal/computeMetadata/v1/project/
La tabella seguente fornisce un elenco di chiavi e directory di metadati che
Compute Engine crea automaticamente nella directory dei metadati project/
:
Voce dei metadati | Descrizione |
---|---|
attributes/ |
Una directory di valori di metadati personalizzati passati alle VM nel tuo durante l'avvio o l'arresto. Questi valori personalizzati possono attributi di Google Cloud o valori dei metadati creati dall'utente. Per un elenco di attributi Google Cloud a livello di progetto che puoi impostare, consulta Attributi del progetto. Per ulteriori informazioni sull'impostazione di metadati personalizzati, consulta Imposta metadati personalizzati. |
numeric-project-id |
L'ID progetto numerico (numero di progetto)
dell'istanza, che non corrisponde
del progetto visibile nella console Google Cloud. Questo valore
è diverso dal valore della voce dei metadati project-id .
|
project-id |
L'ID del progetto. |
Chiavi dei metadati degli attributi di progetto predefinite
Le chiavi dei metadati predefinite per gli attributi di progetto sono archiviate in quanto segue directory:
http://metadata.google.internal/computeMetadata/v1/project/attributes/
La tabella seguente fornisce un elenco delle chiavi di metadati che Compute Engine
crea automaticamente nella directory dei metadati project/attributes/
:
Voce dei metadati | Descrizione |
---|---|
disable-legacy-endpoints |
Disabilita gli endpoint del server di metadati legacy per tutte le VM nel tuo progetto. Gli endpoint legacy sono deprecati, sempre impostati
|
enable-guest-attributes |
Imposta gli attributi guest per il progetto. Gli attributi guest sono valori di metadati delle istanze VM personalizzate che puoi utilizzare per pubblicare notifiche di stato non frequenti, dati di volume ridotto o dati sulla frequenza. Questi valori sono utili per indicare quando si avvia gli script sono stati completati o hanno fornito altri stati poco frequenti ad altre applicazioni. Per ulteriori informazioni sull'ospite vedere gli attributi Imposta ed esegui query sugli attributi guest. |
enable-os-inventory |
Attiva o disattiva l'inventario del sistema operativo per il progetto. Raccoglie e archivia le informazioni sul sistema operativo. Sono incluse le informazioni come nome host, versione kernel, architettura e pacchetti installati. Per ulteriori informazioni sull'inventario del sistema operativo, consulta Visualizza i dettagli del sistema operativo. |
enable-oslogin |
Attiva o disattiva la gestione delle chiavi SSH nel progetto. Per ulteriori informazioni su OS Login, consulta Configura OS Login. |
enable-windows-ssh |
Attiva o disattiva SSH per le VM Windows. Per ulteriori informazioni, vedi Connettiti alle VM Windows utilizzando SSH. |
google-compute-default-region |
Se impostata, archivia la regione predefinita utilizzata dal progetto.
Per saperne di più sull'impostazione delle regioni predefinite, consulta Regione e zona predefinite. |
google-compute-default-zone |
Se impostata, archivia la zona predefinita utilizzata dal progetto.
Per ulteriori informazioni sull'impostazione di zone predefinite, consulta Regione e zona predefinite. |
ssh-keys |
Se
gestione delle chiavi SSH mediante i metadati,
questo attributo consente di configurare chiavi SSH pubbliche che possono connettersi alle VM
in questo progetto. Se sono presenti più chiavi SSH, ciascuna è separata da
un carattere di nuova riga (
Esempio: Chiavi SSH gestite da OS Login non sono visibili nei metadati. |
sshKeys |
Obsoleta: utilizza ssh-keys .
|
vmdnssetting |
Abilita il DNS di zona e il DNS globale per le VM nel tuo progetto. Per ulteriori informazioni sull'utilizzo dei nomi DNS di zona per le VM, consulta Utilizza il DNS di zona per il tipo di DNS interno. |
Chiavi dei metadati dell'istanza predefinite
Le chiavi dei metadati predefinite per i metadati dell'istanza sono archiviate in quanto segue directory:
http://metadata.google.internal/computeMetadata/v1/instance/
La tabella seguente fornisce un elenco di chiavi e directory di metadati che
Compute Engine crea automaticamente nella directory dei metadati instance/
:
Voce dei metadati | Descrizione |
---|---|
attributes/ |
Una directory di valori di metadati personalizzati passati alla VM durante all'avvio o all'arresto. Questi valori personalizzati possono essere Google Cloud o valori dei metadati creati dall'utente. Per un elenco di attributi Google Cloud a livello di istanza che puoi impostare, consulta Attributi di istanza Per ulteriori informazioni sull'impostazione di metadati personalizzati, consulta Imposta metadati personalizzati. |
cpu-platform |
della VM. Per informazioni sulle piattaforme CPU, consulta Piattaforme CPU. |
description |
La descrizione in testo libero di un'istanza assegnata utilizzando
--description utilizzando Google Cloud CLI o l'API.
|
disks/ |
Una directory di dischi collegati alla VM. Per ogni disco, sono disponibili le seguenti informazioni:
Per ulteriori informazioni sui dischi, consulta Opzioni di archiviazione. |
gce-workload-certificates/ (anteprima) |
Archivia i seguenti endpoint per il carico di lavoro gestito delle identità utilizzate dalle applicazioni in esecuzione nella VM.
Per ulteriori informazioni, vedi Autentica i carichi di lavoro in altri carichi di lavoro tramite mTLS. |
guest-attributes/ |
Imposta gli attributi guest per la VM. Questi valori personalizzati possono essere Google Cloud o valori dei metadati creati dall'utente. Per un elenco di attributi Google Cloud a livello di istanza che puoi impostare, consulta Attributi guest dell'istanza Per ulteriori informazioni sull'ospite vedere gli attributi Imposta ed esegui query sugli attributi guest. |
hostname |
Il nome host della VM. |
id |
L'ID della VM. Si tratta di un ID numerico univoco generato generati da Compute Engine. È utile per identificare le VM se e non utilizzano i nomi delle VM. |
image |
L'immagine del sistema operativo utilizzata dalla VM. Questo valore presenta le seguenti caratteristiche:
formato: projects/IMAGE_PROJECT/global/images/IMAGE_NAME . |
legacy-endpoint-access/ |
Archivia l'elenco degli endpoint legacy. I valori sono 0.1 e
v1beta1 .
|
licenses/ |
Un elenco di ID dei codici licenza utilizzati per allegare le licenze a immagini, snapshot e dischi. |
machine-type |
Il tipo di macchina per questa VM. Questo valore ha il seguente formato:
projects/PROJECT_NUM/machineTypes/MACHINE_TYPE
|
maintenance-event |
Indica se un evento di manutenzione interessa questa VM. Per maggiori informazioni le informazioni, vedi Migrazione live. |
name |
Il nome della VM. |
network-interfaces/ |
Una directory di interfacce di rete. Per ogni interfaccia di rete sono disponibili le seguenti informazioni:
Per ulteriori informazioni sulle interfacce di rete, vedi Panoramica di più interfacce di rete. |
partner-attributes/ (anteprima) |
Una directory contenente spazi dei nomi all'interno dei quali vengono inserite le voci di metadati archiviati. Gli spazi dei nomi vengono creati dai servizi Google Cloud, che utilizzano attributi partner per archiviare le loro configurazioni. Quando ci sono non sono servizi che utilizzano gli attributi partner, la directory è vuota. Ad esempio, identità dei carichi di lavoro gestiti utilizzare attributi partner per le configurazioni. |
preempted |
Un valore booleano che indica se una VM sta per essere prerilasciata. |
scheduling/ |
Imposta le opzioni di pianificazione per la VM. I valori dei metadati di pianificazione includono quanto segue:
Per ulteriori informazioni sulle opzioni di pianificazione, vedi Imposta i criteri di disponibilità delle istanze. |
service-accounts/ |
Una directory di account di servizio associati alla VM. Per ogni di account di servizio, sono disponibili le seguenti informazioni:
Per ulteriori informazioni su come Compute Engine utilizza i servizi gli account, vedi Account di servizio. |
tags |
Elenca tutti i tag di rete associati alla VM. Per ulteriori informazioni sui tag di rete, consulta Aggiungi tag di rete. |
zone |
La zona in cui si trova questa VM. Questo valore ha il seguente formato:
projects/PROJECT_NUM/zones/ZONE
|
Chiavi dei metadati degli attributi dell'istanza predefinite
Le chiavi dei metadati predefinite per gli attributi dell'istanza sono archiviate in quanto segue directory:
http://metadata.google.internal/computeMetadata/v1/instance/attributes/
La tabella seguente fornisce un elenco delle chiavi di metadati che Compute Engine
crea automaticamente nella directory dei metadati instance/attributes/
:
Voce dei metadati | Descrizione |
---|---|
physical_host |
Una stringa hash che rappresenta la posizione di una VM creata con un criterio di posizionamento compatto. Per ulteriori informazioni su questo attributo, consulta Verifica la località fisica di una VM. |
enable-oslogin |
Abilita o disabilita la gestione delle chiavi SSH sulla VM. Per ulteriori informazioni su OS Login, consulta Configura OS Login. |
enable-windows-ssh (Anteprima) |
Attiva o disattiva SSH per le VM Windows. Per ulteriori informazioni, vedi Connettiti alle VM Windows utilizzando SSH. |
enable-workload-certificate (Anteprima) |
Abilita o disabilita le identità dei carichi di lavoro gestiti su una VM. Per ulteriori informazioni, vedi Abilita le identità dei carichi di lavoro gestiti per le singole VM. |
vmdnssetting |
Abilita il DNS di zona e il DNS globale per la VM. Per ulteriori informazioni sull'utilizzo dei nomi DNS di zona per il DNS delle VM, consulta Utilizza il DNS di zona per il tipo di DNS interno. |
ssh-keys |
Se
gestione delle chiavi SSH mediante i metadati,
questo attributo consente di configurare chiavi SSH pubbliche che possono connettersi alle VM
in questo progetto. Se sono presenti più chiavi SSH, ciascuna è separata da
un carattere di nuova riga (
Esempio: Chiavi SSH gestite da OS Login non sono visibili nei metadati. |
Chiavi dei metadati degli attributi ospiti predefinite
Le chiavi dei metadati predefinite per gli attributi guest dell'istanza vengono archiviate nel seguente directory:
http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes/
La tabella seguente fornisce un elenco di chiavi e directory di metadati che
Compute Engine crea automaticamente nei metadati instance/guest-attributes/
directory:
Voce dei metadati | Descrizione |
---|---|
guestInventory/ |
Archivia l'inventario del sistema operativo per la VM. Raccoglie e archivia le informazioni dei dettagli del sistema operativo. Sono incluse le informazioni come nome host, versione kernel, architettura e pacchetti installati. i dettagli. Per ulteriori informazioni sull'inventario del sistema operativo, consulta Visualizza i dettagli del sistema operativo. |
hostkeys/ |
Archivia le chiavi host SSH. Le chiavi host consentono di identificare un particolare dell'host o della macchina. Per informazioni sulle chiavi host, consulta Archiviazione delle chiavi host abilitando gli attributi guest. |
Passaggi successivi
- Scopri di più sui metadati delle VM.
- Scopri come impostare metadati personalizzati.
- Scopri come impostare ed eseguire query sugli attributi guest.
- Scopri come visualizzare ed eseguire query sui metadati della VM.