So funktionieren AMI-Nutzungsberichte Einen AMI-Nutzungsbericht erstellen AMI-Nutzungsberichte anzeigen Einen AMI-Nutzungsbericht löschen Berichtskontingente

Ihre AMI-Nutzung anzeigen

Wenn Sie Ihre Amazon Machine Images (AMIs) mit anderen teilen AWS-Konten— sei es mit bestimmten Organisationen AWS-Konten, Organisationseinheiten (OUs) oder öffentlich — können Sie anhand von AMI-Nutzungsberichten sehen, wie diese verwendet AMIs werden. Die Berichte bieten Einblick in:

AWS-Konten Welche verwenden Ihre In-Instances oder AMIs Startvorlagen EC2
Wie viele EC2 Instances oder Startvorlagen verweisen auf jedes AMI

AMI-Nutzungsberichte helfen Ihnen dabei, Ihr System AMIs effektiver zu verwalten, indem sie Ihnen helfen:

Identifizieren Sie die Ressourcentypen AWS-Konten und die Ressourcentypen, auf die Sie verweisen, AMIs damit Sie sich sicher abmelden oder deaktivieren können. AMIs
Identifizieren Sie ungenutzte Dateien AMIs für die Abmeldung, um die Speicherkosten zu senken.
Identifizieren Sie die am häufigsten verwendeten. AMIs

So funktionieren AMI-Nutzungsberichte

Beim Erstellen eines AMI-Nutzungsberichts geben Sie Folgendes an:

Das AMI, über das berichtet werden soll.
Die AWS-Konten zu überprüfenden (bestimmte Konten oder alle Konten).
Die zu prüfenden Ressourcentypen (EC2 Instanzen, Startvorlagen oder beides).
Bei Startvorlagen die Anzahl der zu überprüfenden Versionen (standardmäßig die 20 neuesten Versionen).

Amazon EC2 erstellt für jedes AMI einen separaten Bericht. Jeder Bericht enthält:

Eine Liste der AWS-Konten Benutzer des AMI.
Eine Anzahl der Ressourcen, die auf das AMI verweisen, nach Ressourcentyp pro Konto. Beachten Sie, dass bei Startvorlagen die Anzahl nur 1 beträgt, wenn in mehreren Versionen einer Startvorlage auf ein AMI verwiesen wird.

Wichtig

Wenn Sie einen AMI-Nutzungsbericht generieren, enthält er möglicherweise nicht die neuesten Aktivitäten. Instance-Aktivitäten der letzten 24 Stunden und Aktivitäten zum Starten von Vorlagen der letzten Tage werden möglicherweise nicht im Bericht angezeigt.

Amazon löscht einen Bericht EC2 automatisch 30 Tage nach der Erstellung. Sie können Berichte von der EC2 Konsole herunterladen, um sie lokal zu speichern.

Einen AMI-Nutzungsbericht erstellen

Um zu sehen, wie Ihr AMI verwendet wird, müssen Sie zunächst einen AMI-Nutzungsbericht erstellen, in dem Sie die Konten und Ressourcentypen angeben, über die berichtet werden soll. Nachdem der Bericht erstellt wurde, können Sie den Inhalt des Berichts anzeigen. Sie können den Bericht auch von der EC2 Konsole herunterladen.

Console

So erstellen Sie einen AMI-Nutzungsbericht

Öffnen Sie die EC2 Amazon-Konsole unter https://console.aws.amazon.com/ec2/.
Wählen Sie im Navigationsbereich AMIs aus.
Wählen Sie ein AMI aus und wählen Sie dann Aktionen, AMI-Nutzung, Meine AMI-Nutzung anzeigen.
Führen Sie auf der Seite Meinen AMI-Nutzungsbericht erstellen die folgenden Schritte aus:
1. Wählen Sie unter Ressourcentypen einen oder mehrere Ressourcentypen aus, über die ein Bericht erstellt werden soll.
2. Führen Sie unter Account (Konto) IDs eine der folgenden Aktionen aus:
  - Wählen Sie Konten angeben IDs und anschließend für jedes Konto, über das ein Bericht erstellt werden soll, die Option Konto-ID hinzufügen aus.
  - Wählen Sie Alle Konten einbeziehen, um Berichte über alle Konten zu erstellen.
3. Wählen Sie Meinen AMI-Nutzungsbericht erstellen aus.
Wählen Sie auf der AMI-Seite die Registerkarte Meine AMI-Nutzung aus.
Wählen Sie eine Bericht-ID aus, um dessen Details anzuzeigen.

AWS CLI

So erstellen Sie einen AMI-Nutzungsbericht für eine Liste von Konten

Verwenden Sie den create-image-usage-reportBefehl mit den folgenden erforderlichen Parametern:

--image-id – Die ID des AMI, über das berichtet werden soll.
--resource-types – Die Ressourcentypen, die überprüft werden sollen. Im folgenden Beispiel handelt es sich bei den zu prüfenden Ressourcentypen um EC2 Instances und Startvorlagen. Darüber hinaus wird auch die Anzahl der zu überprüfenden Versionen der Startvorlagen angegeben (version-depth=100).

