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 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
**Topics**
+ [So funktionieren AMI-Nutzungsberichte](#how-ami-usage-reports-work)
+ [Einen AMI-Nutzungsbericht erstellen](#create-ami-usage-reports)
+ [AMI-Nutzungsberichte anzeigen](#view-ami-usage-reports)
+ [Einen AMI-Nutzungsbericht löschen](#delete-ami-usage-reports)
+ [Berichtskontingente](#ami-usage-report-quotas)
## 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**
1. Öffnen Sie die EC2 Amazon-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Wählen Sie im Navigationsbereich **AMIs** aus.
1. Wählen Sie ein AMI aus und wählen Sie dann **Aktionen**, **AMI-Nutzung**, **Meine AMI-Nutzung anzeigen**.
1. 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.
1. 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.
1. Wählen Sie **Meinen AMI-Nutzungsbericht erstellen** aus.
1. Wählen Sie auf der AMI-Seite die Registerkarte **Meine AMI-Nutzung** aus.
1. 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-report](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-image-usage-report.html)Befehl 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-reports](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-reports.html)Befehl 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-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2ImageUsageReport.html)Cmdlet 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-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReport.html)Befehl 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**
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/](https://console.aws.amazon.com/ec2/).
1. Wählen Sie im Navigationsbereich **AMIs** aus.
1. Wählen Sie ein AMI aus.
1. 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.
1. Wählen Sie die ID eines Berichts, um dessen Inhalt anzuzeigen.
1. 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-reports](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-reports.html)Befehl 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-report-entries.html) 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](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-image-usage-report-entries.html) 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-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReport.html)Cmdlet 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"
}
```
**So zeigen Sie den Inhalt eines AMI-Nutzungsberichts für das angegebene AMI an**
Verwenden Sie das [Get-EC2ImageUsageReportEntry](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReportEntry.html)Cmdlet 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-EC2ImageUsageReportEntry](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageUsageReportEntry.html)Cmdlet 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.
------
#### [ Console ]
**So löschen Sie einen AMI-Nutzungsbericht**
1. Öffnen Sie die EC2 Amazon-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Wählen Sie im Navigationsbereich **AMIs** aus.
1. Wählen Sie ein AMI aus.
1. Wählen Sie die Registerkarte **Meine AMI-Nutzung**.
1. Wählen Sie das Optionsfeld neben dem Bericht aus, den Sie löschen möchten, und wählen Sie dann **Löschen**.
------
#### [ AWS CLI ]
**So löschen Sie einen AMI-Nutzungsbericht**
Verwenden Sie den [delete-image-usage-report](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-image-usage-report.html)Befehl 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-EC2ImageUsageReport](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2ImageUsageReport.html)Cmdlet und geben Sie die ID des Berichts an.
```
Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg
```
------
## 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 |