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.

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 ListImagesin der EC2Image Builder API Builder-Referenz. Die zugehörige SDK Anfrage finden Sie unter dem Link „Siehe auch“ auf derselben Seite.

Bilder in der Konsole auflisten

Gehen Sie wie folgt vor, um die Seite mit der Bilderliste in der Konsole zu öffnen:

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.

Bilder mit AWS CLI Befehlen auflisten

Wenn Sie den list-images 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"
		}
	]
}

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 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 verwendenSendWorkflowStepAction, 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 das API oder ein verwendenSDK, um eine Liste der Workflow-Schritte abzurufen, die noch ausgeführt werden müssen. Informationen zur API Aktion finden Sie ListWaitingWorkflowStepsin der EC2Image Builder API Builder-Referenz. Die zugehörige SDK Anfrage finden Sie unter dem Link „Siehe auch“ 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/.

2. Wählen Sie im Navigationsbereich Bilder aus. Dadurch wird die Seite mit der Bilderliste geöffnet.

3. Wählen Sie auf der Listenseite den Tab Warten auf Aktion aus.

4. (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 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 dem Image Builder verwenden APISDKs, oder AWS CLI um Image-Build-Versionen aufzulisten.

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 ListImageBuildVersionsin der EC2Image Builder API Builder-Referenz. Die zugehörige SDK Anfrage finden Sie unter dem Link „Siehe auch“ 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 angezeigtDistributing. Bei der Disposition des Images wird möglicherweise der Status Deprecated oder angezeigtDeleted.

• 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 gleichFailed).

• 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/.

2. Wählen Sie im Navigationsbereich Bilder aus. Standardmäßig zeigt die Bilderliste die aktuelle Version aller Bilder, die Sie besitzen.

3. 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 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.