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 les détails des composants AWS Task Orchestrator and Executor (AWSTOE) que vous utilisez dans vos recettes EC2 Image Builder.

Lister les composants d'Image Builder

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

AWS Management Console

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

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

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

3. Vous pouvez éventuellement filtrer en fonction de la propriété des composants. Pour voir les composants que vous ne possédez pas, 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 :

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

   • Possédé par moi — Composants que vous avez créés. Il s'agit de la sélection par défaut.

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

   • Géré par un 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 une liste des composants Image Builder que votre compte possède.

aws imagebuilder list-components

Vous pouvez éventuellement filtrer en fonction de la propriété des composants. L'attribut owner définit à qui appartiennent les composants que vous souhaitez répertorier. Par défaut, cette demande renvoie une liste des composants que possède votre compte. Pour filtrer les résultats par propriétaire du 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 du composant

• Auto-utilisateur

• Amazon

• ThirdParty

• Partagé

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

Répertoriez les versions de construction des composants à partir du AWS CLI

L'exemple suivant montre comment utiliser la list-component-build-versions commande pour répertorier les versions de construction de composants qui ont une version sémantique spécifique. Pour en savoir plus sur le versionnement sémantique des 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"
            }
        }
    ]
}
		

Pour obtenir des informations sur les composants, consultez le AWS CLI

L'exemple suivant montre comment utiliser la get-component commande pour obtenir les détails d'un composant lorsque vous spécifiez le nom de ressource Amazon du composant (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 auprès du AWS CLI

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

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