View a markdown version of this page

Komponentendetails auflisten und anzeigen - EC2 Image Builder

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.

Komponentendetails auflisten und anzeigen

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

Listet Image Builder-Komponenten auf

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

AWS-Managementkonsole

Gehen Sie wie folgt vor AWS-Managementkonsole, um eine Liste der Komponenten in der anzuzeigen:

  1. Öffnen Sie die EC2 Image 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 der Eigentümerschaft der Komponenten filtern. Um Komponenten zu sehen, die Sie nicht besitzen, auf die Sie aber Zugriff haben, erweitern Sie die Dropdownliste für den Eigentümertyp und wählen Sie einen der Werte aus. Die Liste der Eigentümertypen 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 von ihrem Konto aus erstellt und mit Ihnen geteilt haben.

    • Von Drittanbietern verwaltete Komponenten — Komponenten, die einem Drittanbieter 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 der Image Builder-Komponenten zurückzugeben, die Ihrem Konto gehören.

aws imagebuilder list-components

Sie können optional nach der Eigentümerschaft der Komponenten 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 beim Ausführen 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

Wenn Sie Komponenten mit dem --owner AWSMarketplace Wert auflisten, können Sie die Ergebnisse nach Produktcode filtern. Geben Sie den productCodes Filter mit einem Wert im Format anmarketplace:productCodeId, wie im folgenden Beispiel gezeigt:

aws imagebuilder list-components --owner AWSMarketplace --filters name=productCodes,values=marketplace:examplecode123
Anmerkung

Image Builder gibt AWS Marketplace Komponenten-ARNs unter dem aws-marketplace Namespace mit einem Besitzer von zurück. AWSMarketplace Wenn Sie get-component nach einer AWS Marketplace Komponente aufrufen, enthält die Antwort den Besitzer, lässt jedoch die Komponentendaten weg. Die Komponentendaten sind nur verfügbar, wenn die aufrufende Build-Instanz Anspruch auf das Produkt hat.

Listet die Build-Versionen der Komponenten aus dem 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-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" } } ] }

Einzelheiten zu den Komponenten finden Sie im 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": {} } }

Informationen zur Komponentenrichtlinie finden Sie im AWS CLI

Das folgende Beispiel zeigt, wie der get-component-policy Befehl verwendet wird, um Details 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