Um Berichte über bestimmte Konten zu erstellen, verwenden Sie den Parameter --account-ids, um die ID der einzelnen Konten anzugeben, für die ein Bericht erstellt werden soll.


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}]'

So erstellen Sie einen AMI-Nutzungsbericht für alle Konten

Um Berichte über alle Konten zu erstellen, die das angegebene AMI verwenden, verwenden Sie denselben Befehl, lassen Sie jedoch den Parameter --account-ids weg.


aws ec2 create-image-usage-report \
    --image-id ami-0abcdef1234567890 \
    --resource-types ResourceType=ec2:Instance \
      'ResourceType=ec2:LaunchTemplate,ResourceTypeOptions=[{OptionName=version-depth,OptionValues=100}]'

Es folgt eine Beispielausgabe.


{
    "ReportId": "amiur-00b877d192f6b02d0"
}

So überwachen Sie den Status der Berichterstellung

Verwenden Sie den describe-image-usage-reportsBefehl und geben Sie die Berichts-ID an.


aws ec2 describe-image-usage-reports --report-ids amiur-00b877d192f6b02d0

Es folgt eine Beispielausgabe. Der Anfangswert für das State-Feld ist pending. Um die Berichtseinträge anzeigen zu können, muss der Status available sein.


{
    "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

So erstellen Sie einen AMI-Nutzungsbericht für eine Liste von Konten

Verwenden Sie das New-EC2ImageUsageReportCmdlet mit den folgenden erforderlichen Parametern:

-ImageId – Die ID des AMI, über das berichtet werden soll.
-ResourceType – Die Ressourcentypen, die überprüft werden sollen. Im folgenden Beispiel handelt es sich bei den zu prüfenden Ressourcentypen um EC2 Instances und Startvorlagen. Darüber hinaus wird auch die Anzahl der zu überprüfenden Versionen der Startvorlagen angegeben ('version-depth' = 100).

Um Berichte über bestimmte Konten zu erstellen, verwenden Sie den Parameter -AccountId, um die ID der einzelnen Konten anzugeben, für die ein Bericht erstellt werden soll.


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

So erstellen Sie einen AMI-Nutzungsbericht für alle Konten

Um Berichte über alle Konten zu erstellen, die das angegebene AMI verwenden, verwenden Sie denselben Befehl, lassen Sie jedoch den Parameter -AccountId weg.


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

Es folgt eine Beispielausgabe.


ReportId
--------
amiur-00b877d192f6b02d0

So überwachen Sie den Status der Berichterstellung

Verwenden Sie den Get-EC2ImageUsageReportBefehl und geben Sie die Berichts-ID an.


Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0

Es folgt eine Beispielausgabe. Der Anfangswert für das State-Feld ist pending. Um die Berichtseinträge anzeigen zu können, muss der Status available sein.


ImageUsageReports
-----------------
{@{ImageId=ami-0e9ae3dc21c2b3a64; ReportId=amiur-abcae3dc21c2b3999; ResourceTypes=System.Object[]; State=pending; CreationTime=2025-09-29; ExpirationTime=2025-10-28}}

AMI-Nutzungsberichte anzeigen

Sie können alle Nutzungsberichte anzeigen, die Sie in den letzten 30 Tagen für ein AMI erstellt haben. Amazon löscht einen Bericht EC2 automatisch 30 Tage nach der Erstellung.

Für jeden Bericht können Sie diejenigen sehen, die AWS-Konten das AMI verwenden, und für jedes Konto die Anzahl der Ressourcen, die auf das AMI verweisen, nach Ressourcentyp. Sie können auch sehen, wann die Erstellung des Berichts initiiert wurde. Diese Informationen sind nur verfügbar, wenn sich der Bericht im Status Vollständig (Konsole) oder available (AWS CLI) befindet.

Wichtig

Console

So zeigen Sie einen AMI-Nutzungsbericht an

Öffnen Sie die EC2 Amazon-Konsole unter https://console.aws.amazon.com/ec2/.
Wählen Sie im Navigationsbereich AMIs aus.
Wählen Sie ein AMI aus.
Wählen Sie die Registerkarte Meine Nutzungsberichte.

Die Berichtsliste zeigt:
- Alle Berichte, die in den letzten 30 Tagen für das ausgewählte AMI generiert wurden.
- Für jeden Bericht wird in der Spalte Zeit der Berichtsinitiierung das Datum angezeigt, an dem der Bericht erstellt wurde.
Wählen Sie die ID eines Berichts, um dessen Inhalt anzuzeigen.
Um auf der Seite mit den AMI-Details zur Registerkarte Meine Nutzungsberichte zurückzukehren, wählen Sie Alle Berichte für dieses AMI anzeigen aus.

AWS CLI

So listen Sie alle AMI-Nutzungsberichte für das angegebene AMI auf

Verwenden Sie den describe-image-usage-reportsBefehl und geben Sie die ID des AMI an, um eine Liste seiner Berichte zu erhalten.


aws ec2 describe-image-usage-reports --image-ids ami-0abcdef1234567890

Es folgt eine Beispielausgabe. Jede Berichts-ID wird zusammen mit den Ressourcentypen, die gescannt wurden, sowie den Erstellungs- und Ablaufdaten des Berichts aufgeführt. Anhand dieser Informationen können Sie die Berichte identifizieren, deren Einträge Sie anzeigen möchten.


{
  "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"
}

So zeigen Sie den Inhalt eines AMI-Nutzungsberichts für das angegebene AMI an

Verwenden Sie den Befehl describe-image-usage-report-entries und geben Sie die ID des AMI an. Die Antwort gibt alle Berichte für das angegebene AMI zurück und zeigt die Konten, die das AMI verwendet haben, und deren Ressourcenanzahl.


aws ec2 describe-image-usage-report-entries --image-ids ami-0abcdef1234567890

Es folgt eine Beispielausgabe.


{
  "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"
}

So zeigen Sie den Inhalt eines AMI-Nutzungsberichts für den angegebenen Bericht an

Verwenden Sie den Befehl describe-image-usage-report-entries und geben Sie die ID des Berichts an. Die Antwort gibt alle Einträge für den angegebenen Bericht zurück und zeigt die Konten, die das AMI verwendet haben, und deren Ressourcenanzahl.


aws ec2 describe-image-usage-report-entries --report-ids amiur-11111111111111111

Es folgt eine Beispielausgabe.


{
  "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

So listen Sie alle AMI-Nutzungsberichte für das angegebene AMI auf

Verwenden Sie das Get-EC2ImageUsageReportCmdlet und geben Sie die ID des AMI an, um eine Liste seiner Berichte abzurufen.


Get-EC2ImageUsageReport -ImageId ami-0abcdef1234567890


@{
    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"
}

So zeigen Sie den Inhalt eines AMI-Nutzungsberichts für das angegebene AMI an

Verwenden Sie das Get-EC2ImageUsageReportEntryCmdlet und geben Sie die ID des AMI an. Die Antwort gibt alle Berichte für das angegebene AMI zurück und zeigt die Konten, die das AMI verwendet haben, und deren Ressourcenanzahl.


Get-EC2ImageUsageReportEntry -ImageId ami-0abcdef1234567890

Es folgt eine Beispielausgabe.


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

So zeigen Sie den Inhalt eines AMI-Nutzungsberichts für den angegebenen Bericht an

Verwenden Sie das Get-EC2ImageUsageReportEntryCmdlet und geben Sie die ID des Berichts an. Die Antwort gibt alle Einträge für den angegebenen Bericht zurück und zeigt die Konten, die das AMI verwendet haben, und deren Ressourcenanzahl.


Get-EC2ImageUsageReportEntry -ReportId amiur-11111111111111111

Es folgt eine Beispielausgabe.


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

Einen AMI-Nutzungsbericht löschen

Amazon löscht einen Bericht EC2 automatisch 30 Tage nach seiner Erstellung. Sie können ihn vor diesem Zeitpunkt manuell löschen.

Berichtskontingente

Die folgenden Kontingente gelten für die Erstellung von AMI-Nutzungsberichten. Die Kontingente gelten pro AWS-Region.

Description	Kontingent
In Bearbeitung (`pending`) AMI-Nutzungsberichte pro AWS-Konto	2.000
In Bearbeitung (`pending`) AMI-Nutzungsberichte pro AMI	1

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

AMI-Nutzung

Prüfen, wann ein AMI zuletzt verwendet wurde

Ihre AMI-Nutzung anzeigen

Inhalt

So funktionieren AMI-Nutzungsberichte

Wichtig

Einen AMI-Nutzungsbericht erstellen

So erstellen Sie einen AMI-Nutzungsbericht

So erstellen Sie einen AMI-Nutzungsbericht für eine Liste von Konten

So erstellen Sie einen AMI-Nutzungsbericht für alle Konten

So überwachen Sie den Status der Berichterstellung

So erstellen Sie einen AMI-Nutzungsbericht für eine Liste von Konten

So erstellen Sie einen AMI-Nutzungsbericht für alle Konten

So überwachen Sie den Status der Berichterstellung

AMI-Nutzungsberichte anzeigen

Wichtig

So zeigen Sie einen AMI-Nutzungsbericht an

So listen Sie alle AMI-Nutzungsberichte für das angegebene AMI auf

So zeigen Sie den Inhalt eines AMI-Nutzungsberichts für das angegebene AMI an

So zeigen Sie den Inhalt eines AMI-Nutzungsberichts für den angegebenen Bericht an

So listen Sie alle AMI-Nutzungsberichte für das angegebene AMI auf

So zeigen Sie den Inhalt eines AMI-Nutzungsberichts für das angegebene AMI an

So zeigen Sie den Inhalt eines AMI-Nutzungsberichts für den angegebenen Bericht an

Einen AMI-Nutzungsbericht löschen

So löschen Sie einen AMI-Nutzungsbericht

So löschen Sie einen AMI-Nutzungsbericht

So löschen Sie einen AMI-Nutzungsbericht

Berichtskontingente