View a markdown version of this page

Elenca e visualizza i dettagli dei componenti - EC2 Image Builder
Elenco dei componenti di Image BuilderElenca le versioni di compilazione dei componenti da AWS CLIOttieni i dettagli dei componenti dal AWS CLIOttieni i dettagli della politica dei componenti da AWS CLI

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Elenca e visualizza i dettagli dei componenti

Questa sezione descrive come trovare informazioni e visualizzare i dettagli dei componenti utilizzati nelle ricette di EC2 Image Builder.

Elenco dei componenti di Image Builder

È possibile utilizzare uno dei seguenti metodi per elencare e filtrare i componenti di Image Builder.

Console di gestione AWS

Per visualizzare un elenco dei componenti in Console di gestione AWS, procedi nel seguente modo:

  1. Apri la console EC2 Image Builder all'indirizzo https://console.aws.amazon.com/imagebuilder/.

  2. Seleziona Componenti dal pannello di navigazione. Per impostazione predefinita, Image Builder mostra un elenco di componenti di proprietà dell'account.

  3. Facoltativamente, puoi filtrare in base alla proprietà dei componenti. Per visualizzare i componenti di cui non sei proprietario, ma a cui hai accesso, espandi l'elenco a discesa del tipo di proprietario e seleziona uno dei valori. L'elenco dei tipi di proprietario si trova nella barra di ricerca, accanto alla casella di testo di ricerca. Puoi scegliere fra i seguenti valori:

    • AWS Marketplace— Componenti associati direttamente all'abbonamento di un AWS Marketplace prodotto.

    • Avvio rapido (gestito da Amazon): componenti disponibili al pubblico che Amazon crea e gestisce.

    • Di mia proprietà: componenti che hai creato tu. Questa è la selezione predefinita.

    • Condivisi con me: componenti che altri hanno creato e condiviso con te dal loro account.

    • Gestiti da terze parti: componenti di proprietà di una terza parte a cui ti sei abbonato. AWS Marketplace

AWS CLI

L'esempio seguente mostra come utilizzare il list-components comando per restituire un elenco di componenti di Image Builder di proprietà dell'account.

aws imagebuilder list-components

Facoltativamente, puoi filtrare in base alla proprietà dei componenti. L'attributo owner definisce chi possiede i componenti che si desidera elencare. Per impostazione predefinita, questa richiesta restituisce un elenco di componenti di proprietà dell'account. Per filtrare i risultati in base al proprietario del componente, specificate uno dei seguenti valori con il --owner parametro quando eseguite il list-components comando.

Valori del proprietario del componente

  • AWSMarketplace

  • Amazon

  • Self

  • Shared

  • ThirdParty

Gli esempi seguenti mostrano il list-components comando con il --owner parametro per filtrare i risultati.

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

Quando si elencano i componenti con il --owner AWSMarketplace valore, è possibile filtrare i risultati in base al codice del prodotto. Specifica il productCodes filtro con un valore nel formatomarketplace:productCodeId, come mostrato nell'esempio seguente:

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

Image Builder restituisce gli ARN dei AWS Marketplace componenti sotto il aws-marketplace namespace, con un proprietario di. AWSMarketplace Quando get-component richiedi un AWS Marketplace componente, la risposta include il proprietario ma omette i dati del componente. I dati del componente sono disponibili solo quando l'istanza di build chiamante ha diritto al prodotto.

Elenca le versioni di compilazione dei componenti da AWS CLI

L'esempio seguente mostra come utilizzare il list-component-build-versions comando per elencare le versioni di compilazione dei componenti con una versione semantica specifica. Per ulteriori informazioni sul controllo delle versioni semantiche per le risorse di Image Builder, vedere. Versionamento semantico 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"
            }
        }
    ]
}

Ottieni i dettagli dei componenti dal AWS CLI

L'esempio seguente mostra come utilizzare il get-component comando per ottenere i dettagli dei componenti quando si specifica l'Amazon Resource Name (ARN) del componente.

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": {}
    }
}

Ottieni i dettagli della politica dei componenti da AWS CLI

L'esempio seguente mostra come utilizzare il get-component-policy comando per ottenere i dettagli della politica di un componente quando si specifica l'ARN del componente.

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