Ihre AMI-Nutzung anzeigen - Amazon Elastic Compute Cloud
So funktionieren AMI-NutzungsberichteErstellen Sie einen AMI-NutzungsberichtAMI-Nutzungsberichte anzeigenLöschen Sie einen AMI-NutzungsberichtKontingente melden

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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 AMIs EC2 In-Instances oder Launch-Vorlagen

  • 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

Wenn Sie einen AMI-Nutzungsbericht erstellen, geben Sie Folgendes an:

  • Das AMI, über das berichtet werden soll.

  • Das AWS-Konten zu überprüfende (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.

Erstellen Sie einen AMI-Nutzungsbericht

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. Sobald der Bericht erstellt wurde, können Sie den Inhalt des Berichts einsehen. Sie können den Bericht auch von der EC2 Konsole herunterladen.

Console
So erstellen Sie einen AMI-Nutzungsbericht

  1. Öffnen Sie die EC2 Amazon-Konsole unter https://console.aws.amazon.com/ec2/.

  2. Wählen Sie im Navigationsbereich AMIs aus.

  3. Wählen Sie ein AMI aus und klicken Sie auf Aktionen, AMI-Nutzung, Meine AMI-Nutzung anzeigen.

  4. Gehen Sie auf der Seite Meinen AMI-Nutzungsbericht erstellen wie folgt vor:

    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 einen Bericht über alle Konten zu erstellen.

    3. Wählen Sie Meinen AMI-Nutzungsbericht erstellen aus.

  5. Wählen Sie auf der AMI-Seite die Registerkarte Meine AMI-Nutzung aus.

  6. Wählen Sie eine Berichts-ID aus, um die zugehörigen 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 Arten der zu überprüfenden Ressourcen. Im folgenden Beispiel handelt es sich bei den zu prüfenden Ressourcentypen um EC2 Instanzen 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 --account-ids Parameter, 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}]'
Um einen AMI-Nutzungsbericht für alle Konten zu erstellen

Um Berichte über alle Konten zu erstellen, die das angegebene AMI verwenden, verwenden Sie denselben Befehl, lassen Sie jedoch den --account-ids Parameter 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"
}
Um den Status der Berichtserstellung zu überwachen

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 des State Feldes istpending. Um die Berichtseinträge anzeigen zu können, muss der Status angegeben werdenavailable.

{
    "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 Arten der zu überprüfenden Ressourcen. Im folgenden Beispiel handelt es sich bei den zu prüfenden Ressourcentypen um EC2 Instanzen 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 -AccountId Parameter, 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}
        })
Um einen AMI-Nutzungsbericht für alle Konten zu erstellen

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

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

Es folgt eine Beispielausgabe.

ReportId
--------
amiur-00b877d192f6b02d0
Um den Status der Berichtserstellung zu überwachen

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

Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0

Es folgt eine Beispielausgabe. Der Anfangswert des State Feldes istpending. Um die Berichtseinträge anzeigen zu können, muss der Status angegeben werdenavailable.

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 Berichtserstellung initiiert wurde. Diese Informationen sind nur verfügbar, wenn sich der Bericht im Status Vollständig (Konsole) oder available (AWS CLI) befindet.

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.

Console
So zeigen Sie einen AMI-Nutzungsbericht an

  1. Öffnen Sie die EC2 Amazon-Konsole unter https://console.aws.amazon.com/ec2/.

  2. Wählen Sie im Navigationsbereich AMIs aus.

  3. Wählen Sie ein AMI aus.

  4. Wählen Sie den Tab 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.

  5. Wählen Sie die ID eines Berichts, um seinen Inhalt anzuzeigen.

  6. 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
Um alle AMI-Nutzungsberichte für das angegebene AMI aufzulisten

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"
}
Um den Inhalt eines AMI-Nutzungsberichts für das angegebene AMI anzuzeigen

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"
}
Um den Inhalt eines AMI-Nutzungsberichts für den angegebenen Bericht anzuzeigen

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, sowie 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
Um alle AMI-Nutzungsberichte für das angegebene AMI aufzulisten

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

Get-EC2ImageUsageReport -ImageId 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"
        },
        @{
            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"
}
Um den Inhalt eines AMI-Nutzungsberichts für das angegebene AMI anzuzeigen

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
Um den Inhalt eines AMI-Nutzungsberichts für den angegebenen Bericht anzuzeigen

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, sowie 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

Löschen Sie einen AMI-Nutzungsbericht

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

Console
So löschen Sie einen AMI-Nutzungsbericht

  1. Öffnen Sie die EC2 Amazon-Konsole unter https://console.aws.amazon.com/ec2/.

  2. Wählen Sie im Navigationsbereich AMIs aus.

  3. Wählen Sie ein AMI aus.

  4. Wählen Sie die Registerkarte Meine AMI-Nutzung.

  5. Wählen Sie das Optionsfeld neben dem Bericht, den Sie löschen möchten, und wählen Sie dann Löschen aus.

AWS CLI
So löschen Sie einen AMI-Nutzungsbericht

Verwenden Sie den delete-image-usage-reportBefehl und geben Sie die ID des Berichts an.

aws ec2 delete-image-usage-report --report-id amiur-0123456789abcdefg
PowerShell
So löschen Sie einen AMI-Nutzungsbericht

Verwenden Sie das Remove-EC2ImageUsageReportCmdlet und geben Sie die ID des Berichts an.

Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg

Kontingente melden

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