Utilizzo dei dati utente dell'istanza

È possibile utilizzare i dati utente dell'istanza per personalizzare le istanze. Quando avvii un'istanza, puoi memorizzare parametri o script come dati utente. Tutti gli script nei dati utente vengono eseguiti all'avvio dell'istanza. È possibile visualizzare i dati utente come attributo dell'istanza. Puoi anche visualizzare i dati utente dell'istanza tramite il servizio di metadati di istanza (IMDS).

Considerazioni

• I dati utente vengono considerati dati opachi, ovvero i dati forniti saranno i dati visualizzati e disponibili. Il modo in cui viene interpretato dipende dall'istanza.

• I dati utente devono essere codificati con base64. La console Amazon EC2 può eseguire automaticamente la codifica con base64 oppure accettare input codificati con base64.

• I dati dell'utente sono limitati a 16 KB, in formato raw, prima della codifica base 64. La dimensione di una stringa di lunghezza n dopo la codifica base64 è ceil(n/3)*4.

• I dati utente devono essere decodificati con base64 quando li recuperi. Se recuperi i dati utilizzando i metadati dell'istanza o la console, vengono decodificati automaticamente.

• Se arresti un'istanza, ne modifichi i dati utente e quindi avvii l'istanza, i dati utente aggiornati non vengono eseguiti automaticamente quando si avvia l'istanza. Con le istanze Windows, è possibile configurare le impostazioni in modo che gli script di dati utente aggiornati vengano eseguiti una sola volta all'avvio dell'istanza o ogni volta che si riavvia o si riavvia l'istanza.

• I dati utente sono un attributo dell'istanza. Se si crea un'AMI da un'istanza, i dati utente dell'istanza non vengono inclusi nell'AMI.

Specifica dei dati utente dell'istanza all'avvio

Puoi specificare i dati utente dell'istanza al momento dell'avvio di un'istanza. Per le indicazioni per la console, consulta Specifica dei dati utente dell'istanza all'avvio. Per un esempio di Linux che utilizza il AWS CLI, vedi. I dati dell'utente e il AWS CLI Per un esempio di Windows che utilizza gli strumenti per Windows PowerShell, vedereDati utente e strumenti per Windows PowerShell.

Modifica dei dati utente dell'istanza

È possibile modificare i dati utente per le istanze con un volume root EBS. L'istanza deve essere nello stato stopped (arrestato). Per le indicazioni per la console, consulta Visualizzazione e aggiornamento dei dati utente dell'istanza. Per un esempio di Linux che utilizza il AWS CLI, vedi modify-instance-attribute. Per un esempio di Windows che utilizza gli strumenti per Windows, vedere. PowerShell Dati utente e strumenti per Windows PowerShell

Recupero dei dati utente dell'istanza dall'istanza

Nota

Negli esempi riportati in questa sezione viene utilizzato l'indirizzo IPv4 del servizio di metadati dell'istanza (IMDS): 169.254.169.254. Se si recuperano i metadati per le istanze EC2 tramite l'indirizzo IPv6, accertarsi invece di abilitare e utilizzare l'indirizzo IPv6: [fd00:ec2::254]. L'indirizzo IPv6 del servizio di metadati dell'istanza (IMDS) è compatibile con i comandi IMDSv2. L'indirizzo IPv6 è accessibile solo su istanze create sul sistema AWS Nitro e in una sottorete supportata da IPv6 (dual stack o solo IPv6).

Per recuperare i dati utente da un'istanza, utilizza il seguente URI.

http://169.254.169.254/latest/user-data

Una richiesta di dati utente restituisce i dati nel formato originale (tipo di contenuto application/octet-stream). Se l'istanza non dispone di dati utente, la richiesta restituisce 404 - Not Found.

Questo esempio restituisce i dati utente specificati come testo separato da virgola.

Linux

IMDSv2

[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/user-data
1234,john,reboot,true | 4512,richard, | 173,,,

IMDSv1

[ec2-user ~]$ curl http://169.254.169.254/latest/user-data
1234,john,reboot,true | 4512,richard, | 173,,,

Windows

IMDSv2

PS C:\> [string]$token = Invoke-RestMethod -Headers @{"X-aws-ec2-metadata-token-ttl-seconds" = "21600"} -Method PUT -Uri http://169.254.169.254/latest/api/token

PS C:\> Invoke-RestMethod -Headers @{"X-aws-ec2-metadata-token" = $token} -Method GET -Uri http://169.254.169.254/latest/user-data
1234,john,reboot,true | 4512,richard, | 173,,,

IMDSv1

PS C:\> Invoke-RestMethod -Headers @{"X-aws-ec2-metadata-token" = Invoke-RestMethod -Headers @{"X-aws-ec2-metadata-token-ttl-seconds" = "21600"} `
-Method PUT -Uri http://169.254.169.254/latest/api/token} -Method GET -uri http://169.254.169.254/latest/user-data
1234,john,reboot,true | 4512,richard, | 173,,,

Questo esempio restituisce i dati utente specificati come script.

Linux

IMDSv2

[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/user-data
#!/bin/bash
yum update -y
service httpd start
chkconfig httpd on

IMDSv1

[ec2-user ~]$ curl http://169.254.169.254/latest/user-data
#!/bin/bash
yum update -y
service httpd start
chkconfig httpd on

Windows

IMDSv2

PS C:\> [string]$token = Invoke-RestMethod -Headers @{"X-aws-ec2-metadata-token-ttl-seconds" = "21600"} -Method PUT -Uri http://169.254.169.254/latest/api/token

PS C:\> Invoke-RestMethod -Headers @{"X-aws-ec2-metadata-token" = $token} -Method GET -Uri http://169.254.169.254/latest/user-data
<powershell>
$file = $env:SystemRoot + "\Temp\" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
</powershell>
<persist>true</persist>

IMDSv1

PS C:\> Invoke-RestMethod -uri http://169.254.169.254/latest/user-data
<powershell>
$file = $env:SystemRoot + "\Temp\" + (Get-Date).ToString("MM-dd-yy-hh-mm")
New-Item $file -ItemType file
</powershell>
<persist>true</persist>

Recupero dei dati utente per un'istanza dal tuo computer

È possibile recuperare i dati utente per un'istanza dal tuo computer. Per le indicazioni per la console, consulta Visualizzazione e aggiornamento dei dati utente dell'istanza. Per un I dati dell'utente e il AWS CLI esempio che utilizza il, vedi. AWS CLI Per un esempio che utilizza gli strumenti per Windows PowerShell, vedereDati utente e strumenti per Windows PowerShell.