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

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

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

  2. Nel pannello di navigazione, scegli AMIs.

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

    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 create-image-usage-reportcomando 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-reportscomando 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-EC2ImageUsageReportcmdlet 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-EC2ImageUsageReportcomando 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/.

  2. Nel pannello di navigazione, scegli AMIs.

  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

Usa il describe-image-usage-reportscomando 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

Utilizzate il comando describe-image-usage-report-entries 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-EC2ImageUsageReportcmdlet 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-EC2ImageUsageReportEntrycmdlet 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-EC2ImageUsageReportEntrycmdlet 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/.

  2. Nel pannello di navigazione, scegli AMIs.

  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 delete-image-usage-reportcomando 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-EC2ImageUsageReportcmdlet 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