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.
# Images und Build-Versionen auflisten
Auf der Seite **Images** in der Image Builder Builder-Konsole finden Sie Listen aller Image Builder Builder-Image-Ressourcen, die Sie besitzen, die mit Ihnen geteilt wurden und auf die Sie Zugriff haben. Die Listenergebnisse enthalten einige wichtige Details zu diesen Ressourcen.
Sie können auch alle Bilder in Ihrem Konto sehen, für die Workflow-Aktionen ausstehen.
**Topics**
+ [Bilder auflisten](#list-images)
+ [Listet Bilder auf, die auf eine Aktion warten](#list-images-waiting-for-action)
+ [Listet die Build-Versionen der Images auf](#list-image-build-versions)
## Bilder auflisten
In diesem Abschnitt werden die verschiedenen Möglichkeiten beschrieben, wie Sie Informationen zu Ihren Bildern auflisten können.
Sie können eine der folgenden Methoden verwenden, um Image Builder Builder-Image-Ressourcen aufzulisten, auf die Sie Zugriff haben. Informationen zur API-Aktion finden Sie [ListImages](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html)in der *EC2 Image Builder API-Referenz*. Die zugehörige SDK-Anfrage finden Sie unter dem Link „[Siehe auch](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html#API_ListImages_SeeAlso)“ auf derselben Seite.
**Topics**
+ [Bilder in der Konsole auflisten](#list-images-console)
+ [Bilder mit AWS CLI Befehlen auflisten](#list-images-cli)
### Bilder in der Konsole auflisten
Gehen Sie wie folgt vor, um die Seite mit der **Bilderliste** in der Konsole zu öffnen:
1. Öffnen Sie die EC2 Image Builder Builder-Konsole unter [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Wählen Sie im Navigationsbereich **Bilder** aus.
Die Seite „**Bilder**“ in der Konsole ist je nach Eigentümerschaft oder ausstehenden Workflow-Aktionen in Tabs unterteilt. In diesem Abschnitt werden die ersten drei Tabs behandelt, auf denen Bilder angezeigt werden, die Ihnen gehören oder auf die Sie Zugriff haben.
#### Registerkarte „Konsole“: Gehört mir
Auf der Registerkarte „**Mein Eigentum**“ können Sie die folgenden Filter verwenden, um die Ergebnisse der Bilderliste zu optimieren.
+ Sie können in der Suchleiste nach dem gesamten Namen oder einem Teil davon suchen.
+ Sie können Bilder basierend auf ihrer Betriebssystemplattform (Windows, Linux oder macOS) filtern.
+ Sie können Bilder nach der Art der Ausgabe filtern, die sie erzeugen (AMI oder Container-Image).
+ Sie können die **Filterquelle** verwenden, um Bilder zu finden, die von einer virtuellen Maschine (VMIE) oder von einem ISO-Disk-Image importiert wurden.
Nach den Filtersteuerungen wird auf der Registerkarte „**Mein Eigentum**“ eine Liste der Image Builder Builder-Images angezeigt, die Sie erstellt haben, mit den folgenden Details für die aufgelisteten Ressourcen:
**Name/Version**
Die Namen der Image Builder Builder-Bildressourcen beginnen mit dem Rezeptnamen und der Version, aus der sie erstellt wurden. Wählen Sie den Link aus, um alle zugehörigen Image-Build-Versionen anzuzeigen.
**Typ**
Der Typ des Ausgabebilds, das Image Builder für diese Image-Ressource erstellt (ein AMI oder ein Container-Image).
**Plattform**
Die Betriebssystemplattform der Bildressource, zum Beispiel „Linux“, „Windows“ oder „macOS“.
**Quelle des Bilds**
Der Ursprung des Basis-Images, mit dem Image Builder diese Image-Ressource erstellt hat. Dies wird hauptsächlich verwendet, um Ergebnisse für Images zu filtern, die von einer virtuellen Maschine (**VMIE**) importiert wurden.
**Zeitpunkt der Erstellung**
Datum und Uhrzeit der Erstellung der aktuellen Version der Bildressource durch Image Builder.
**ARN**
Der Amazon-Ressourcenname (ARN) der aktuellen Version der Bildressource.
#### Registerkarte „Konsole“: Mit mir geteilt
Auf der Registerkarte „**Für mich freigegeben**“ können Sie die folgenden Filter verwenden, um die Ergebnisse der Bilderliste zu optimieren.
+ Sie können in der Suchleiste nach dem gesamten Namen oder einem Teil davon suchen.
+ Sie können Bilder basierend auf ihrer Betriebssystemplattform (Windows, Linux oder macOS) filtern.
+ Sie können Bilder nach der Art der Ausgabe filtern, die sie erzeugen (AMI oder Container-Image).
+ Sie können die **Filterquelle** verwenden, um Bilder zu finden, die von einer virtuellen Maschine (VMIE) oder von einem ISO-Disk-Image importiert wurden.
Nach den Filtersteuerungen wird auf der Registerkarte **Für mich freigegeben** eine Liste der Image Builder Builder-Bilder angezeigt, die für Sie freigegeben wurden, mit den folgenden Details für die aufgelisteten Ressourcen:
**Name des Bilds**
Der Name der Bildressource, die mit Ihnen geteilt wurde. Um ein geteiltes Bild in einem Rezept zu verwenden, wählen Sie die Option **Verwaltete Bilder auswählen** und ändern den **Ursprung des Bilds** in **Mit mir geteilte Bilder**.
**Typ**
Der Typ des Ausgabebilds, das Image Builder für diese Image-Ressource erstellt (ein AMI oder ein Container-Image).
**Version**
Die Version der Betriebssystemplattform für die Image-Ressource, normalerweise ein numerisches Feld im folgenden Format:. . .
**Quelle des Bildes**
Der Ursprung des Basis-Images, mit dem Image Builder diese Image-Ressource erstellt hat, falls zutreffend. Dies wird hauptsächlich verwendet, um Ergebnisse für Images zu filtern, die von einer virtuellen Maschine (**VMIE**) importiert wurden.
**Plattform**
Die Betriebssystemplattform der Bildressource, zum Beispiel „Linux“, „Windows“ oder „macOS“.
**Zeitpunkt der Erstellung**
Datum und Uhrzeit, an dem Image Builder die Version der Bildressource erstellt hat, die für Sie freigegeben wurde.
**Eigentümer**
Der Besitzer der gemeinsam genutzten Bildressource.
**ARN**
Der Amazon-Ressourcenname (ARN) der Image-Ressourcenversion, die mit Ihnen geteilt wurde.
#### Registerkarte „Konsole“: Von Amazon verwaltet
Auf der Registerkarte „**Von Amazon verwaltet**“ können Sie die folgenden Filter verwenden, um die Ergebnisse der Bilderliste zu optimieren.
+ Sie können in der Suchleiste nach dem gesamten Namen oder einem Teil davon suchen.
+ Sie können Bilder basierend auf ihrer Betriebssystemplattform (Windows, Linux oder macOS) filtern.
+ Sie können Bilder nach der Art der Ausgabe filtern, die sie erzeugen (AMI oder Container-Image).
+ Sie können die **Filterquelle** verwenden, um Bilder zu finden, die von einer virtuellen Maschine (VMIE) oder von einem ISO-Disk-Image importiert wurden.
Nach den Filtersteuerungen wird auf der Registerkarte „**Von Amazon verwaltet**“ eine Liste der von Amazon verwalteten Image Builder Builder-Images angezeigt, die Sie als Basisbilder für Ihre Rezepte verwenden können. Image Builder zeigt die folgenden Details für die aufgelisteten Ressourcen an:
**Name des Bilds**
Der Name des verwalteten Images. Wenn Sie ein Rezept erstellen, ist die Standardeinstellung für Ihr Basis-Image **Quick Start (von Amazon verwaltet)**. Die auf dieser Registerkarte aufgelisteten Bilder füllen die Liste mit den **Imagenamen**, die der Betriebssystemplattform zugeordnet ist, die Sie bei der Erstellung eines Rezepts für Ihr Basis-Image ausgewählt haben.
**Typ**
Der Typ des Ausgabebilds, das Image Builder für diese Image-Ressource erstellt (ein AMI oder ein Container-Image).
**Version**
Die Version der Betriebssystemplattform für die Image-Ressource, normalerweise ein numerisches Feld im folgenden Format:. . .
**Plattform**
Die Betriebssystemplattform der Bildressource, zum Beispiel „Linux“, „Windows“ oder „macOS“.
**Zeitpunkt der Erstellung**
Datum und Uhrzeit, an dem Image Builder die Version der Bildressource erstellt hat, die für Sie freigegeben wurde.
**Eigentümer**
Amazon ist Eigentümer der verwalteten Bilder.
**ARN**
Der Amazon-Ressourcenname (ARN) der Image-Ressourcenversion, die mit Ihnen geteilt wurde.
### Bilder mit AWS CLI Befehlen auflisten
Wenn Sie den **[list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)** Befehl in der ausführen AWS CLI, können Sie eine Liste der Bilder abrufen, die Ihnen gehören oder auf die Sie Zugriff haben.
Das folgende Befehlsbeispiel zeigt, wie Sie den **list-images** Befehl ohne Filter verwenden, um alle Image Builder Builder-Bildressourcen aufzulisten, die Sie besitzen.
**Beispiel: Alle Bilder auflisten**
```
aws imagebuilder list-images
```
**Ausgabe:**
```
{
"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
"imageVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0",
"name": "image-recipe-name",
"type": "AMI",
"version": "1.0.0",
"platform": "Linux",
"owner": "123456789012",
"dateCreated": "2022-04-28T01:38:23.286Z"
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-win/1.0.1",
"name": "image-recipe-win",
"type": "AMI",
"version": "1.0.1",
"platform": "Windows",
"owner": "123456789012",
"dateCreated": "2022-04-28T01:38:23.286Z"
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-macos/1.1.1",
"name": "image-recipe-macos",
"type": "AMI",
"version": "1.1.1",
"platform": "macOS",
"owner": "123456789012",
"dateCreated": "2022-04-28T01:38:23.286Z"
}
]
}
```
Wenn Sie den **list-images** Befehl ausführen, können Sie Filter anwenden, um die Ergebnisse zu optimieren, wie das folgende Beispiel zeigt. *Weitere Informationen zum Filtern Ihrer Ergebnisse finden Sie unter dem Befehl [list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html) in der AWS CLI Befehlsreferenz.*
**Beispiel: Filter für Linux-Bilder**
```
aws imagebuilder list-images --filters name="platform",values="Linux"
```
**Ausgabe:**
```
{
"requestId": "1abcd234-e567-8fa9-0123-4567b890cd12",
"imageVersionList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0",
"name": "image-recipe-name",
"type": "AMI",
"version": "1.0.0",
"platform": "Linux",
"owner": "123456789012",
"dateCreated": "2022-04-28T01:38:23.286Z"
}
]
}
```
## Listet Bilder auf, die auf eine Aktion warten
Wenn Sie die `WaitForAction` Schrittaktion in Ihrem Bild-Workflow verwenden, wird der Workflow angehalten, bis Sie ihr das Signal senden, die Verarbeitung fortzusetzen, oder der Workflow schlägt fehl. Sie können diese Schrittaktion verwenden, wenn Sie einen externen Prozess haben, der ausgeführt werden muss, bevor Sie fortfahren können. Sie können dann die verwenden`SendWorkflowStepAction`, um ein Signal an den unterbrochenen Schritt an oder zu `RESUME` senden. `STOP` Sie können Ihren Workflow auch von der Konsole aus beenden oder fortsetzen.
Die folgenden Tabs zeigen, wie Sie eine Liste aller Bildressourcen in Ihrem Konto mit Workflow-Schritten abrufen können, die derzeit pausiert sind, um auf ein Signal zu warten, das wieder aufgenommen oder beendet wird. Die Registerkarten behandeln die Schritte in der Konsole und den AWS CLI Befehl.
Sie können auch die API oder ein SDK verwenden, um eine Liste der Workflow-Schritte abzurufen, die noch ausgeführt werden müssen. Informationen zur API-Aktion finden Sie [ListWaitingWorkflowSteps](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html)in der *EC2 Image Builder API-Referenz*. Die zugehörige SDK-Anfrage finden Sie unter dem Link „[Siehe auch](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html#API_ListWaitingWorkflowSteps_SeeAlso)“ auf derselben Seite.
------
#### [ Console ]
Gehen Sie wie folgt vor, um in der Konsole **zur Registerkarte Warten auf Aktion** zu gelangen:
1. Öffnen Sie die EC2 Image Builder Builder-Konsole unter [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Wählen Sie im Navigationsbereich **Bilder** aus. Dadurch wird die Seite mit der **Bilderliste** geöffnet.
1. Wählen Sie **auf der Listenseite den Tab Warten auf Aktion** aus.
1. (optional) Um einen Schritt zu beenden oder fortzusetzen, aktivieren Sie das Kontrollkästchen neben dem Namen und wählen Sie dann **Schritt beenden oder Schritt** **fortsetzen** aus. Sie können mehr als ein Kontrollkästchen aktivieren, um dieselbe Aktion für alle ausgewählten Schritte auszuführen.
**Details zu ausstehenden Workflow-Schritten**
Zu den Workflow-Details für den ausstehenden Schritt gehören:
+ **Bildname** — Der Name der Bildressource, die den ausstehenden Schritt enthält. Sie können den Namenslink auswählen, um die Detailseite für dieses Bild anzuzeigen.
+ **Name des ausstehenden Schritts** — Der Name des Workflow-Schritts, der auf eine Aktion wartet.
+ **Ausführungs-ID des Schritts** — Identifiziert eindeutig die Laufzeitinstanz des Workflow-Schritts. Sie können die verknüpfte ID auswählen, um Laufzeitdetails für den Schritt anzuzeigen.
+ **Schrittstart** — Der Zeitstempel, zu dem die Runtime-Instanz des Workflow-Schritts gestartet wurde.
+ **Workflow-ARN** — Der Amazon-Ressourcenname (ARN) des Workflows mit dem ausstehenden Schritt.
+ **Aktionen** — Die Schrittaktion, die sich im Wartestatus befindet.
------
#### [ AWS CLI ]
Wenn Sie den **[list-waiting-workflow-steps](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-waiting-workflow-steps.html)** Befehl in der ausführen AWS CLI, erhalten Sie eine Liste aller Bilder in Ihrem Konto, deren Workflow-Schritte noch auf eine Aktion warten, bevor der Image-Erstellungsprozess abgeschlossen wird.
Das folgende Befehlsbeispiel zeigt, wie Sie den **list-waiting-workflow-steps** Befehl verwenden, um alle Bilder in Ihrem Konto mit Workflow-Schritten aufzulisten, die noch auf eine Aktion warten.
**Beispiel: listet Bilder in Ihrem Konto auf, bei denen die Workflow-Schritte noch warten**
```
aws imagebuilder list-waiting-workflow-steps
```
**Ausgabe:**
Die Ausgabe für dieses Beispiel zeigt ein Bild im Konto mit einem Schritt, der auf eine Aktion wartet.
```
{
"steps": [
{
"imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:image/example-image/1.0.0/8",
"name": "WaitForAction",
"workflowExecutionId": "wf-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"stepExecutionId": "step-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/wait-for-action/1.0.0/1",
"startTime": "2023-11-21T23:21:23.609Z",
"action": "WaitForAction"
}
]
}
```
------
## Listet die Build-Versionen der Images auf
Auf der Seite **Image-Build-Versionen** der Image Builder Builder-Konsole finden Sie eine Liste der Build-Versionen und zusätzliche Details für eine Image-Ressource, die Sie besitzen. Sie können auch Befehle oder Aktionen mit der Image Builder Builder-API verwenden oder AWS CLI Image-Build-Versionen auflisten. SDKs
Sie können eine der folgenden Methoden verwenden, um Image-Build-Versionen für Image-Ressourcen aufzulisten, die Sie besitzen. Informationen zur API-Aktion finden Sie [ListImageBuildVersions](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html)in der *EC2 Image Builder API-Referenz*. Die zugehörige SDK-Anfrage finden Sie unter dem Link „[Siehe auch](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html#API_ListImageBuildVersions_SeeAlso)“ auf derselben Seite.
------
#### [ Console ]
**Einzelheiten zur Version**
Auf der Seite mit den **Image-Build-Versionen** in der Image Builder Builder-Konsole finden Sie unter anderem die folgenden Informationen:
+ **Version** — Die Build-Version der Image-Ressource. In der Image Builder Builder-Konsole ist die Version mit einer Image-Detailseite verknüpft.
+ **Typ** — Der Ausgabetyp, den Image Builder bei der Erstellung dieser Image-Ressource (ein AMI oder ein Container-Image) verteilt hat.
+ **Erstellungsdatum** — Datum und Uhrzeit der Erstellung der Image-Build-Version durch Image Builder.
+ **Image-Status** — Der aktuelle Status der Image-Build-Version. Der Status kann sich auf die Erstellung oder Disposition des Images beziehen. Während des Erstellungsvorgangs wird Ihnen beispielsweise der Status `Building` oder angezeigt`Distributing`. Bei der Disposition des Images wird möglicherweise der Status `Deprecated` oder angezeigt`Deleted`.
+ **Grund für den Fehler** — Der Grund für den Image-Status. In der Image Builder-Konsole wird nur der Grund angezeigt, wenn der Build fehlschlägt (**Image-Status** ist gleich`Failed`).
+ **Sicherheitsergebnisse** — Die aggregierten Image-Scan-Ergebnisse für die referenzierte Image-Build-Version.
+ **ARN** — Der Amazon-Ressourcenname (ARN) für die referenzierte Version der Bildressource.
+ **Log-Stream** — Ein Link zu den Log-Stream-Details für die referenzierte Image-Build-Version.
**Versionen auflisten**
Gehen Sie wie folgt vor, um Image-Build-Versionen in der Image Builder-Konsole aufzulisten:
1. Öffnen Sie die EC2 Image Builder Builder-Konsole unter [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Wählen Sie im Navigationsbereich **Bilder** aus. Standardmäßig zeigt die Bilderliste die aktuelle Version aller Bilder, die Sie besitzen.
1. Um eine Liste aller Versionen für ein Bild zu sehen, wählen Sie den Link zur aktuellen Version. Der Link öffnet die Seite mit den **Image-Build-Versionen**, auf der alle Build-Versionen für ein bestimmtes Image aufgeführt sind.
------
#### [ AWS CLI ]
Wenn Sie den **[list-image-build-versions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html)** Befehl in der ausführen AWS CLI, erhalten Sie eine vollständige Liste der Build-Versionen für die angegebene Image-Ressource. Sie müssen Eigentümer des Images sein, um diesen Befehl ausführen zu können.
Das folgende Befehlsbeispiel zeigt, wie der **list-image-build-versions** Befehl verwendet wird, um alle Build-Versionen für das angegebene Image aufzulisten.
**Beispiel: listet die Build-Versionen für ein bestimmtes Image auf**
```
aws imagebuilder list-image-build-versions --image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0
```
**Ausgabe:**
Die Ausgabe für dieses Beispiel enthält zwei Build-Versionen für das angegebene Image-Rezept.
```
{
"requestId": "12f3e45d-67cb-8901-af23-45ed678c9b01",
"imageSummaryList": [
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/2",
"name": "image-recipe-name",
"type": "AMI",
"version": "1.0.0/2",
"platform": "Linux",
"osVersion": "Amazon Linux 2",
"state": {
"status": "AVAILABLE"
},
"owner": "123456789012",
"dateCreated": "2023-03-10T01:04:40.609Z",
"outputResources": {
"amis": [
{
"region": "us-west-2",
"image": "ami-012b3456789012c3d",
"name": "image-recipe-name 2023-03-10T01-05-12.541Z",
"description": "First verison of image-recipe-name",
"accountId": "123456789012"
}
]
},
"tags": {}
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/1",
"name": "image-recipe-name",
"type": "AMI",
"version": "1.0.0/1",
"platform": "Linux",
"osVersion": "Amazon Linux 2",
"state": {
"status": "AVAILABLE"
},
"owner": "123456789012",
"dateCreated": "2023-03-10T00:07:16.384Z",
"outputResources": {
"amis": [
{
"region": "us-west-2",
"image": "ami-0d1e23456789f0a12",
"name": "image-recipe-name 2023-03-10T00-07-18.146132Z",
"description": "First verison of image-recipe-name",
"accountId": "123456789012"
}
]
},
"tags": {}
}
]
}
```
**Anmerkung**
Die Ausgabe des **list-image-build-versions** Befehls enthält derzeit keine Sicherheitsergebnisse oder Protokollstreams.
------