Chiavi dei metadati predefinite

Ogni voce di metadati viene archiviata sul server metadati come coppie chiave-valore. Le chiavi dei metadati sono sensibili alle maiuscole. Le chiavi possono essere chiavi dei metadati predefinite o personalizzate.

Le chiavi dei metadati predefinite sono chiavi dei metadati create da Compute Engine. Quando crei una VM, Compute Engine imposta automaticamente i valori dei metadati per alcune di queste chiavi sulla VM, ad esempio l'ID istanza VM o l'ID progetto. Per le chiavi predefinite in cui Compute Engine non imposta automaticamente un valore, puoi scegliere tra un insieme di valori disponibili a seconda della configurazione del sistema. Ad esempio, per abilitare OS Login per una VM, puoi impostare il valore della chiave predefinita enable-oslogin su TRUE per quella VM. Per disattivare OS Login per la VM, puoi aggiornare il valore della chiave a FALSE. Puoi aggiornare solo i valori di queste chiavi, non le chiavi stesse.

Questo documento fornisce informazioni sulle chiavi di metadati predefinite che Compute Engine fornisce nelle directory di metadati instance/ e project/.

Per informazioni su come vengono definiti, classificati e organizzati i metadati delle VM per Compute Engine, consulta Informazioni sui metadati delle VM.

Chiavi dei metadati di progetto predefinite

Le chiavi di metadati predefinite per i metadati del progetto vengono archiviate nella seguente 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 di metadati Descrizione
attributes/

Una directory di valori di metadati personalizzati passati alle VM nel tuo progetto durante l'avvio o l'arresto. Questi valori personalizzati possono essere Google Cloud attributi o valori di metadati creati dall'utente.

Per un elenco degli attributi Google Cloud a livello di progetto che puoi impostare, consulta Attributi dei progetti.

Per ulteriori informazioni sull'impostazione di metadati personalizzati, vedi Impostare metadati personalizzati.
numeric-project-id L'ID progetto numerico (numero di progetto) dell'istanza, che non corrisponde al nome del progetto visibile in Google Cloud console. Questo valore è diverso dal valore della voce di metadati project-id.
project-id L'ID progetto.

Chiavi dei metadati degli attributi di progetto predefinite

Le chiavi di metadati predefinite per gli attributi del progetto vengono archiviate nella seguente directory:

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

La tabella seguente fornisce un elenco di chiavi di metadati che, se impostate per il tuo progetto, Compute Engine crea nella directory dei metadati project/attributes/, insieme al relativo effetto associato:

Voce di metadati Descrizione
disable-legacy-endpoints

Disabilita gli endpoint del server di metadati legacy per tutte le VM del tuo progetto.

Gli endpoint legacy sono obsoleti, imposta sempre disable-legacy-endpoints=TRUE.

enable-guest-attributes

Imposta gli attributi guest per il progetto.

Gli attributi guest sono valori di metadati personalizzati dell'istanza VM che puoi utilizzare per pubblicare notifiche di stato non frequenti, dati a basso volume o dati a bassa frequenza. Questi valori sono utili per indicare quando gli script di avvio sono stati completati o per fornire altre notifiche di stato poco frequenti ad altre applicazioni.

Per ulteriori informazioni sugli attributi guest, vedi Imposta ed esegui query sugli attributi guest.

enable-os-inventory

Attiva o disattiva l'inventario del sistema operativo per il progetto.

Raccoglie e memorizza le informazioni sul sistema operativo. Sono incluse informazioni come nome host, versione del kernel, architettura e pacchetti installati.

Per saperne di più sull'inventario del sistema operativo, vedi Visualizzare i dettagli del sistema operativo.

enable-oslogin

Attiva o disattiva la gestione delle chiavi SSH nel tuo progetto.

Per ulteriori informazioni su OS Login, vedi Configurare OS Login.

enable-windows-ssh

Attiva o disattiva SSH per le VM Windows.

Per ulteriori informazioni, consulta Connettiti alle VM Windows utilizzando SSH.

google-compute-default-data-protection

Se impostata, memorizza l'opzione predefinita utilizzata per il backup delle nuove istanze create nel progetto.

Per maggiori informazioni, vedi Configurare l'impostazione di backup predefinita per la console.
google-compute-default-region Se impostata, memorizza 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 impostato, memorizza la zona predefinita utilizzata dal progetto.

