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à.
# Visualizza l’uso dell’AMI
Se condividi le tue Amazon Machine Images (AMIs) con altri Account AWS, con organizzazioni specifiche Account AWS, unità organizzative (OUs) o pubblicamente, puoi vedere come AMIs vengono utilizzate creando report sull'utilizzo delle AMI. I report danno visibilità su:
+ Quali Account AWS sono le tue istanze in o i tuoi modelli AMIs di lancio EC2
+ Quante EC2 istanze o modelli di avvio fanno riferimento a ogni AMI
I report sull'utilizzo dell'AMI ti aiutano a gestire il tuo in modo AMIs più efficace aiutandoti a:
+ Identifica i tipi di risorse Account AWS e i tipi di risorse a cui fai riferimento AMIs in modo da poter annullare la registrazione o disabilitarla in tutta sicurezza. AMIs
+ Identifica gli elementi inutilizzati AMIs per l'annullamento della registrazione per ridurre i costi di archiviazione.
+ Identifica i più utilizzati. AMIs
**Topics**
+ [Come funzionano i report sull’uso delle AMI](#how-ami-usage-reports-work)
+ [Crea un report sull’utilizzo dell’AMI](#create-ami-usage-reports)
+ [Visualizza i report sull’utilizzo dell’AMI](#view-ami-usage-reports)
+ [Elimina un report sull’utilizzo dell’AMI](#delete-ami-usage-reports)
+ [Quote dei report](#ami-usage-report-quotas)
## Come funzionano i report sull’uso delle AMI
Per creare un report sull’uso AMI, specifica:
+ L’AMI da includere nel report.
+ I Account AWS da controllare (account specifici o tutti gli account).
+ I tipi di risorse da controllare (EC2 istanze, modelli di avvio o entrambi).
+ Per i modelli di avvio, il numero di versioni da controllare (il valore predefinito è rappresentato dalle 20 versioni più recenti).
Amazon EC2 crea un report separato per ogni AMI. Ogni report fornisce:
+ Un elenco degli Account AWS usi dell'AMI.
+ Un conto delle risorse che fanno riferimento all’AMI per tipo di risorsa per account. Nota che per i modelli di avvio, se si fa riferimento a un’AMI in più versioni di un modello di avvio, il conteggio è solo 1.
**Importante**
Quando generi un report sull’utilizzo dell’AMI, potrebbe non contenere l’attività più recente. L’attività delle istanze delle ultime 24 ore e l’attività del modello di avvio degli ultimi giorni potrebbero non apparire nel report.
Amazon elimina EC2 automaticamente un report 30 giorni dopo la creazione. Puoi scaricare i report dalla EC2 console per conservarli localmente.
## Crea un report sull’utilizzo dell’AMI
Per visualizzare come viene usata l’AMI, è necessario innanzitutto creare un report sull’utilizzo dell’AMI, specificando gli account e i tipi di risorse da includere nel report. Dopo aver creato il report, puoi visualizzarne il contenuto. Puoi anche scaricare il rapporto dalla EC2 console.
------
#### [ Console ]
**Per creare un report sull’utilizzo dell’AMI**
1. Apri la EC2 console Amazon all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Nel pannello di navigazione, scegli **AMIs**.
1. Seleziona un AMI e scegli **Operazioni**, **Uso dell’AMI**, **Visualizza il mio utilizzo dell’AMI**.
1. Nella pagina **Crea il mio report dell’AMI**, procedi come segue:
1. Per **Tipi di risorsa**, seleziona uno o più tipi di risorse da includere nel report.
1. In **Add account (Aggiungi account) IDs**, eseguire una delle seguenti operazioni:
+ Scegli **Specificare IDs gli account**, quindi scegli **Aggiungi ID account** per ogni account su cui generare il rapporto.
+ Scegli **Includi tutti gli account** per generare un report su tutti gli account.
1. Seleziona **Crea il mio report sull’utilizzo dell’AMI**.
1. Nella pagina AMI, seleziona la scheda **Il mio uso dell’AMI**.
1. Scegli l’ID di un report per visualizzarne i dettagli.
------
#### [ AWS CLI ]
**Per creare un report sull’utilizzo dell’AMI per un elenco di account**
Usa il [create-image-usage-report](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-image-usage-report.html)comando con i seguenti parametri obbligatori:
+ `--image-id`: l’ID dell’AMI da includere nel report.
+ `--resource-types`: i tipi di risorse da controllare. Nell'esempio seguente, i tipi di risorse da controllare sono EC2 le istanze e i modelli di avvio. Viene specificato anche il numero di versioni del modello di avvio da controllare (`version-depth=100`).
Per creare report su account specifici, usa il parametro `--account-ids` per specificare l’ID di ciascun account da includere nel report.
```
aws ec2 create-image-usage-report \
--image-id ami-0abcdef1234567890 \
--account-ids 111122223333 444455556666 123456789012 \
--resource-types ResourceType=ec2:Instance \
'ResourceType=ec2:LaunchTemplate,ResourceTypeOptions=[{OptionName=version-depth,OptionValues=100}]'
```
**Per creare un report sull’uso dell’AMI di tutti gli account**
Per includere nel report tutti gli account che utilizzano l’AMI specificata, usa lo stesso comando ma ometti il parametro `--account-ids`.
```
aws ec2 create-image-usage-report \
--image-id ami-0abcdef1234567890 \
--resource-types ResourceType=ec2:Instance \
'ResourceType=ec2:LaunchTemplate,ResourceTypeOptions=[{OptionName=version-depth,OptionValues=100}]'
```
Di seguito è riportato un output di esempio.
```
{
"ReportId": "amiur-00b877d192f6b02d0"
}
```
**Per monitorare lo stato della creazione del report**
Utilizzate il [describe-image-usage-reports](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-reports.html)comando e specificate l'ID del rapporto.
```
aws ec2 describe-image-usage-reports --report-ids amiur-00b877d192f6b02d0
```
Di seguito è riportato un output di esempio. Il valore iniziale del campo `State` è `pending`. Per poter visualizzare le voci del report, lo stato deve essere `available`.
```
{
"ImageUsageReports": [
{
"ImageId": "ami-0e9ae3dc21c2b3a64",
"ReportId": "amiur-abcae3dc21c2b3999",
"ResourceTypes": [
{"ResourceType": "ec2:Instance"}
],
"State": "pending",
"CreationTime": "2025-09-29T13:27:12.322000+00:00",
"ExpirationTime": "2025-10-28T13:27:12.322000+00:00"
}
]
}
```
------
#### [ PowerShell ]
**Per creare un report sull’utilizzo dell’AMI per un elenco di account**
Utilizzare il [New-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2ImageUsageReport.html)cmdlet con i seguenti parametri obbligatori:
+ `-ImageId`: l’ID dell’AMI da includere nel report.
+ `-ResourceType`: i tipi di risorse da controllare. Nell'esempio seguente, i tipi di risorse da controllare sono le EC2 istanze e i modelli di avvio. Viene specificato anche il numero di versioni del modello di avvio da controllare (`'version-depth' = 100`).
Per creare report su account specifici, usa il parametro `-AccountId` per specificare l’ID di ciascun account da includere nel report.
```
New-EC2ImageUsageReport `
-ImageId ami-0abcdef1234567890 `
-AccountId 111122223333 444455556666 123456789012 `
-ResourceType @(
@{ResourceType = 'ec2:Instance'},
@{ResourceType = 'ec2:LaunchTemplate'ResourceTypeOptions = @{'version-depth' = 100}
})
```
**Per creare un report sull’uso dell’AMI di tutti gli account**
Per includere nel report tutti gli account che utilizzano l’AMI specificata, usa lo stesso comando ma ometti il parametro `-AccountId`.
```
New-EC2ImageUsageReport `
-ImageId ami-0abcdef1234567890 `
-ResourceType @(
@{ResourceType = 'ec2:Instance'},
@{ResourceType = 'ec2:LaunchTemplate'ResourceTypeOptions = @{'version-depth' = 100}
})
```
Di seguito è riportato un output di esempio.
```
ReportId
--------
amiur-00b877d192f6b02d0
```
**Per monitorare lo stato della creazione del report**
Utilizzate il [Get-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReport.html)comando e specificate l'ID del rapporto.
```
Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0
```
Di seguito è riportato un output di esempio. Il valore iniziale del campo `State` è `pending`. Per poter visualizzare le voci del report, lo stato deve essere `available`.
```
ImageUsageReports
-----------------
{@{ImageId=ami-0e9ae3dc21c2b3a64; ReportId=amiur-abcae3dc21c2b3999; ResourceTypes=System.Object[]; State=pending; CreationTime=2025-09-29; ExpirationTime=2025-10-28}}
```
------
## Visualizza i report sull’utilizzo dell’AMI
Puoi visualizzare tutti i report sull’utilizzo creati per un’AMI negli ultimi 30 giorni. Amazon elimina EC2 automaticamente un report 30 giorni dopo la creazione.
Per ogni rapporto, puoi vedere le persone Account AWS che utilizzano l'AMI e, per ogni account, un conteggio delle risorse che fanno riferimento all'AMI per tipo di risorsa. Puoi inoltre vedere quando è stata avviata la creazione del report. Queste informazioni sono disponibili soltanto quando il report è nello stato **Completo** (console) o `available` (AWS CLI).
**Importante**
Quando generi un report sull’utilizzo dell’AMI, potrebbe non contenere l’attività più recente. L’attività delle istanze delle ultime 24 ore e l’attività del modello di avvio degli ultimi giorni potrebbero non apparire nel report.
------
#### [ Console ]
**Per visualizzare un report sull’utilizzo dell’AMI**
1. Apri la EC2 console Amazon all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Nel pannello di navigazione, scegli **AMIs**.
1. Selezionare un'AMI.
1. Seleziona la scheda **I miei report sull’utilizzo**.
La lista dei report mostra:
+ Tutti i report generati negli ultimi 30 giorni per l’AMI selezionata.
+ Per ogni report, la colonna **Ora di avvio del report** mostra la data di creazione del report.
1. Scegli l’ID di un report per visualizzare il suo contenuto.
1. Per tornare alla scheda **I miei report sull’utilizzo** nella pagina dei dettagli dell’AMI, scegli **Visualizza tutti i report per questa AMI**.
------
#### [ AWS CLI ]
**Per elencare tutti i report sull’utilizzo dell’AMI per l’AMI specificata**
Usa il [describe-image-usage-reports](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-reports.html)comando e specifica l'ID dell'AMI per ottenere un elenco dei suoi report.
```
aws ec2 describe-image-usage-reports --image-ids ami-0abcdef1234567890
```
Di seguito è riportato un output di esempio. Ogni ID del report è inserito nell’elenco insieme ai tipi di risorse sottoposti a scansione e alle date di creazione e scadenza del report. Puoi usare queste informazioni per identificare i report di cui desideri visualizzare le voci.
```
{
"ImageUsageReports": [
{
"ImageId": "ami-0abcdef1234567890",
"ReportId": "amiur-1111111111111111",
"ResourceTypes": [
{
"ResourceType": "ec2:Instance"
}
],
"State": "available",
"CreationTime": "2025-09-29T13:27:12.322000+00:00",
"ExpirationTime": "2025-10-28T13:27:12.322000+00:00",
"Tags": []
},
{
"ImageId": "ami-0abcdef1234567890",
"ReportId": "amiur-22222222222222222",
"ResourceTypes": [
{
"ResourceType": "ec2:Instance"
},
{
"ResourceType": "ec2:LaunchTemplate"
}
],
"State": "available",
"CreationTime": "2025-10-01T13:27:12.322000+00:00",
"ExpirationTime": "2025-10-30T13:27:12.322000+00:00",
"Tags": []
}
],
"NextToken": "opaque"
}
```
**Per visualizzare il contenuto di un report sull’utilizzo dell’AMI per l’AMI specificata**
Usa il comando [describe-image-usage-report-entries](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-report-entries.html) e specifica l'ID dell'AMI. La risposta restituisce tutti i report per l’AMI specificata, mostrando gli account che hanno usato l’AMI e il relativo numero di risorse.
```
aws ec2 describe-image-usage-report-entries --image-ids ami-0abcdef1234567890
```
Di seguito è riportato un output di esempio.
```
{
"ImageUsageReportEntries": [
{
"ImageId": "ami-0abcdef1234567890",
"ResourceType": "ec2:Instance",
"AccountId": "123412341234",
"UsageCount": 15,
"ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
"ReportId": "amiur-1111111111111111"
},
{
"ImageId": "ami-0abcdef1234567890",
"ResourceType": "ec2:Instance",
"AccountId": "123412341234",
"UsageCount": 2,
"ReportCreationTime": "2025-10-01T13:27:12.322000+00:00",
"ReportId": "amiur-22222222222222222"
},
{
"ImageId": "ami-0abcdef1234567890",
"ResourceType": "ec2:Instance",
"AccountId": "001100110011",
"UsageCount": 39,
"ReportCreationTime": "2025-10-01T13:27:12.322000+00:00",
"ReportId": "amiur-22222222222222222"
}
],
"NextToken": "opaque"
}
```
**Per visualizzare il contenuto di un report sull’utilizzo dell’AMI per il report specificato**
Utilizzate il comando [describe-image-usage-report-entries](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-report-entries.html) e specificate l'ID del rapporto. La risposta restituisce tutte le voci del report specificato, mostrando gli account che hanno usato l’AMI e il relativo numero di risorse.
```
aws ec2 describe-image-usage-report-entries --report-ids amiur-11111111111111111
```
Di seguito è riportato un output di esempio.
```
{
"ImageUsageReportEntries": [
{
"ImageId": "ami-0abcdef1234567890",
"ResourceType": "ec2:Instance",
"AccountId": "123412341234",
"UsageCount": 15,
"ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
"ReportId": "amiur-11111111111111111"
},
{
"ImageId": "ami-0abcdef1234567890",
"ResourceType": "ec2:LaunchTemplate",
"AccountId": "123412341234",
"UsageCount": 4,
"ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
"ReportId": "amiur-11111111111111111"
},
{
"ImageId": "ami-0abcdef1234567890",
"ResourceType": "ec2:LaunchTemplate",
"AccountId": "001100110011",
"UsageCount": 2,
"ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
"ReportId": "amiur-11111111111111111"
}
],
"NextToken": "opaque"
}
```
------
#### [ PowerShell ]
**Per elencare tutti i report sull’utilizzo dell’AMI per l’AMI specificata**
Utilizzare il [Get-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReport.html)cmdlet e specificare l'ID dell'AMI per ottenere un elenco dei relativi report.
```
Get-EC2ImageUsageReport -ImageId ami-0abcdef1234567890
```
Di seguito è riportato un output di esempio. Ogni ID del report è inserito nell’elenco insieme ai tipi di risorse sottoposti a scansione e alle date di creazione e scadenza del report. Puoi usare queste informazioni per identificare i report di cui desideri visualizzare le voci.
```
@{
ImageUsageReports = @(
@{
ImageId = "ami-0abcdef1234567890"
ReportId = "amiur-1111111111111111"
ResourceTypes = @(
@{
ResourceType = "ec2:Instance"
}
)
State = "available"
CreationTime = "2025-09-29T13:27:12.322000+00:00"
ExpirationTime = "2025-10-28T13:27:12.322000+00:00"
},
@{
ImageId = "ami-0abcdef1234567890"
ReportId = "amiur-22222222222222222"
ResourceTypes = @(
@{
ResourceType = "ec2:Instance"
}
)
State = "available"
CreationTime = "2025-09-30T13:27:12.322000+00:00"
ExpirationTime = "2025-10-29T13:27:12.322000+00:00"
},
@{
ImageId = "ami-0abcdef1234567890"
ReportId = "amiur-33333333333333333"
ResourceTypes = @(
@{
ResourceType = "ec2:Instance"
}
)
State = "available"
CreationTime = "2025-10-01T13:27:12.322000+00:00"
ExpirationTime = "2025-10-30T13:27:12.322000+00:00"
}
)
NextToken = "opaque"
}
```
**Per visualizzare il contenuto di un report sull’utilizzo dell’AMI per l’AMI specificata**
Utilizzare il [Get-EC2ImageUsageReportEntry](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReportEntry.html)cmdlet e specificare l'ID dell'AMI. La risposta restituisce tutti i report per l’AMI specificata, mostrando gli account che hanno usato l’AMI e il relativo numero di risorse.
```
Get-EC2ImageUsageReportEntry -ImageId ami-0abcdef1234567890
```
Di seguito è riportato un output di esempio.
```
ImageUsageReportEntries : {@{
ImageId = "ami-0abcdef1234567890"
ResourceType = "ec2:Instance"
AccountId = "123412341234"
UsageCount = 15
ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
ReportId = "amiur-1111111111111111"
}, @{
ImageId = "ami-0abcdef1234567890"
ResourceType = "ec2:Instance"
AccountId = "123412341234"
UsageCount = 7
ReportCreationTime = "2025-09-30T13:27:12.322000+00:00"
ReportId = "amiur-22222222222222222"
}...}
NextToken : opaque
```
**Per visualizzare il contenuto di un report sull’utilizzo dell’AMI per il report specificato**
Utilizzare il [Get-EC2ImageUsageReportEntry](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReportEntry.html)cmdlet e specificare l'ID del report. La risposta restituisce tutte le voci del report specificato, mostrando gli account che hanno usato l’AMI e il relativo numero di risorse.
```
Get-EC2ImageUsageReportEntry -ReportId amiur-11111111111111111
```
Di seguito è riportato un output di esempio.
```
ImageUsageReportEntries : {@{
ImageId = "ami-0abcdef1234567890"
ResourceType = "ec2:Instance"
AccountId = "123412341234"
UsageCount = 15
ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
ReportId = "amiur-11111111111111111"
}, @{
ImageId = "ami-0abcdef1234567890"
ResourceType = "ec2:LaunchTemplate"
AccountId = "123412341234"
UsageCount = 4
ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
ReportId = "amiur-11111111111111111"
}, @{
ImageId = "ami-0abcdef1234567890"
ResourceType = "ec2:LaunchTemplate"
AccountId = "************"
UsageCount = 2
ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
ReportId = "amiur-11111111111111111"
}}
NextToken : opaque
```
------
## Elimina un report sull’utilizzo dell’AMI
Amazon elimina EC2 automaticamente un report 30 giorni dopo la sua creazione. Puoi eliminarlo manualmente prima di allora.
------
#### [ Console ]
**Per eliminare un report sull’utilizzo dell’AMI**
1. Apri la EC2 console Amazon all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Nel pannello di navigazione, scegli **AMIs**.
1. Selezionare un'AMI.
1. Scegli la scheda **Il mio uso dell’AMI**.
1. Seleziona il pulsante di opzione accanto al report da eliminare e quindi scegli **Elimina**.
------
#### [ AWS CLI ]
**Per eliminare un report sull’utilizzo dell’AMI**
Usa il [delete-image-usage-report](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-image-usage-report.html)comando e specifica l'ID del rapporto.
```
aws ec2 delete-image-usage-report --report-id amiur-0123456789abcdefg
```
------
#### [ PowerShell ]
**Per eliminare un report sull’utilizzo dell’AMI**
Utilizzare il [Remove-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2ImageUsageReport.html)cmdlet e specificare l'ID del report.
```
Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg
```
------
## Quote dei report
Le seguenti quote si applicano alla creazione dei report sull’utilizzo dell’AMI. Le quote si applicano per Regione AWS.
| Description | Quota |
| --- | --- |
| Report sull'utilizzo dell'AMI in corso (pending) per Account AWS | 2.000 |
| Report sull’utilizzo dell’AMI in corso (pending) per AMI | 1 |