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 les images et créer des versions Sur la page **Images** de la console Image Builder, vous pouvez consulter la liste de toutes les ressources d'image Image Builder que vous possédez, qui sont partagées avec vous et auxquelles vous avez accès. Les résultats de la liste incluent des informations clés sur ces ressources. Vous pouvez également voir toutes les images de votre compte pour lesquelles des actions de flux de travail sont en attente. **Topics** + [Liste des images](#list-images) + [Répertorier les images en attente d'action](#list-images-waiting-for-action) + [Lister les versions de génération d'images](#list-image-build-versions) ## Liste des images Cette section décrit les différentes manières de répertorier les informations relatives à vos images. Vous pouvez utiliser l'une des méthodes suivantes pour répertorier les ressources d'image Image Builder auxquelles vous avez accès. Pour l'action de l'API, voir le [ListImages](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html)Guide de *référence de l'API EC2 Image Builder*. Pour la demande de SDK associée, reportez-vous au lien [Voir aussi](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html#API_ListImages_SeeAlso) sur la même page. **Topics** + [Répertorier les images dans la console](#list-images-console) + [Répertorier les images avec des AWS CLI commandes](#list-images-cli) ### Répertorier les images dans la console Pour ouvrir la page de liste des **images** dans la console, procédez comme suit : 1. Ouvrez la console EC2 Image Builder à l'adresse [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. Choisissez **Images** dans le volet de navigation. La page **Images** de la console est divisée en onglets, en fonction de la propriété de l'image ou des actions de flux de travail en attente. Cette section couvre les trois premiers onglets qui affichent les images que vous possédez ou auxquelles vous avez accès. #### Onglet console : Je suis propriétaire Dans l'onglet **Owned by me**, vous pouvez utiliser les filtres suivants pour rationaliser les résultats de la liste d'images. + Vous pouvez rechercher tout ou partie du nom dans la barre de recherche. + Vous pouvez filtrer les images en fonction de la plate-forme de leur système d'exploitation (Windows, Linux ou macOS). + Vous pouvez filtrer les images en fonction du type de sortie qu'elles produisent (AMI ou image de conteneur). + Vous pouvez utiliser le **filtre source** pour rechercher des images importées depuis une machine virtuelle (VMIE) ou depuis une image de disque ISO. Après les contrôles de filtre, l'onglet **Owned by me** affiche la liste des images Image Builder que vous avez créées, avec les détails suivants pour les ressources répertoriées : **Nom/Version** Les noms des ressources d'image Image Builder commencent par le nom de la recette et la version à partir de laquelle elles ont été créées. Sélectionnez le lien pour voir toutes les versions de génération d'image associées. **Type** Type d'image de sortie créée par Image Builder pour cette ressource d'image (une AMI ou une image de conteneur). **Plateforme** La plate-forme du système d'exploitation de la ressource image, par exemple « Linux », « Windows » ou « macOS ». **Source de l'image** Origine de l'image de base utilisée par Image Builder pour créer cette ressource d'image. Ceci est principalement utilisé pour filtrer les résultats des images importées depuis une machine virtuelle (**VMIE**). **Heure de création** Date et heure auxquelles Image Builder a créé la version actuelle de la ressource d'image. **ARN** Le nom de ressource Amazon (ARN) de la version actuelle de la ressource image. #### Onglet console : partagé avec moi Dans l'onglet **Partagé avec moi**, vous pouvez utiliser les filtres suivants pour rationaliser les résultats de la liste d'images. + Vous pouvez rechercher tout ou partie du nom dans la barre de recherche. + Vous pouvez filtrer les images en fonction de la plate-forme de leur système d'exploitation (Windows, Linux ou macOS). + Vous pouvez filtrer les images en fonction du type de sortie qu'elles produisent (AMI ou image de conteneur). + Vous pouvez utiliser le **filtre source** pour rechercher des images importées depuis une machine virtuelle (VMIE) ou depuis une image de disque ISO. Après les contrôles de filtre, l'onglet **Shared with me** affiche une liste des images Image Builder qui ont été partagées avec vous, avec les détails suivants pour les ressources répertoriées : **Nom de l'image** Le nom de la ressource d'image qui a été partagée avec vous. Pour utiliser une image partagée dans une recette, vous devez sélectionner l'option **Sélectionner les images gérées** et modifier l'**origine de l'image** en **Images partagées avec moi**. **Type** Type d'image de sortie créée par Image Builder pour cette ressource d'image (une AMI ou une image de conteneur). **Version** Version de la plate-forme du système d'exploitation pour la ressource image, généralement un champ numérique au format suivant :. . . **Source de l'image** Origine de l'image de base utilisée par Image Builder pour créer cette ressource d'image, le cas échéant. Ceci est principalement utilisé pour filtrer les résultats des images importées depuis une machine virtuelle (**VMIE**). **Plateforme** La plate-forme du système d'exploitation de la ressource image, par exemple « Linux », « Windows » ou « macOS ». **Heure de création** Date et heure auxquelles Image Builder a créé la version de la ressource d'image qui a été partagée avec vous. **Propriétaire** Le propriétaire de la ressource d'image partagée. **ARN** Le nom de ressource Amazon (ARN) de la version de la ressource image qui a été partagée avec vous. #### Onglet console : géré par Amazon Dans l'onglet **Managed by Amazon**, vous pouvez utiliser les filtres suivants pour rationaliser les résultats des listes d'images. + Vous pouvez rechercher tout ou partie du nom dans la barre de recherche. + Vous pouvez filtrer les images en fonction de la plate-forme de leur système d'exploitation (Windows, Linux ou macOS). + Vous pouvez filtrer les images en fonction du type de sortie qu'elles produisent (AMI ou image de conteneur). + Vous pouvez utiliser le **filtre source** pour rechercher des images importées depuis une machine virtuelle (VMIE) ou depuis une image de disque ISO. Après les contrôles de filtre, l'onglet **Managed by Amazon** affiche une liste d'images Image Builder gérées par Amazon que vous pouvez utiliser comme images de base pour vos recettes. Image Builder affiche les informations suivantes pour les ressources répertoriées : **Nom de l'image** Nom de l'image gérée. Lorsque vous créez une recette, l'image de base par défaut est **Quick start (géré par Amazon)**. Les images répertoriées dans cet onglet alimentent la liste des **noms d'images** associée à la plate-forme du système d'exploitation que vous choisissez pour votre image de base lorsque vous créez une recette. **Type** Type d'image de sortie créée par Image Builder pour cette ressource d'image (une AMI ou une image de conteneur). **Version** Version de la plate-forme du système d'exploitation pour la ressource image, généralement un champ numérique au format suivant :. . . **Plateforme** La plate-forme du système d'exploitation de la ressource image, par exemple « Linux », « Windows » ou « macOS ». **Heure de création** Date et heure auxquelles Image Builder a créé la version de la ressource d'image qui a été partagée avec vous. **Propriétaire** Amazon est propriétaire des images gérées. **ARN** Le nom de ressource Amazon (ARN) de la version de la ressource image qui a été partagée avec vous. ### Répertorier les images avec des AWS CLI commandes Lorsque vous exécutez la **[list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)** commande dans le AWS CLI, vous pouvez obtenir une liste des images que vous possédez ou auxquelles vous avez accès. L'exemple de commande suivant montre comment utiliser la **list-images** commande sans filtre pour répertorier toutes les ressources d'image Image Builder que vous possédez. **Exemple : liste toutes les images** ``` aws imagebuilder list-images ``` **Sortie** : ``` { "requestId": "1abcd234-e567-8fa9-0123-4567b890cd12", "imageVersionList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0", "name": "image-recipe-name", "type": "AMI", "version": "1.0.0", "platform": "Linux", "owner": "123456789012", "dateCreated": "2022-04-28T01:38:23.286Z" }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-win/1.0.1", "name": "image-recipe-win", "type": "AMI", "version": "1.0.1", "platform": "Windows", "owner": "123456789012", "dateCreated": "2022-04-28T01:38:23.286Z" }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-macos/1.1.1", "name": "image-recipe-macos", "type": "AMI", "version": "1.1.1", "platform": "macOS", "owner": "123456789012", "dateCreated": "2022-04-28T01:38:23.286Z" } ] } ``` Lorsque vous exécutez la **list-images** commande, vous pouvez appliquer des filtres pour rationaliser les résultats, comme le montre l'exemple suivant. Pour plus d'informations sur le filtrage des résultats, consultez la commande [list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html) dans la référence des *AWS CLI commandes*. **Exemple : filtre pour images Linux** ``` aws imagebuilder list-images --filters name="platform",values="Linux" ``` **Sortie** : ``` { "requestId": "1abcd234-e567-8fa9-0123-4567b890cd12", "imageVersionList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0", "name": "image-recipe-name", "type": "AMI", "version": "1.0.0", "platform": "Linux", "owner": "123456789012", "dateCreated": "2022-04-28T01:38:23.286Z" } ] } ``` ## Répertorier les images en attente d'action Lorsque vous utilisez l'action d'`WaitForAction`étape dans votre flux de travail d'images, le flux de travail est suspendu jusqu'à ce que vous lui envoyiez un signal lui demandant de reprendre le traitement ou d'échouer. Vous pouvez utiliser cette action d'étape si un processus externe doit être exécuté avant de continuer. Vous pouvez ensuite utiliser le `SendWorkflowStepAction` pour envoyer un signal à l'étape interrompue vers `RESUME` ou`STOP`. Vous pouvez également arrêter ou reprendre votre flux de travail depuis la console. Les onglets suivants indiquent comment obtenir une liste de toutes les ressources d'image de votre compte avec les étapes du flux de travail actuellement suspendues pour attendre la reprise ou l'arrêt d'un signal. Les onglets couvrent les étapes de la console et la AWS CLI commande. Vous pouvez également utiliser l'API ou un SDK pour obtenir une liste des étapes du flux de travail en attente d'une action. Pour l'action de l'API, voir le [ListWaitingWorkflowSteps](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html)Guide de *référence de l'API EC2 Image Builder*. Pour la demande de SDK associée, reportez-vous au lien [Voir aussi](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html#API_ListWaitingWorkflowSteps_SeeAlso) sur la même page. ------ #### [ Console ] Pour accéder à l'onglet **En attente d'action** de la console, procédez comme suit : 1. Ouvrez la console EC2 Image Builder à l'adresse [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. Choisissez **Images** dans le volet de navigation. Cela ouvre la page de liste des **images**. 1. Sélectionnez l'onglet **En attente d'action** dans la page de liste. 1. (facultatif) Pour arrêter ou reprendre une étape, cochez la case à côté du nom, puis choisissez **Arrêter l'étape** ou **Reprendre l'étape**. Vous pouvez cocher plusieurs cases pour exécuter la même action pour toutes les étapes sélectionnées. **Détails des étapes du flux de travail en attente** Les détails du flux de travail pour l'étape en attente sont les suivants : + **Nom de l'image** : nom de la ressource d'image dont l'étape est en attente. Vous pouvez sélectionner le lien du nom pour afficher la page détaillée de cette image. + **Nom de l'étape en attente** : nom de l'étape du flux de travail en attente d'une action. + **ID d'exécution de l'étape** : identifie de manière unique l'instance d'exécution de l'étape du flux de travail. Vous pouvez sélectionner l'ID lié pour afficher les détails d'exécution de l'étape. + **Début de l'étape** : horodatage du début de l'instance d'exécution de l'étape du flux de travail. + **ARN du flux** de travail : nom de ressource Amazon (ARN) du flux de travail avec l'étape en attente. + **Actions** : action d'étape en état d'attente. ------ #### [ AWS CLI ] Lorsque vous exécutez la **[list-waiting-workflow-steps](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-waiting-workflow-steps.html)** commande dans le AWS CLI, vous obtenez une liste de toutes les images de votre compte dont les étapes du flux de travail sont en attente d'une action avant de terminer le processus de création d'image. L'exemple de commande suivant montre comment utiliser la **list-waiting-workflow-steps** commande pour répertorier toutes les images de votre compte avec les étapes du flux de travail en attente d'une action. **Exemple : répertorier les images de votre compte avec les étapes du flux de travail en attente** ``` aws imagebuilder list-waiting-workflow-steps ``` **Sortie** : Le résultat de cet exemple montre une image du compte avec une étape en attente d'action. ``` { "steps": [ { "imageBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:image/example-image/1.0.0/8", "name": "WaitForAction", "workflowExecutionId": "wf-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "stepExecutionId": "step-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/wait-for-action/1.0.0/1", "startTime": "2023-11-21T23:21:23.609Z", "action": "WaitForAction" } ] } ``` ------ ## Lister les versions de génération d'images Sur la page des **versions de génération** d'images de la console Image Builder, vous pouvez consulter la liste des versions de génération et des informations supplémentaires sur une ressource d'image dont vous êtes le propriétaire. Vous pouvez également utiliser des commandes ou des actions avec l'API Image Builder ou AWS CLI pour répertorier les versions de génération d'image. SDKs Vous pouvez utiliser l'une des méthodes suivantes pour répertorier les versions de génération d'image pour les ressources d'images que vous possédez. Pour l'action de l'API, voir le [ListImageBuildVersions](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html)Guide de *référence de l'API EC2 Image Builder*. Pour la demande de SDK associée, reportez-vous au lien [Voir aussi](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html#API_ListImageBuildVersions_SeeAlso) sur la même page. ------ #### [ Console ] **Détails de la version** La page des **versions d'Image build** de la console Image Builder contient les informations suivantes : + **Version — Version** de génération de la ressource image. Dans la console Image Builder, la version renvoie à une page détaillée de l'image. + **Type** : type de sortie distribué par Image Builder lors de la création de cette ressource d'image (une AMI ou une image de conteneur). + **Date de création** : date et heure auxquelles Image Builder a créé la version de génération de l'image. + **État de l'image** — État actuel de la version créée par l'image. L'état peut être lié à la création ou à la disposition de l'image. Par exemple, pendant le processus de création, vous pouvez voir le statut `Building` ou`Distributing`. Pour la disposition de l'image, le statut `Deprecated` ou peut s'afficher`Deleted`. + **Raison de l'échec** : raison de l'état de l'image. La console Image Builder affiche uniquement la raison de l'échec de la génération (le **statut de l'image** est égal à`Failed`). + **Résultats de sécurité : résultats** de numérisation d'images agrégés pour la version de génération d'image référencée. + **ARN** — Le nom de ressource Amazon (ARN) pour la version référencée de la ressource image. + **Flux de journal** : lien vers le détail du flux de journal pour la version de génération de l'image référencée. **Versions de liste** Pour répertorier les versions de génération d'image dans la console Image Builder, effectuez les opérations suivantes : 1. Ouvrez la console EC2 Image Builder à l'adresse [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/). 1. Choisissez **Images** dans le volet de navigation. Par défaut, la liste des images affiche la version actuelle de chacune des images que vous possédez. 1. Pour voir la liste de toutes les versions d'une image, cliquez sur le lien de la version actuelle. Le lien ouvre la page **des versions de génération d'image** qui répertorie toutes les versions de génération pour une image spécifique. ------ #### [ AWS CLI ] Lorsque vous exécutez la **[list-image-build-versions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html)** commande dans le AWS CLI, vous obtenez une liste complète des versions de build pour la ressource d'image spécifiée. Vous devez posséder l'image pour exécuter cette commande. L'exemple de commande suivant montre comment utiliser la **list-image-build-versions** commande pour répertorier toutes les versions de compilation pour l'image spécifiée. **Exemple : liste des versions de compilation pour une image spécifique** ``` aws imagebuilder list-image-build-versions --image-version-arn arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0 ``` **Sortie** : La sortie de cet exemple inclut deux versions de génération pour la recette d'image spécifiée. ``` { "requestId": "12f3e45d-67cb-8901-af23-45ed678c9b01", "imageSummaryList": [ { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/2", "name": "image-recipe-name", "type": "AMI", "version": "1.0.0/2", "platform": "Linux", "osVersion": "Amazon Linux 2", "state": { "status": "AVAILABLE" }, "owner": "123456789012", "dateCreated": "2023-03-10T01:04:40.609Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-012b3456789012c3d", "name": "image-recipe-name 2023-03-10T01-05-12.541Z", "description": "First verison of image-recipe-name", "accountId": "123456789012" } ] }, "tags": {} }, { "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-name/1.0.0/1", "name": "image-recipe-name", "type": "AMI", "version": "1.0.0/1", "platform": "Linux", "osVersion": "Amazon Linux 2", "state": { "status": "AVAILABLE" }, "owner": "123456789012", "dateCreated": "2023-03-10T00:07:16.384Z", "outputResources": { "amis": [ { "region": "us-west-2", "image": "ami-0d1e23456789f0a12", "name": "image-recipe-name 2023-03-10T00-07-18.146132Z", "description": "First verison of image-recipe-name", "accountId": "123456789012" } ] }, "tags": {} } ] } ``` **Note** Le résultat de la **list-image-build-versions** commande n'inclut pas les résultats de sécurité ni les flux de journaux pour le moment. ------