Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Utilizzo dei metadati dell'istanza per gestire l'istanza EC2
I metadati dell'istanza sono dati relativi all'istanza che puoi utilizzare per configurare o gestire un'istanza in esecuzione. I metadati dell'istanza includono quanto segue:
- Proprietà dei metadati dell'istanza
-
I metadati dell'istanza sono suddivisi in categorie, ad esempio, nome host, eventi e gruppi di sicurezza.
- Dati dinamici
-
I dati dinamici sono metadati generati all'avvio dell'istanza, ad esempio un documento di identità dell'istanza. Per ulteriori informazioni, consulta Categorie dei dati dinamici.
- Dati utente
-
Puoi anche utilizzare i metadati dell'istanza per accedere ai dati utente da te specificati quando un'istanza viene avviata. Ad esempio, puoi specificare i parametri per configurare l'istanza o includere un semplice script. Inoltre, puoi creare AMI generiche e utilizzare i dati utente per modificare i file di configurazione forniti all'avvio. Ad esempio, se esegui server Web per delle piccole attività commerciali, tutte potranno utilizzare la stessa AMI generica e recuperare i loro contenuti dal bucket Amazon S3 specificato nei dati utente all'avvio. Per aggiungere un nuovo cliente in qualsiasi momento, crea un bucket per il cliente, aggiungi il relativo contenuto e avvia l'AMI con il nome bucket univoco fornito al codice nel dati utente. Se avvii più di un'istanza alla volta utilizzando la stessa chiamata
RunInstances, i dati utente sono disponibili per tutte le istanze presenti all'interno della prenotazione. Ogni istanza che fa parte della stessa prenotazione dispone di un numeroami-launch-indexunivoco che consente di scrivere il codice che controlla ciò che fa l'istanza. Ad esempio, il primo host potrebbe scegliere se stesso come nodo originale in un cluster. Per un esempio di avvio dell'AMI dettagliato, consulta Identificazione di ciascuna istanza lanciata in una singola richiesta.
Importante
Anche se puoi accedere ai metadati dell'istanza e ai dati utente solo dall'interno dell'istanza stessa, i dati non sono protetti mediante metodi di autenticazione o crittografia. Chiunque disponga dell'accesso diretto all'istanza, e potenzialmente qualsiasi software in esecuzione sull'istanza, può visualizzare i propri metadati. Pertanto, è opportuno non memorizzare dati sensibili, ad esempio password o chiavi di crittografia di lunga durata, come dati utente.
Indice
Categorie di metadati dell'istanza
Le proprietà dei metadati dell'istanza sono suddivise in categorie. Per recuperare le proprietà dei metadati dell'istanza, specifica la categoria nella richiesta e i metadati verranno restituiti nella risposta.
Quando vengono rilasciate nuove categorie, viene creata una nuova build di metadati di istanza con un nuovo numero di versione. Nella tabella che segue, la colonna Version when category was released (Versione in cui è stata rilasciata la categoria) specifica la versione di build quando è stata rilasciata una categoria di metadati dell'istanza. Per evitare di dover aggiornare il codice ogni volta che Amazon EC2 rilascia una nuova build di metadati dell'istanza, utilizza latest invece del numero di versione nelle richieste di metadati. Per ulteriori informazioni, consulta Recupero delle versioni disponibili dei metadati dell'istanza.
Quando Amazon EC2 rilascia una nuova categoria di metadati dell'istanza, i metadati dell'istanza per la nuova categoria potrebbero non essere disponibili per le istanze esistenti. Con Nitro-based le istanze, puoi recuperare i metadati delle istanze solo per le categorie disponibili al momento del lancio. Per le istanze con l'hypervisor Xen, è possibile arrestare e avviare l'istanza per aggiornare le categorie disponibili.
Nella tabella seguente sono elencate le categorie di metadati dell'istanza. Alcuni dei nomi delle categorie includono segnaposti per i dati univoci dell'istanza. Ad esempio, mac rappresenta l'indirizzo MAC per l'interfaccia di rete. Quando richiami i metadati dell'istanza, devi sostituire i segnaposti con i valori effettivi.
| Categoria | Description | Versione in cui è stata rilasciata la categoria |
|---|---|---|
ami-id
|
ID dell'AMI utilizzata per avviare l'istanza. | 1.0 |
ami-launch-index
|
Se si avviano più istanze utilizzando la stessa chiamata RunInstances, questo valore indica l'ordine di avvio per ciascuna istanza. Il valore della prima istanza avviata è 0. Se avvii istanze utilizzando il dimensionamento automatico o il parco EC2, questo valore è sempre 0. |
1.0 |
ami-manifest-path
|
Percorso del file manifest dell'AMI in Amazon S3. Se hai utilizzato un'Amazon EBS-backed AMI per avviare l'istanza, il risultato restituito èunknown. |
1.0 |
ancestor-ami-ids
|
ID dell'AMI di qualsiasi istanza raggruppata per creare l'AMI corrente. Questo valore esiste solo se il file manifest dell'AMI contiene una chiave ancestor-amis. |
10-10-2007 |
autoscaling/target-lifecycle-state |
Valore che mostra lo stato del ciclo di vita di Auto Scaling di destinazione a cui sta passando un'istanza di Auto Scaling. Presente quando l'istanza passa a uno degli stati del ciclo di vita di destinazione dopo il 10 marzo 2022. Valori possibili: |
15/07/2021 |
block-device-mapping/ami |
Il dispositivo virtuale che contiene il file system. root/boot | 15-12-2007 |
block-device-mapping/ebsN |
Dispositivi virtuali associati a qualsiasi volume Amazon EBS. I volumi Amazon EBS sono disponibili solo nei metadati se erano presenti al momento dell'avvio o quando l'istanza è stata avviata per l'ultima volta. N indica il valore di indice del volume Amazon EBS (ad esempio ebs1 o ebs2). |
15-12-2007 |
block-device-mapping/ephemeralN |
I dispositivi virtuali per qualsiasi volume instance store non NVMe. La N indica l'indice di ogni volume. Il numero di volumi instance store nella mappatura del dispositivo a blocchi potrebbero non corrispondere al numero effettivo dei volumi instance store per l'istanza. Il tipo di istanza determina il numero di volumi instance store disponibili per un'istanza. Se il numero di volumi instance store in una mappatura dei dispositivi a blocchi supera il numero disponibile per un'istanza, i volumi instance store aggiuntivi vengono ignorati. | 15-12-2007 |
block-device-mapping/root
|
Dispositivi o partizioni virtuali associati ai dispositivi o alle partizioni radice sul dispositivo virtuale, dove il file system radice (/ o C:) è associato all'istanza specificata. | 15-12-2007 |
block-device-mapping/swap
|
Dispositivi virtuali associati a swap. Non sempre presenti. |
15-12-2007 |
events/maintenance/history |
Se sono presenti eventi di manutenzione completati o cancellati per l'istanza, contiene una stringa JSON con informazioni sugli eventi. | 17-08-2018 |
events/maintenance/scheduled |
Se sono presenti eventi di manutenzione attivi per l'istanza, contiene una stringa JSON con informazioni sugli eventi. Per ulteriori informazioni, consulta Visualizzare gli eventi pianificati che influiscono sulle istanze Amazon EC2. | 17-08-2018 |
events/recommendations/rebalance |
Ora approssimativa, in UTC, in cui viene emessa la notifica della raccomandazione di ribilanciamento dell'istanza EC2 per l'istanza. Di seguito è riportato un esempio dei metadati per questa categoria: {"noticeTime":
"2020-11-05T08:22:00Z"}. Questa categoria è disponibile solo dopo che la notifica è stata emessa. Per ulteriori informazioni, consulta Raccomandazioni per il ribilanciamento delle istanze EC2. |
27-10-2020 |
hostname |
Se l'istanza EC2 utilizza la IP-based denominazione (IPBN), questo è il nome host DNS IPv4 privato dell'istanza. Se l'istanza EC2 utilizza la Resource-based denominazione (RBN), si tratta dell'RBN. Se sono presenti più interfacce di rete, fa riferimento al dispositivo eth0 (il dispositivo per il quale il numero di dispositivo è 0). Per ulteriori informazioni su IPBN e RBN, consultare Hostname e domini delle istanze EC2. | 1.0 |
iam/info
|
Se all'istanza è associato un ruolo IAM, contiene informazioni sull'ultimo aggiornamento del profilo dell'istanza, inclusa la LastUpdated data dell'istanza e. InstanceProfileArn InstanceProfileId In caso contrario, non presente. | 12-01-2012 |
iam/security-credentials/
|
Se è associato un ruolo IAM all'istanza, role-name è il nome del ruolo e role-name contiene le credenziali di sicurezza temporanee associate al ruolo (per ulteriori informazioni, consultaRecupero delle credenziali di sicurezza dai metadati delle istanze). In caso contrario, non presente. |
12-01-2012 |
identity-credentials/ec2/info |
Informazioni sulle credenziali in identity-credentials/ec2/security-credentials/ec2-instance. |
23/05/2018 |
identity-credentials/ec2/security-credentials/ec2-instance |
Credenziali per il ruolo di identità dell'istanza che consentono al software sull'istanza di AWS identificarsi per supportare funzionalità come EC2 Instance Connect e AWS Systems Manager Default Host Management Configuration. A queste credenziali non sono associate politiche, quindi non dispongono di autorizzazioni AWS API aggiuntive oltre all'identificazione dell'istanza della funzionalità. AWS Per ulteriori informazioni, consulta Ruoli di identità dell'istanza per le istanze Amazon EC2. | 23/05/2018 |
instance-action |
Comunica all'istanza la necessità di un riavvio in preparazione del processo di raggruppamento. Valori validi: none | shutdown |
bundle-pending. |
01-09-2008 |
instance-id |
ID dell'istanza corrente. | 1.0 |
instance-life-cycle |
L'opzione di acquisto di questa istanza. Per ulteriori informazioni, consulta Opzioni di fatturazione e acquisto di Amazon EC2. | 01-10-2019 |
instance-type
|
Tipo di istanza. Per ulteriori informazioni, consulta Tipi di istanza Amazon EC2. | 29-08-2007 |
ipv6
|
L'indirizzo IPv6 dell'istanza. Se sono presenti più interfacce di rete, fa riferimento all'interfaccia di rete del dispositivo eth0 (il dispositivo per il quale il numero di dispositivo è 0) e al primo indirizzo IPv6 assegnato. Se non esiste un indirizzo IPv6 sull'interfaccia di rete [0], questo elemento non viene impostato e viene restituita una risposta HTTP 404. | 03/01/2021 |
kernel-id
|
ID del kernel avviato con questa istanza, se applicabile. | 01-02-2008 |
local-hostname
|
Se sono presenti più interfacce di rete, fa riferimento al dispositivo eth0 (il dispositivo per il quale il numero di dispositivo è 0). Se l'istanza EC2 utilizza la IP-based denominazione (IPBN), questo è il nome host DNS IPv4 privato dell'istanza. Se l'istanza EC2 utilizza la Resource-based denominazione (RBN), si tratta dell'RBN. Per ulteriori informazioni sulla denominazione delle istanze IPBN, RBN ed EC2, consultare Hostname e domini delle istanze EC2. | 19-01-2007 |
local-ipv4
|
Indirizzo IPv4 privato dell'istanza. Se sono presenti più interfacce di rete, fa riferimento al dispositivo eth0 (il dispositivo per il quale il numero di dispositivo è 0). Se si tratta di un' IPv6-onlyistanza, questo elemento non è impostato e genera una risposta HTTP 404. | 1.0 |
mac
|
Indirizzo MAC (Media Access Control) dell'istanza. Se sono presenti più interfacce di rete, fa riferimento al dispositivo eth0 (il dispositivo per il quale il numero di dispositivo è 0). | 01-01-2011 |
metrics/vhostmd |
Non più disponibile. | 2011-05-01 |
network/interfaces/macs/
|
Numero di dispositivo univoco associato all'interfaccia specificata. Il numero di dispositivo corrisponde al nome del dispositivo, ad esempio device-number pari a 2 indica il dispositivo eth2. Questa categoria corrisponde ai campi DeviceIndex e device-index utilizzati dall'API Amazon EC2 e ai comandi EC2 per AWS CLI. |
01-01-2011 |
network/interfaces/macs/
|
L'ID dell'interfaccia di rete. | 01-01-2011 |
network/interfaces/macs/
|
Indirizzi IPv4 privati associati a ogni indirizzo IP pubblico e assegnati all'interfaccia specificata. | 01-01-2011 |
network/interfaces/macs/ |
Indirizzi IPv6 associati all'interfaccia. | 30-06-2016 |
network/interfaces/macs/ |
Prefissi IPv6 assegnati all'interfaccia di rete. | |
network/interfaces/macs/
|
Il nome host DNS IPv4 privato dell'interfaccia di rete. Questo valore non è impostato per le interfacce prive di indirizzi IP, ad esempio le interfacce. EFA-only Se si tratta di un'IPv6-only interfaccia, questo è il nome basato sulla risorsa. Per ulteriori informazioni su IPBN e RBN, consultare Hostname e domini delle istanze EC2. |
19-01-2007 |
network/interfaces/macs/
|
Indirizzi IPv4 privati associati all'interfaccia. Se si tratta di un'interfaccia IPv6-only di rete, questo elemento non è impostato e genera una risposta HTTP 404. | 01-01-2011 |
network/interfaces/macs/
|
Indirizzo MAC dell'istanza. | 01-01-2011 |
network/interfaces/macs/
|
L'indice della scheda di rete. Alcuni tipi di istanza supportano più schede di rete. | 2020-11-01 |
network/interfaces/macs/
|
ID del proprietario dell'interfaccia di rete. In ambienti con più interfacce, un'interfaccia può essere collegata mediante una terza parte, ad esempio Elastic Load Balancing. Il traffico di un'interfaccia viene sempre addebitato al proprietario dell'interfaccia. | 01-01-2011 |
network/interfaces/macs/
|
DNS pubblico (IPv4) dell'interfaccia. Questa categoria viene restituita solo se l'attributo enableDnsHostnames è impostato su true. Per ulteriori informazioni, consulta Attributi DNS per il VPC nella Guida per l'utente di Amazon VPC. Se l'istanza ha solo un indirizzo IPv6 pubblico e nessun indirizzo IPv4 pubblico, questo elemento non è impostato e restituisce una risposta HTTP 404. |
01-01-2011 |
network/interfaces/macs/
|
L'indirizzo IP pubblico o gli indirizzi IP elastici associati all'interfaccia. In un'istanza possono essere presenti più indirizzi IPv4. | 01-01-2011 |
network/interfaces/macs/
|
Gruppi di sicurezza a cui appartiene l'interfaccia di rete. | 01-01-2011 |
network/interfaces/macs/
|
ID dei gruppi di sicurezza a cui appartiene l'interfaccia di rete. | 01-01-2011 |
network/interfaces/macs/
|
ID della sottorete in cui si trova l'interfaccia di rete. | 01-01-2011 |
network/interfaces/macs/
|
Blocco CIDR IPv4 della sottorete in cui si trova l'interfaccia di rete. | 01-01-2011 |
network/interfaces/macs/
|
Blocco CIDR IPv6 della sottorete in cui si trova l'interfaccia di rete. | 30-06-2016 |
network/interfaces/macs/
|
ID del VPC in cui si trova l'interfaccia di rete. | 01-01-2011 |
network/interfaces/macs/ |
Blocco CIDR IPv4 primario del VPC. | 01-01-2011 |
network/interfaces/macs/ |
Blocchi CIDR IPv4 del VPC. | 30-06-2016 |
network/interfaces/macs/ |
Blocco CIDR IPv6 del VPC in cui si trova l'interfaccia di rete. | 30-06-2016 |
placement/availability-zone |
zona di disponibilità in cui l'istanza è stata avviata. | 01-02-2008 |
placement/availability-zone-id |
ID dell'area di disponibilità statica in cui viene avviata l'istanza. L'ID dell'area di disponibilità è coerente tra gli account. Tuttavia, potrebbe essere diverso dall'area di disponibilità, che può variare in base all'account. | 01-10-2019 |
placement/group-name
|
Nome del gruppo di posizionamento in cui viene avviata l'istanza. | 2020-08-24 |
placement/host-id
|
ID dell'host su cui viene avviata l'istanza. Applicabile solo a Host dedicati. | 2020-08-24 |
placement/partition-number
|
Il numero della partizione in cui viene avviata l'istanza. | 2020-08-24 |
placement/region
|
La AWS regione in cui viene avviata l'istanza. | 2020-08-24 |
product-codes
|
Marketplace AWS eventuali codici di prodotto associati all'istanza. | 01-03-2007 |
public-hostname
|
Il DNS pubblico dell'istanza (IPv4). Questa categoria viene restituita solo se l'attributo enableDnsHostnames è impostato su true. Per ulteriori informazioni, consulta Attributi DNS per il VPC nella Guida per l'utente di Amazon VPC. Se l'istanza ha solo un indirizzo IPv6 pubblico e nessun indirizzo IPv4 pubblico, questo elemento non è impostato e restituisce una risposta HTTP 404. |
19-01-2007 |
public-ipv4
|
Indirizzo IPv4 pubblico. Se un indirizzo IP elastico è associato all'istanza, il valore restituito è l'indirizzo IP elastico. | 19-01-2007 |
public-keys/0/openssh-key
|
Chiave pubblica. Disponibile solo se viene specificato in fase di avvio dell'istanza. | 1.0 |
ramdisk-id
|
ID del disco RAM specificato in fase di avvio, se applicabile. | 10-10-2007 |
reservation-id
|
ID della prenotazione. | 1.0 |
security-groups
|
Nomi dei gruppi di sicurezza applicati all'istanza. Dopo l'avvio puoi modificare i gruppi di sicurezza delle istanze. Tali modifiche sono riportate qui e in network/interfaces /macs/ /security-groups. |
1.0 |
services/domain
|
Il dominio delle risorse per la Regione. AWS |
25-2-2014 |
services/partition
|
Partizione in cui si trova la risorsa. Per AWS le regioni standard, la partizione è |
20-10-2015 |
spot/instance-action
|
Operazione (ibernazione, arresto o terminazione) e orario indicativo, in UTC, in cui si verificherà l'operazione. Questo elemento è presente solo se l'istanza spot è stata contrassegnata per essere ibernata, arrestata o terminata. Per ulteriori informazioni, consulta instance-action. |
15-11-2016 |
spot/termination-time
|
Ora approssimativa, in formato UTC, in cui il sistema operativo dell'istanza spot riceverà il segnale di arresto. Questo elemento è presente e contiene un valore temporale (ad esempio, 2015-01-05T18:02:00Z) solo se l'istanza Spot è stata contrassegnata per la chiusura da Amazon EC2. L'elemento "termination-time" non è impostato su un'ora se termini manualmente l'istanza spot. Per ulteriori informazioni, consulta termination-time. |
05-11-2014 |
system |
Il tipo di virtualizzazione sottostante (hypervisor) dell’istanza. | 24/09/2022 |
tags/instance |
I tag istanza associati all'istanza. Disponibile solo se permetti esplicitamente l'accesso ai tag nei metadati dell'istanza. Per ulteriori informazioni, consulta Abilita l’accesso ai tag nei metadati dell’istanza. | 2021-03-23 |
Categorie dei dati dinamici
Nella tabella seguente sono elencate le categorie dei dati dinamici.
| Categoria | Description | Versione in cui è stata rilasciata la categoria |
|---|---|---|
fws/instance-monitoring
|
Valore che indica se il cliente ha abilitato il monitoraggio dettagliato di un minuto in. CloudWatch Valori validi: enabled |
disabled |
04-04-2009 |
instance-identity/document
|
JSON contenente gli attributi dell'istanza, ad esempio ID istanza, indirizzo IP privato e così via Per informazioni, consulta Documenti di identità dell'istanza per le istanze Amazon EC2. | 04-04-2009 |
instance-identity/pkcs7
|
Utilizzato per verificare l'autenticità e i contenuti del documento in base alla firma. Per informazioni, consulta Documenti di identità dell'istanza per le istanze Amazon EC2. | 04-04-2009 |
instance-identity/signature
|
Dati che possono essere utilizzati da altre parti per verificare la relativa origine e autenticità. Per informazioni, consulta Documenti di identità dell'istanza per le istanze Amazon EC2. | 04-04-2009 |