Per saperne di più sull'impostazione delle zone predefinite, consulta Regione e zona predefinite.

ssh-keys

Se gestisci le chiavi SSH utilizzando i metadati, questo attributo ti consente di configurare le chiavi SSH pubbliche che possono connettersi alle VM in questo progetto. Se sono presenti più chiavi SSH, ogni chiave è separata da un carattere di nuova riga (\n). Il valore dell'attributo ssh-keys è una stringa.

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

Le chiavi SSH gestite da OS Login non sono visibili nei metadati.

sshKeys Obsoleto:utilizza ssh-keys.
vmdnssetting

Abilita il DNS di zona e il DNS globale per le VM nel tuo progetto.

Per saperne di più sull'utilizzo dei nomi DNS di zona per le VM, consulta Utilizzare 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 vengono archiviate nella seguente 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 di metadati Descrizione
attributes/

Una directory di valori di metadati personalizzati passati alla VM durante l'avvio o l'arresto. Questi valori personalizzati possono essere Google Cloud attributi o valori di metadati creati dall'utente.

Per un elenco degli attributi Google Cloud a livello di istanza che puoi impostare, consulta Attributi dell'istanza.

Per ulteriori informazioni sull'impostazione di metadati personalizzati, vedi Impostare metadati personalizzati.
cpu-platform

Piattaforma CPU della VM.

Per informazioni sulle piattaforme CPU, consulta Piattaforme CPU.
description La descrizione in formato libero di un'istanza assegnata utilizzando il flag --description utilizzando Google Cloud CLI o l'API.
disks/

Una directory dei dischi collegati alla VM. Per ogni disco sono disponibili le seguenti informazioni:

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

Per saperne di più sui dischi, consulta Opzioni di archiviazione.

gce-workload-certificates/(Anteprima)

Memorizza i seguenti endpoint per la funzionalità di identità del carico di lavoro gestito utilizzata dalle applicazioni in esecuzione nella VM.

  • config-status: contiene eventuali errori nei valori di configurazione forniti tramite i metadati della VM.
  • workload-identities: contiene le identità gestite dal piano di controllo di Compute Engine. Questo endpoint contiene il certificato X.509 e la chiave privata per il dominio di attendibilità della VM.
  • trust-anchors: contiene un insieme di certificati attendibili per la convalida della catena di certificati X.509 peer.

Per maggiori informazioni, consulta Autentica i workload con altri workload tramite mTLS.

guest-attributes/

Imposta gli attributi guest per la VM. Questi valori personalizzati possono essere Google Cloud attributi o valori di metadati creati dall'utente.

Per un elenco degli attributi Google Cloud a livello di istanza che puoi impostare, consulta Attributi guest dell'istanza.

Per ulteriori informazioni sugli attributi guest, vedi 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 da Compute Engine per il tuo progetto e la zona della VM. Puoi utilizzare questo ID per identificare la tua VM, soprattutto se non le hai assegnato un nome personalizzato.
image L'immagine del sistema operativo utilizzata dalla VM. Questo valore ha il seguente formato: projects/IMAGE_PROJECT/global/images/IMAGE_NAME.
legacy-endpoint-access/ Memorizza l'elenco degli endpoint legacy. I valori sono 0.1 e v1beta1.
licenses/ Un elenco di ID dei codici di 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, consulta la sezione 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:

  • access-configs/

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

Per ulteriori informazioni sulle interfacce di rete, consulta Panoramica di più interfacce di rete.

partner-attributes/(Anteprima)

Una directory contenente gli spazi dei nomi in cui sono archiviate le voci di metadati. Gli spazi dei nomi vengono creati dai Google Cloud servizi, che utilizzano gli attributi partner per archiviare le proprie configurazioni. Se non ci sono servizi che utilizzano gli attributi partner, la directory è vuota.

Ad esempio, le identità dei carichi di lavoro gestite utilizzano gli attributi del partner per le loro 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:

  • on-host-maintenance: indica se la VM viene terminata o migrata live durante la manutenzione dell'host.
  • automatic-restart: se questo valore è TRUE, la VM viene riavviata automaticamente dopo un evento di manutenzione o un arresto anomalo.
  • preemptible: se questo valore è TRUE, la VM è preemptible. Questo valore viene impostato quando crei una VM e non può essere modificato.

