Komponentendetails auflisten und anzeigen

In diesem Abschnitt wird beschrieben, wie Sie Informationen finden und Details zu den Komponenten anzeigen können, die Sie in Ihren EC2 Image Builder Builder-Rezepten verwenden.

Image Builder Builder-Komponenten auflisten

Sie können eine der folgenden Methoden verwenden, um Image Builder Builder-Komponenten aufzulisten und zu filtern.

AWS Management Console

Gehen Sie folgendermaßen vor AWS Management Console, um eine Liste der Komponenten in der anzuzeigen:

1. Öffnen Sie die EC2 Image Builder Builder-Konsole unter https://console.aws.amazon.com/imagebuilder/.

2. Wählen Sie im Navigationsbereich Komponenten aus. Standardmäßig zeigt Image Builder eine Liste der Komponenten an, die Ihrem Konto gehören.

3. Sie können optional nach dem Besitz der Komponenten filtern. Um Komponenten zu sehen, die Sie nicht besitzen, auf die Sie aber Zugriff haben, erweitern Sie die Dropdownliste Besitzertyp und wählen Sie einen der Werte aus. Die Besitzertypliste befindet sich in der Suchleiste neben dem Suchtextfeld. Sie können aus den folgenden Werten auswählen:

   • AWS Marketplace— Komponenten, die direkt mit einem AWS Marketplace Produktabonnement verknüpft sind.

   • Schnellstart (von Amazon verwaltet) — Öffentlich verfügbare Komponenten, die Amazon erstellt und verwaltet.

   • Gehört mir — Komponenten, die Sie erstellt haben. Dies ist die Standardauswahl.

   • Mit mir geteilt — Komponenten, die andere über ihr Konto erstellt und mit Ihnen geteilt haben.

   • Von Dritten verwaltet — Komponenten, die einem Dritten gehören und die Sie abonniert AWS Marketplace haben.

AWS CLI

Das folgende Beispiel zeigt, wie Sie den list-components Befehl verwenden, um eine Liste von Image Builder Builder-Komponenten zurückzugeben, die Ihrem Konto gehören.

aws imagebuilder list-components

Sie können optional nach Komponentenbesitz filtern. Das Eigentümerattribut definiert, wem die Komponenten gehören, die Sie auflisten möchten. Standardmäßig gibt diese Anfrage eine Liste der Komponenten zurück, die Ihrem Konto gehören. Um die Ergebnisse nach dem Eigentümer der Komponente zu filtern, geben Sie bei der Ausführung des list-components Befehls einen der folgenden Werte mit dem --owner Parameter an.

Werte für den Eigentümer der Komponente

• AWSMarketplace

• Amazon

• Self

• Shared

• ThirdParty

Die folgenden Beispiele zeigen den list-components Befehl mit dem --owner Parameter zum Filtern von Ergebnissen.

aws imagebuilder list-components --owner Self
{
    "requestId": "012a3456-b789-01cd-e234-fa5678b9012b",
    "componentVersionList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/sample-component01/1.0.0",
            "name": "sample-component01",
            "version": "1.0.0",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2020-09-24T16:58:24.444Z"
        },
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/sample-component01/1.0.1",
            "name": "sample-component01",
            "version": "1.0.1",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2021-07-10T03:38:46.091Z"
        }
    ]
}

aws imagebuilder list-components --owner Amazon

aws imagebuilder list-components --owner Shared

aws imagebuilder list-components --owner ThirdParty

Listet die Build-Versionen der Komponenten auf AWS CLI

Das folgende Beispiel zeigt, wie der list-component-build-versions Befehl verwendet wird, um Komponenten-Build-Versionen aufzulisten, die eine bestimmte semantische Version haben. Weitere Informationen zur semantischen Versionierung für Image Builder Builder-Ressourcen finden Sie unter. Semantische Versionierung in Image Builder

aws imagebuilder list-component-build-versions --component-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1
{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "componentSummaryList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/1.0.1/1",
            "name": "examplecomponent",
            "version": "1.0.1",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "description": "An example component that builds, validates and tests an image",
            "changeDescription": "Updated version.",
            "dateCreated": "2020-02-19T18:53:45.940Z",
            "tags": {
                "KeyName": "KeyValue"
            }
        }
    ]
}
		

Details zu den Komponenten erhalten Sie von AWS CLI

Das folgende Beispiel zeigt, wie Sie den get-component Befehl verwenden, um Komponentendetails abzurufen, wenn Sie den Amazon-Ressourcennamen (ARN) der Komponente angeben.

aws imagebuilder get-component --component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1/1
			{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11112",
    "component": {
        "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/1.0.1/1",
        "name": "examplecomponent",
        "version": "1.0.1",
        "type": "BUILD",
        "platform": "Linux",
        "owner": "123456789012",
        "data": "name: HelloWorldTestingDocument\ndescription: This is hello world testing document... etc.\"\n",
        "encrypted": true,
        "dateCreated": "2020-09-24T16:58:24.444Z",
        "tags": {}
    }
}
		

Rufen Sie die Details zur Komponentenrichtlinie von AWS CLI

Das folgende Beispiel zeigt, wie Sie den get-component-policy Befehl verwenden, um Details zu einer Komponentenrichtlinie abzurufen, wenn Sie den ARN der Komponente angeben.

aws imagebuilder get-component-policy --component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1