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à.
Usa i metadati dell'istanza per gestire l' EC2istanza
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. Puoi anche creare dati generici AMIs e utilizzare dati utente per modificare i file di configurazione forniti al momento del lancio. 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 di istanza, usa latest invece del numero di versione nelle tue 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 le istanze basate sul Sistema Nitro è possibile recuperare i metadati dell'istanza solo per le categorie disponibili al momento dell'avvio. 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 | Descrizione | Versione in cui è stata rilasciata la categoria |
|---|---|---|
ami-id
|
ID dell'AMI utilizzata per avviare l'istanza. | 1 |
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 Auto Scaling EC2 o fleet, questo valore è sempre 0. |
1 |
ami-manifest-path
|
Percorso del file manifest dell'AMI in Amazon S3. Se hai utilizzato un'AMI supportata da Amazon EBS per avviare l'istanza, il valore restituito è unknown. |
1 |
ancestor-ami-ids
|
L'AMI IDs di tutte le istanze che sono state raggruppate per creare questa AMI. 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 |
Dispositivo virtuale contenente il file system radice/di avvio. | 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 tutti i volumi di archiviazione diversi dalle istanze. 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 Visualizza gli eventi pianificati che influiscono sulle tue EC2 istanze Amazon. | 17-08-2018 |
events/recommendations/rebalance |
L'ora approssimativa, in UTC, in cui viene emessa la notifica di raccomandazione di ribilanciamento dell' EC2 istanza 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 EC2 raccomandazioni per il ribilanciamento delle istanze. |
27 ottobre 2020 |
hostname |
Se l' EC2 istanza utilizza la denominazione basata su IP (IPBN), questo è il nome host DNS privato dell'istanza. IPv4 Se l' EC2 istanza utilizza la denominazione basata sulle risorse (RBN), questo è l'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 Tipi di hostname delle EC2 istanze Amazon. | 1 |
iam/info
|
Se all'istanza è associato un ruolo IAM, contiene informazioni sull'ultima volta in cui il profilo dell'istanza è stato aggiornato, inclusa la data dell'istanza, e. LastUpdated InstanceProfileArn InstanceProfileId In caso contrario, non presente. | 12-01-2012 |
iam/security-credentials/
|
Se all'istanza è associato un ruolo IAM, 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 consente al software sull'istanza di AWS identificarsi per supportare funzionalità come Instance EC2 Connect e AWS Systems Manager Default Host Management Configuration. Queste credenziali non hanno policy associate, quindi non dispongono di autorizzazioni AWS API aggiuntive oltre all'identificazione dell'istanza e della funzionalità. AWS Per ulteriori informazioni, consulta Ruoli di identità delle istanze per le EC2 istanze Amazon. | 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 |
instance-life-cycle |
L'opzione di acquisto di questa istanza. Per ulteriori informazioni, consulta Opzioni di EC2 fatturazione e acquisto di Amazon. | 01-10-2019 |
instance-type
|
Tipo di istanza. Per ulteriori informazioni, consulta Tipi di EC2 istanze Amazon. | 29-08-2007 |
ipv6
|
L' IPv6 indirizzo dell'istanza. Nei casi in cui sono presenti più interfacce di rete, ciò si riferisce all'interfaccia di rete del dispositivo eth0 (il dispositivo il cui numero del dispositivo è 0) e al primo IPv6 indirizzo assegnato. Se non esiste alcun IPv6 indirizzo sull'interfaccia di rete [0], questo elemento non è impostato e genera una risposta HTTP 404. | 2021-01-03 |
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'EC2 istanza utilizza la denominazione basata su IP (IPBN), questo è il nome host DNS privato dell'istanza. IPv4 Se l' EC2 istanza utilizza la denominazione basata sulle risorse (RBN), questo è l'RBN. Per ulteriori informazioni su IPBN, RBN e sulla denominazione delle istanze, consulta. EC2 Tipi di hostname delle EC2 istanze Amazon | 19-01-2007 |
local-ipv4
|
L' IPv4 indirizzo 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 una IPv6 sola istanza, questo elemento non è impostato e restituisce una risposta HTTP 404. | 1 |
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 device-index campi DeviceIndex e utilizzati dall' EC2 API Amazon e dai EC2 comandi per AWS CLI. |
01-01-2011 |
network/interfaces/macs/
|
L'ID dell'interfaccia di rete. | 01-01-2011 |
network/interfaces/macs/
|
IPv4 Gli indirizzi privati associati a ciascun indirizzo IP pubblico e assegnati a tale interfaccia. | 01-01-2011 |
network/interfaces/macs/ |
Gli IPv6 indirizzi assegnati all'interfaccia. | 30-06-2016 |
network/interfaces/macs/ |
Il IPv6 prefisso assegnato all'interfaccia di rete. | |
network/interfaces/macs/
|
Il nome host IPv4 DNS 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'istanza di IPv6 sola istanza, questo è il nome basato sulla risorsa. Per ulteriori informazioni su IPBN e RBN, consultare Tipi di hostname delle EC2 istanze Amazon. |
19-01-2007 |
network/interfaces/macs/
|
Gli IPv4 indirizzi privati associati all'interfaccia. Se si tratta di una IPv6 sola interfaccia di rete, questo elemento non è impostato e restituisce 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/
|
Il DNS pubblico dell'interfaccia ()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 IPv6 indirizzo pubblico e nessun IPv4 indirizzo 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. Potrebbero esserci più IPv4 indirizzi su un'istanza. | 01-01-2011 |
network/interfaces/macs/
|
Gruppi di sicurezza a cui appartiene l'interfaccia di rete. | 01-01-2011 |
network/interfaces/macs/
|
I gruppi IDs 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/
|
Il blocco IPv4 CIDR della sottorete in cui risiede l'interfaccia. | 01-01-2011 |
network/interfaces/macs/
|
Il blocco IPv6 CIDR della sottorete in cui risiede l'interfaccia. | 30-06-2016 |
network/interfaces/macs/
|
ID del VPC in cui si trova l'interfaccia di rete. | 01-01-2011 |
network/interfaces/macs/ |
Il blocco IPv4 CIDR principale del VPC. | 01-01-2011 |
network/interfaces/macs/ |
I blocchi IPv4 CIDR per il VPC. | 30-06-2016 |
network/interfaces/macs/ |
Il blocco IPv6 CIDR del VPC in cui risiede l'interfaccia. | 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 lanciata 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 IPv6 indirizzo pubblico e nessun IPv4 indirizzo pubblico, questo elemento non è impostato e genera una risposta HTTP 404. |
19-01-2007 |
public-ipv4
|
L' IPv4 indirizzo 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 |
ramdisk-id
|
ID del disco RAM specificato in fase di avvio, se applicabile. | 10-10-2007 |
reservation-id
|
ID della prenotazione. | 1 |
security-groups
|
Nomi dei gruppi di sicurezza applicati all'istanza. Dopo l'avvio puoi modificare i gruppi di sicurezza delle istanze. Tali modifiche si riflettono qui e innetwork/interfaces/macs/ |
1 |
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 articolo è presente e contiene un valore temporale (ad esempio, 2015-01-05T 18:02:00 Z) 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 |
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 Per consentire l'accesso ai tag nei metadati delle istanze. | 2021-03-23 |
Categorie dei dati dinamici
Nella tabella seguente sono elencate le categorie dei dati dinamici.
| Categoria | Descrizione | Versione in cui è stata rilasciata la categoria |
|---|---|---|
fws/instance-monitoring
|
Valore che indica se il cliente ha abilitato il monitoraggio dettagliato in un minuto. 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à delle istanze per le EC2 istanze Amazon. | 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à delle istanze per le EC2 istanze Amazon. | 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à delle istanze per le EC2 istanze Amazon. | 04-04-2009 |
