Visualizza l'utilizzo 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 forniscono visibilità su:

• Che Account AWS utilizzano i vostri modelli AMIs di EC2 istanze o di lancio

• 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'utilizzo delle AMI

Quando crei un rapporto sull'utilizzo dell'AMI, specifichi:

• L'AMI su cui riferire.

• 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 è costituito dalle 20 versioni più recenti).

Amazon EC2 crea un report separato per ogni AMI. Ogni rapporto fornisce:

• Un elenco degli Account AWS usi dell'AMI.

• Un conteggio delle risorse che fanno riferimento all'AMI per tipo di risorsa per account. Tieni presente che per i modelli di avvio, se si fa riferimento a un AMI in più versioni di un modello di lancio, il conteggio è solo 1.

Importante

Quando generi un rapporto 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 rapporto.

Amazon elimina EC2 automaticamente un report 30 giorni dopo la creazione. Puoi scaricare i report dalla EC2 console per conservarli localmente.

Crea un rapporto sull'utilizzo dell'AMI

Per visualizzare come viene utilizzata l'AMI, è necessario innanzitutto creare un rapporto sull'utilizzo dell'AMI, specificando gli account e i tipi di risorse su cui effettuare il rapporto. Una volta creato il report, è possibile visualizzarne il contenuto. Puoi anche scaricare il rapporto dalla EC2 console.

Console

Per creare un rapporto 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 Azioni, Utilizzo AMI, Visualizza il mio utilizzo dell'AMI.

4. Nella pagina Crea il mio rapporto sull'utilizzo dell'AMI, procedi come segue:

   1. Per Tipi di risorse, seleziona uno o più tipi di risorse su cui generare rapporti.

   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 report su tutti gli account.

   3. Scegli Crea il mio rapporto sull'utilizzo dell'AMI.

5. Nella pagina AMI, scegli la scheda Utilizzo della mia AMI.

6. Scegli un ID del rapporto per visualizzarne i dettagli.

AWS CLI

Per creare un rapporto sull'utilizzo dell'AMI per un elenco di account

Utilizzate il create-image-usage-reportcomando con i seguenti parametri obbligatori:

• --image-id— L'ID dell'AMI su cui effettuare il rapporto.

• --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. Inoltre, viene specificato anche il numero di versioni del modello di avvio da controllare (version-depth=100).

Per creare report su account specifici, utilizzate il --account-ids parametro per specificare l'ID di ciascun account su cui effettuare il rapporto.

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 rapporto sull'utilizzo dell'AMI di tutti gli account

Per generare report su tutti gli account che utilizzano l'AMI specificato, usa lo stesso comando ma ometti il --account-ids parametro.

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 di creazione del report

Usa il describe-image-usage-reportscomando e specifica 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 State campo èpending. Per poter visualizzare le voci del rapporto, lo stato deve essereavailable.

{
    "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 rapporto sull'utilizzo dell'AMI per un elenco di account

Utilizzare il New-EC2ImageUsageReportcmdlet con i seguenti parametri obbligatori:

• -ImageId— L'ID dell'AMI su cui effettuare il rapporto.

• -ResourceType— I tipi di risorse da controllare. Nell'esempio seguente, i tipi di risorse da controllare sono EC2 le istanze e i modelli di avvio. Inoltre, viene specificato anche il numero di versioni del modello di avvio da controllare ('version-depth' = 100).

Per creare report su account specifici, utilizzate il -AccountId parametro per specificare l'ID di ciascun account su cui effettuare il rapporto.

New-EC2ImageUsageReport `
    -ImageId ami-0abcdef1234567890 `
    -AccountId 111122223333 444455556666 123456789012 `
    -ResourceType @(
        @{ResourceType = 'ec2:Instance'},
        @{ResourceType = 'ec2:LaunchTemplate'ResourceTypeOptions = @{'version-depth' = 100}
        })

Per creare un rapporto sull'utilizzo dell'AMI di tutti gli account

Per generare report su tutti gli account che utilizzano l'AMI specificato, usa lo stesso comando ma ometti il -AccountId parametro.

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 di creazione del report

Usa il Get-EC2ImageUsageReportcomando e specifica l'ID del rapporto.

Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0

Di seguito è riportato un output di esempio. Il valore iniziale del State campo èpending. Per poter visualizzare le voci del rapporto, lo stato deve essereavailable.

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 che hai creato 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 anche vedere quando è stata avviata la creazione del report. Queste informazioni sono disponibili solo quando il report è nello stato Completo (console) o available (AWS CLI).

Importante

Quando generi un rapporto 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 rapporto.

Console

Per visualizzare un rapporto 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 I miei report di utilizzo.

   L'elenco dei report mostra:

   • Tutti i report generati negli ultimi 30 giorni per l'AMI selezionata.

   • Per ogni rapporto, la colonna Ora di avvio del rapporto mostra la data di creazione del rapporto.

5. Scegli l'ID di un rapporto per visualizzarne il contenuto.

6. Per tornare alla scheda I miei report di utilizzo nella pagina dei dettagli dell'AMI, scegli Visualizza tutti i report per questo AMI.

AWS CLI

Per elencare tutti i report sull'utilizzo dell'AMI per l'AMI specificato

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 viene elencato insieme ai tipi di risorse analizzati e alle date di creazione e scadenza del report. È possibile utilizzare queste informazioni per identificare i report di cui si desidera 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 rapporto sull'utilizzo dell'AMI per l'AMI specificato

Usa il comando describe-image-usage-report-entries e specifica l'ID dell'AMI. La risposta restituisce tutti i report per l'AMI specificato, mostrando gli account che hanno utilizzato 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 rapporto sull'utilizzo dell'AMI per il rapporto specificato

Utilizzate il comando describe-image-usage-report-entries e specificate l'ID del rapporto. La risposta restituisce tutte le voci del rapporto specificato, mostrando gli account che hanno utilizzato 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 specificato

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 viene elencato insieme ai tipi di risorse analizzati e alle date di creazione e scadenza del report. È possibile utilizzare queste informazioni per identificare i report di cui si desidera 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 rapporto sull'utilizzo dell'AMI per l'AMI specificato

Utilizzare il Get-EC2ImageUsageReportEntrycmdlet e specificare l'ID dell'AMI. La risposta restituisce tutti i report per l'AMI specificato, mostrando gli account che hanno utilizzato 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 rapporto sull'utilizzo dell'AMI per il rapporto specificato

Utilizzare il Get-EC2ImageUsageReportEntrycmdlet e specificare l'ID del report. La risposta restituisce tutte le voci del rapporto specificato, mostrando gli account che hanno utilizzato 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

Eliminare un rapporto sull'utilizzo dell'AMI

Amazon elimina EC2 automaticamente un report 30 giorni dopo la sua creazione. Puoi eliminarlo manualmente prima di quel momento.

Console

Per eliminare un rapporto 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 Utilizzo di My AMI.

5. Scegli il pulsante di opzione accanto al rapporto da eliminare, quindi scegli Elimina.

AWS CLI

Per eliminare un rapporto 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 rapporto sull'utilizzo dell'AMI

Utilizzare il Remove-EC2ImageUsageReportcmdlet e specificare l'ID del report.

Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg