Chiavi dei metadati predefinite

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 dei 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 per le quali Compute Engine non imposta automaticamente un valore, puoi scegliere tra un insieme di valori disponibili a seconda della configurazione del sistema. Ad esempio, per attivare l'accesso al sistema operativo per una VM, puoi impostare il valore della chiave predefinita enable-oslogin su TRUE per la VM in questione. 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 dei metadati predefinite fornite da Compute Engine nelle directory dei 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 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 dei 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 degli attributi Google Cloud a livello di progetto che puoi impostare, consulta Attributi 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 di metadati project-id.
project-id L'ID 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 di chiavi dei metadati che Compute Engine crea automaticamente nella directory dei metadati project/attributes/:

Voce dei metadati Descrizione
disable-legacy-endpoints

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

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

enable-guest-attributes

Imposta gli attributi guest per il progetto.

Gli attributi guest sono valori dei metadati delle istanze VM personalizzate che puoi utilizzare per pubblicare notifiche di stato infrequenti, dati a basso volume o a bassa frequenza. Questi valori sono utili per indicare quando si avvia script sono stati completati o per aver 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 memorizza 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, consulta Connettersi alle VM Windows tramite SSH.

google-compute-default-region Se impostato, 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 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 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, ogni chiave è separata da un carattere di a capo (\n). Il valore dell'attributo ssh-keys è una stringa.

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

Chiavi SSH gestite da OS Login non sono visibili nei metadati.

sshKeys Obsolete: utilizza ssh-keys.
vmdnssetting

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

Per ulteriori informazioni sull'utilizzo di 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 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 dei metadati personalizzati passati alla VM durante l'avvio o l'arresto. Questi valori personalizzati possono essere Google Cloud o valori dei metadati creati dall'utente.

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

Per ulteriori informazioni sull'impostazione dei metadati personalizzati, consulta Impostare i metadati personalizzati.
cpu-platform

alla piattaforma CPU della VM.

Per informazioni sulle piattaforme CPU, consulta Piattaforme CPU.
description La descrizione in testo libero di un'istanza assegnata utilizzando il flag --description tramite l'API o Google Cloud CLI.
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, 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.

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

Per maggiori informazioni, consulta Autenticare i carichi di lavoro con 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 da Compute Engine. È utile per identificare le VM se e non utilizzano nomi di 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/ Memorizza l'elenco degli endpoint legacy. I valori sono 0.1 e v1beta1.
licenses/ Un elenco di ID codice licenza utilizzati per associare le licenze a immagini, istantanee 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 Eseguire la 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 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, le identità dei carichi di lavoro gestiti utilizzano gli attributi partner per le loro configurazioni.

preempted

Un valore booleano che indica se una VM sta per essere precettata.
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 se viene eseguita 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 ulteriori informazioni sulle opzioni di pianificazione, consulta Impostare 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:

  • aliases
  • email: l'indirizzo email dell'account di servizio.
  • identity: un token JSON Web 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à delle istanze, consulta Verificare l'identità della VM.

  • scopes: gli ambiti di accesso assegnati al servizio .
  • token: il Token di accesso OAuth2 utilizzabile per l'autenticazione diverse applicazioni.

    Per informazioni sui token di accesso, consulta Autenticazione delle applicazioni direttamente con i token di accesso.

Per ulteriori informazioni su come Compute Engine utilizza gli account di servizio, consulta Account di servizio.

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 delle istanze sono archiviate nella seguente directory:

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

La tabella seguente fornisce un elenco di chiavi dei 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

Attiva o disattiva 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, consulta Connettersi alle VM Windows tramite SSH.

enable-workload-certificate (Anteprima)

Abilita o disabilita le identità dei carichi di lavoro gestiti su una VM.

Per maggiori informazioni, consulta Abilitare le identità di carico di lavoro gestite per le singole VM.
vmdnssetting

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

Per ulteriori informazioni sull'utilizzo di 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 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.

Chiavi dei metadati degli attributi ospiti predefinite

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

Voce dei metadati Descrizione
guestInventory/

Archivia l'inventario del sistema operativo per la VM.

Raccoglie e memorizza informazioni dettagliate sul 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