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) für andere AWS-Konten freigeben – sei es für bestimmte AWS-Konten, Organisationen, Organisationseinheiten (OUs) oder öffentlich – können Sie anhand von AMI-Nutzungsberichten sehen, wie diese AMIs verwendet werden. Die Berichte bieten Einblick in:

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

AMI-Nutzungsberichte unterstützen Sie dabei, Ihre AMIs effektiver zu verwalten, indem sie Ihnen helfen:

Die AWS-Konten und Ressourcentypen zu identifizieren, die auf Ihre AMIs verweisen, sodass Sie AMIs sicher abmelden oder deaktivieren können.
Ungenutzte AMIs für die Abmeldung zu identifizieren, um die Speicherkosten zu senken.
Ihre am häufigsten verwendeten AMIs zu identifizieren.

So funktionieren AMI-Nutzungsberichte

Beim Erstellen eines AMI-Nutzungsberichts geben Sie Folgendes an:

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

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

Eine Liste der AWS-Konten, die das AMI benutzen.
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 EC2 löscht einen Bericht 30 Tage nach der Erstellung automatisch. Sie können Berichte über die 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 über die EC2-Konsole herunterladen.

Console

So erstellen Sie einen AMI-Nutzungsbericht

Öffnen Sie die Amazon EC2-Konsole unter https://console.aws.amazon.com/ec2/.
Wählen Sie im Navigationsbereich die Option AMIs.
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 Konto eine der folgenden Aktionen aus:
  - Wählen Sie Konto-IDs angeben 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 Befehl create-image-usage-report 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 Befehl describe-image-usage-reports 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 cmdlet New-EC2ImageUsageReport 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 Befehl Get-EC2ImageUsageReport und geben Sie die Bericht-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 EC2 löscht einen Bericht 30 Tage nach der Erstellung automatisch.

Für jeden Bericht können Sie die AWS-Konten sehen, die 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 Amazon EC2-Konsole unter https://console.aws.amazon.com/ec2/.
Wählen Sie im Navigationsbereich die Option AMIs.
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 Befehl describe-image-usage-reports und geben Sie die ID des AMI an, um eine Liste seiner Berichte abzurufen.


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 cmdlet Get-EC2ImageUsageReport 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 cmdlet Get-EC2ImageUsageReportEntry 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 cmdlet Get-EC2ImageUsageReportEntry 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 EC2 löscht einen Bericht 30 Tage nach der Erstellung automatisch. 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.

Beschreibung	Kontingent
In Bearbeitung (`pending`) AMI-Nutzungsberichte pro AWS-Konto	100
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