Visualizza l’uso dell’AMI - Amazon Elastic Compute Cloud

Visualizza l’uso dell’AMI

Se condividi le tue Amazon Machine Image (AMI) con altri account Account AWS (sia con account Account AWS specifici, organizzazioni, unità organizzative (OU) o pubblicamente), puoi vedere come vengono usate queste AMI creando report sull’uso delle AMI. I report danno visibilità su:

  • Quali Account AWS usano le tue AMI nelle istanze EC2 o nei modelli di avvio

  • Quante istanze o quanti modelli di avvio EC2 fanno riferimento a ciascuna AMI

I report sull’uso delle AMI ti aiutano a gestire le tue AMI in modo più efficace aiutandoti a:

  • Identificare gli account Account AWS e i tipi di risorse che fanno riferimento alle tue AMI in modo da poter annullare la registrazione o disabilitarle in tutta sicurezza.

  • Identificare le AMI non utilizzate per annullare la registrazione in modo da ridurre i costi di archiviazione.

  • Identificare le AMI più utilizzate.

Come funzionano i report sull’uso delle AMI

Per creare un report sull’uso AMI, specifica:

  • L’AMI da includere nel report.

  • Gli Account AWS da controllare (account specifici o tutti gli account).

  • I tipi di risorsa da controllare (istanze EC2, 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 che usano l’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 EC2 elimina automaticamente un report 30 giorni dopo la sua creazione. Puoi scaricare i report dalla console EC2 per mantenerli 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 report dalla console EC2.

Console
Per creare un report sull’utilizzo dell’AMI
  1. Aprire la console Amazon EC2 all'indirizzo https://console.aws.amazon.com/ec2/.

  2. Nel riquadro di navigazione scegliere AMIs (AMI).

  3. Seleziona un AMI e scegli Operazioni, Uso dell’AMI, Visualizza il mio utilizzo dell’AMI.

  4. 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.

    2. Per ID account, esegui una delle seguenti operazioni:

      • Scegli Specifica gli ID degli account, quindi seleziona Aggiungi ID account per ogni account da includere nel report.

      • Scegli Includi tutti gli account per generare un report su tutti gli account.

    3. Seleziona Crea il mio report sull’utilizzo dell’AMI.

  5. Nella pagina AMI, seleziona la scheda Il mio uso dell’AMI.

  6. 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 comando create-image-usage-report con i seguenti parametri obbligatori:

  • --image-id: l’ID dell’AMI da includere nel report.

  • --resource-types: i tipi di risorse da controllare. Nel seguente esempio, i tipi di risorse da controllare sono le istanze EC2 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

Usa il comando describe-image-usage-reports e specifica l’ID del report.

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

Usa il cmdlet New-EC2ImageUsageReport con i seguenti parametri obbligatori:

  • -ImageId: l’ID dell’AMI da includere nel report.

  • -ResourceType: i tipi di risorse da controllare. Nel seguente esempio, i tipi di risorse da controllare sono le istanze EC2 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

Utilizza il comando Get-EC2ImageUsageReport e specifica l’ID del report.

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 EC2 elimina automaticamente un report 30 giorni dopo la sua creazione.

Per ogni report, puoi vedere gli Account AWS che usano 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. Aprire la console Amazon EC2 all'indirizzo https://console.aws.amazon.com/ec2/.

  2. Nel riquadro di navigazione scegliere AMIs (AMI).

  3. Selezionare un'AMI.

  4. 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.

  5. Scegli l’ID di un report per visualizzare il suo contenuto.

  6. 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

Utilizza il comando describe-image-usage-reports 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 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

Usa il comando describe-image-usage-report-entries e specifica 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.

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

Usa il cmdlet Get-EC2ImageUsageReport e specifica 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

Usa il cmdlet Get-EC2ImageUsageReportEntry 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.

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

Usa il cmdlet Get-EC2ImageUsageReportEntry e specifica 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 EC2 elimina 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. Aprire la console Amazon EC2 all'indirizzo https://console.aws.amazon.com/ec2/.

  2. Nel riquadro di navigazione scegliere AMIs (AMI).

  3. Selezionare un'AMI.

  4. Scegli la scheda Il mio uso dell’AMI.

  5. 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 comando delete-image-usage-report e specifica l’ID del report.

aws ec2 delete-image-usage-report --report-id amiur-0123456789abcdefg
PowerShell
Per eliminare un report sull’utilizzo dell’AMI

Usa il cmdlet Remove-EC2ImageUsageReport e specifica 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.

Descrizione Quota
Report sull’utilizzo dell’AMI in corso (pending) per Account AWS 100
Report sull’utilizzo dell’AMI in corso (pending) per AMI 1