Per saperne di più sulle opzioni di pianificazione, consulta Impostare i criteri di disponibilità delle istanze.

service-accounts/

Una directory dei service account associati alla VM. Per ogni account di servizio sono disponibili le seguenti informazioni:

  • aliases
  • email: l'indirizzo email del account di servizio.
  • identity: un JSON Web Token univoco per la VM. Devi includere il parametro audience nella richiesta di questo valore dei metadati della VM. Ad esempio: ?audience=http://www.example.com.

    Per informazioni su come richiedere e verificare i token di identità dell'istanza, vedi Verifica dell'identità della VM.

  • scopes: gli ambiti di accesso assegnati al service account.
  • token: il token di accesso OAuth2 che può essere utilizzato per autenticare le applicazioni.

    Per informazioni sui token di accesso, vedi Autenticare le applicazioni direttamente con i token di accesso.

Per ulteriori informazioni su come Compute Engine utilizza i service account, consulta Service account.

tags

Elenca tutti i tag di rete associati alla VM.

Per saperne di più sui tag di rete, consulta Aggiungere 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 nella seguente directory:

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

La seguente tabella fornisce un elenco di chiavi di metadati che, se impostate per la tua istanza, Compute Engine crea nella directory dei metadati instance/attributes/, insieme al relativo effetto:

Voce di metadati Descrizione
physical_host

Una stringa hash che rappresenta la posizione di una VM creata con una policy di posizionamento compatto.

Per ulteriori informazioni su questo attributo, vedi Verificare la posizione fisica di una VM.

enable-oslogin

Attiva o disattiva la gestione delle chiavi SSH sulla VM.

Per ulteriori informazioni su OS Login, vedi Configurare OS Login.

enable-windows-ssh (Anteprima)

Attiva o disattiva SSH per le VM Windows.

Per ulteriori informazioni, consulta Connettiti alle VM Windows utilizzando SSH.

enable-workload-certificate (Anteprima)

Attiva o disattiva le identità dei carichi di lavoro gestite su una VM.

Per maggiori informazioni, vedi Abilitare le identità dei workload gestite per le singole VM.
vmdnssetting

Attiva il DNS di zona e il DNS globale per la VM.

Per saperne di più sull'utilizzo dei nomi DNS di zona per il DNS delle VM, consulta Utilizzare il DNS di zona per il tipo di DNS interno.

ssh-keys

Se gestisci le chiavi SSH utilizzando i metadati, questo attributo ti consente di configurare le chiavi SSH pubbliche che possono connettersi alle VM in questo progetto. Se sono presenti più chiavi SSH, ogni chiave è separata da un carattere di nuova riga (\n). Il valore dell'attributo ssh-keys è una stringa.

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

Le chiavi SSH gestite da OS Login non sono visibili nei metadati.

block-project-ssh-keys

Blocca le chiavi SSH del progetto dalle VM che utilizzano chiavi SSH basate su metadati.

Per saperne di più, consulta Limita le chiavi SSH dalle VM.
disable-https-mds-setup

Disattiva il provisioning automatico dei certificati del server di metadati HTTPS da parte di Compute Engine.

Per saperne di più, vedi Attivare la configurazione automatica dei certificati.
enable-https-mds-native-cert-store

Consente a Compute Engine di aggiungere il certificato radice all'archivio attendibile del sistema operativo durante il provisioning automatico del certificato del server di metadati HTTPS.

Per maggiori informazioni, vedi Attivazione dell'archiviazione dei certificati radice nell'archivio attendibile del sistema operativo.

Chiavi dei metadati degli attributi guest predefiniti

Le chiavi dei metadati predefinite per gli attributi guest dell'istanza vengono archiviate nella 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 nella directory dei metadati instance/guest-attributes/:

Voce di metadati Descrizione
guestInventory/

Memorizza l'inventario del sistema operativo per la VM.

Raccoglie e memorizza informazioni dettagliate sul sistema operativo. Sono incluse informazioni come nome host, versione del kernel, architettura e dettagli dei pacchetti installati.

Per saperne di più sull'inventario del sistema operativo, vedi Visualizzare i dettagli del sistema operativo.

hostkeys/

Memorizza le chiavi host SSH. Le chiavi host possono essere utilizzate per identificare un host o una macchina specifici.

Per informazioni sulle chiavi host, vedi Archiviazione delle chiavi host attivando gli attributi guest.

Passaggi successivi