View a markdown version of this page

Répertorier et afficher les détails des composants - EC2 Image Builder
Liste des composants d'Image BuilderRépertorier les versions de compilation des composants à partir du AWS CLIObtenez des informations sur les composants à partir du AWS CLIObtenez des informations détaillées sur la politique relative aux composants à partir du AWS CLI

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Répertorier et afficher les détails des composants

Cette section explique comment trouver des informations et afficher des détails sur les composants que vous utilisez dans vos recettes EC2 Image Builder.

Liste des composants d'Image Builder

Vous pouvez utiliser l'une des méthodes suivantes pour répertorier et filtrer les composants d'Image Builder.

Console de gestion AWS

Pour afficher la liste des composants du Console de gestion AWS, procédez comme suit :

  1. Ouvrez la console EC2 Image Builder à https://console.aws.amazon.com/imagebuilder/ l'adresse.

  2. Sélectionnez Composants dans le volet de navigation. Par défaut, Image Builder affiche la liste des composants appartenant à votre compte.

  3. Vous pouvez éventuellement filtrer en fonction de la propriété des composants. Pour voir les composants auxquels vous n'êtes pas propriétaire, mais auxquels vous avez accès, développez la liste déroulante des types de propriétaires et sélectionnez l'une des valeurs. La liste des types de propriétaires se trouve dans la barre de recherche, à côté de la zone de texte de recherche. Vous pouvez choisir parmi les valeurs suivantes :

    • AWS Marketplace— Composants directement associés à un abonnement à un AWS Marketplace produit.

    • Démarrage rapide (géré par Amazon)  : composants accessibles au public créés et gérés par Amazon.

    • M'appartenant  : composants que vous avez créés. Il s'agit de la sélection par défaut.

    • Partagés avec moi  : composants que d'autres personnes ont créés et partagés avec vous depuis leur compte.

    • Géré par des tiers  : composants appartenant à un tiers et auxquels vous vous êtes abonné AWS Marketplace.

AWS CLI

L'exemple suivant montre comment utiliser la list-components commande pour renvoyer la liste des composants Image Builder appartenant à votre compte.

aws imagebuilder list-components

Vous pouvez éventuellement filtrer en fonction de la propriété des composants. L'attribut owner définit à qui appartient les composants que vous souhaitez répertorier. Par défaut, cette demande renvoie la liste des composants appartenant à votre compte. Pour filtrer les résultats par propriétaire de composant, spécifiez l'une des valeurs suivantes avec le --owner paramètre lorsque vous exécutez la list-components commande.

Valeurs du propriétaire des composants

  • AWSMarketplace

  • Amazon

  • Self

  • Shared

  • ThirdParty

Les exemples suivants montrent la list-components commande avec le --owner paramètre permettant de filtrer les résultats.

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

Lorsque vous répertoriez les composants avec la --owner AWSMarketplace valeur, vous pouvez filtrer les résultats par code produit. Spécifiez le productCodes filtre avec une valeur au formatmarketplace:productCodeId, comme illustré dans l'exemple suivant :

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

Image Builder renvoie les AWS Marketplace ARN des composants sous l'aws-marketplaceespace de noms, avec un propriétaire de. AWSMarketplace Lorsque vous appelez get-component un AWS Marketplace composant, la réponse inclut le propriétaire mais omet les données du composant. Les données des composants ne sont disponibles que lorsque l'instance de build appelante a droit au produit.

Répertorier les versions de compilation des composants à partir du AWS CLI

L'exemple suivant montre comment utiliser la list-component-build-versions commande pour répertorier les versions de génération de composants qui ont une version sémantique spécifique. Pour en savoir plus sur la gestion sémantique des versions pour les ressources Image Builder, consultez. Versionnage sémantique dans 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"
            }
        }
    ]
}

Obtenez des informations sur les composants à partir du AWS CLI

L'exemple suivant montre comment utiliser la get-component commande pour obtenir les détails d'un composant lorsque vous spécifiez son Amazon Resource Name (ARN).

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

Obtenez des informations détaillées sur la politique relative aux composants à partir du AWS CLI

L'exemple suivant montre comment utiliser la get-component-policy commande pour obtenir les détails de la politique d'un composant lorsque vous spécifiez l'ARN du composant.

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