Valori predefiniti dei metadati della VM

Compute Engine definisce un insieme di voci di metadati predefinite che forniscono informazioni sull'istanza o sul progetto di una macchina virtuale (VM). I metadati predefiniti sono sempre definiti e impostati dal server. Le chiavi dei metadati predefinite sono sensibili alle maiuscole.

Per informazioni sull'esecuzione di query sui valori dei metadati, consulta Eseguire query sui metadati delle VM.

Come sono organizzati i valori dei metadati

  • Metadati di progetto e istanza: i metadati possono essere assegnati sia a progetti sia a VM. I metadati del progetto si propagano a tutte le VM all'interno di un progetto, mentre i metadati dell'istanza si applicano solo a una singola VM.

  • Elenchi di directory: alcune voci di metadati sono directory che contengono altre chiavi di metadati. Questa differenza è contrassegnata da una barra finale nel nome dei metadati. Ad esempio, attributes/ è una directory che contiene altre chiavi di metadati.

Metadati del progetto

Le voci dei metadati del progetto sono archiviate nella seguente directory:

  • http://metadata.google.internal/computeMetadata/v1/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 attributi Google Cloud o valori di metadati creati dall'utente.

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

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

Attributi del progetto

Gli attributi del progetto sono archiviati nella seguente directory:

  • http://metadata.google.internal/computeMetadata/v1/project/attributes/
Voce di metadati Descrizione
disable-legacy-endpoints

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

Gli endpoint legacy sono deprecati. Imposta sempre disable-legacy-endpoints=TRUE.

enable-guest-attributes

Imposta gli attributi guest per il progetto.

Gli attributi guest sono valori di metadati di istanze VM personalizzati 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 non frequenti ad altre applicazioni.

Per saperne di più sugli attributi guest, consulta Impostare ed eseguire query sugli attributi guest.

enable-os-inventory

Abilita o disabilita l'inventario del sistema operativo per il progetto.

Raccoglie e archivia le informazioni sui dettagli del sistema operativo. Sono incluse informazioni quali nome host, versione del kernel, architettura e dettagli dei pacchetti installati.

Per maggiori informazioni sull'inventario del sistema operativo, consulta la pagina Visualizzare i dettagli del sistema operativo.

enable-oslogin

Abilita o disabilita la gestione delle chiavi SSH nel progetto.

Per maggiori informazioni su OS Login, consulta la pagina Configurare OS Login.

enable-windows-ssh

Abilita o disabilita SSH per le VM Windows.

Per saperne di più, consulta Connettersi alle VM Windows tramite 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 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 consente di configurare chiavi SSH pubbliche che possono connettersi alle VM in questo progetto. Se sono presenti più chiavi SSH, ciascuna 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 maggiori informazioni sui nomi DNS interni, consulta DNS interno.

Metadati delle istanze VM

Le voci di metadati della VM sono archiviate nella seguente directory:

  • http://metadata.google.internal/computeMetadata/v1/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 attributi Google Cloud o valori di metadati creati dall'utente.

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

Per maggiori informazioni sull'impostazione di metadati personalizzati, consulta Impostare metadati personalizzati.
cpu-platform

la piattaforma CPU della VM.

Per informazioni sulle piattaforme CPU, consulta la pagina relativa alle piattaforme CPU.
description La descrizione in testo libero di un'istanza assegnata tramite il flag --description mediante Google Cloud CLI o l'API.
disks/

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

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

Per ulteriori informazioni sui dischi, vedi Opzioni di archiviazione.

guest-attributes/

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

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

Per saperne di più sugli attributi guest, consulta Impostare ed eseguire 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. Questo è utile per identificare le VM se non utilizzi i nomi delle VM.
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/ Archivia l'elenco degli endpoint legacy. I valori sono 0.1 e v1beta1.
licenses/ Un elenco di ID dei codici licenza utilizzati per collegare 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 ulteriori informazioni, consulta 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 saperne di più sulle interfacce di rete, consulta la panoramica su più interfacce di rete.

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:

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

Per maggiori informazioni sulle opzioni di pianificazione, consulta la pagina Impostare i criteri di disponibilità delle istanze.

service-accounts/

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

  • aliases
  • email: l'indirizzo email dell'account di servizio.
  • identity: un token web JSON univoco per la VM. Devi includere il parametro audience nella richiesta per 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, consulta Verificare l'identità delle VM.

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

    Per informazioni sui token di accesso, consulta la pagina relativa all' autenticazione delle applicazioni direttamente con i token di accesso.

Per saperne di più su come Compute Engine utilizza gli account di servizio, consulta Account di servizio.

tags

Elenca tutti i tag di rete associati alla VM.

Per ulteriori informazioni sui tag di rete, consulta la pagina Aggiungere tag di rete.

zone La zona in cui si trova la VM. Questo valore ha il seguente formato: projects/PROJECT_NUM/zones/ZONE

Attributi dell'istanza

Gli attributi dell'istanza sono archiviati nella seguente directory:

  • http://metadata.google.internal/computeMetadata/v1/instance/attributes/
Voce di metadati Descrizione
physical_host

Una stringa hash che rappresenta la località di una VM creata con un criterio di posizionamento compatto.

Per maggiori informazioni su questo attributo, consulta Verificare la località fisica di una VM.

enable-oslogin

Abilita o disabilita la gestione delle chiavi SSH sulla VM.

Per maggiori informazioni su OS Login, consulta la pagina Configurare OS Login.

enable-windows-ssh

Abilita o disabilita SSH per le VM Windows.

Per saperne di più, consulta Connettersi alle VM Windows tramite SSH.

vmdnssetting

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

Per maggiori informazioni sui nomi DNS interni, consulta DNS interno.

ssh-keys

Se gestisci le chiavi SSH utilizzando 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 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.

Attributi guest dell'istanza

Gli attributi guest dell'istanza sono archiviati nella directory seguente:

  • http://metadata.google.internal/computeMetadata/v1/instance/guest-attributes
Voce di metadati Descrizione
guestInventory/

Archivia l'inventario del sistema operativo per la VM.

Raccoglie e archivia le informazioni sui dettagli del sistema operativo. Sono incluse informazioni quali nome host, versione del kernel, architettura e dettagli dei pacchetti installati.

Per maggiori informazioni sull'inventario del sistema operativo, consulta la pagina Visualizzare i dettagli del sistema operativo.

hostkeys/

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

Per informazioni sulle chiavi host, consulta la pagina relativa all'archiviazione delle chiavi host tramite l'attivazione degli attributi guest.

Che cosa succede dopo?