Lister les images Répertorier les images en attente d'action Répertorier les versions de génération d'

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.

Table des matières

Lister les images
Répertorier les images en attente d'action
Répertorier les versions de génération d'

Lister les 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'APIaction, voir ListImagesl'EC2Image Builder API Reference. Pour la SDK demande associée, reportez-vous au lien Voir aussi sur la même page.

Table des matières

Répertorier les images dans la console
Répertorier les images avec des AWS CLI commandes

Répertorier les images dans la console

Pour ouvrir la page de liste des images dans la console, procédez comme suit :

Ouvrez la console EC2 Image Builder à l'adresse https://console.aws.amazon.com/imagebuilder/.
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.

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 ou Linux).
Vous pouvez filtrer les images en fonction du type de sortie qu'elles produisent (AMIou de l'image du conteneur).
Vous pouvez utiliser le filtre source pour rechercher des images importées depuis une machine virtuelle avec leVMIE.

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. Cliquez sur 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 image AMI ou une image de conteneur).
Plateforme: La plate-forme du système d'exploitation de la version de la ressource d'image, par exemple « Windows » ou « Linux ».
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 la ressource Amazon (ARN) de la version actuelle de la ressource image.

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 ou Linux).
Vous pouvez filtrer les images en fonction du type de sortie qu'elles produisent (AMIou de l'image du conteneur).
Vous pouvez utiliser le filtre source pour rechercher des images importées depuis une machine virtuelle avec leVMIE.

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 image AMI ou une image de conteneur).
Version: La plate-forme du système d'exploitation de la version de la ressource d'image, par exemple « Windows » ou « Linux ».
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 version de la ressource d'image, par exemple « Windows » ou « Linux ».
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.

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 ou Linux).
Vous pouvez filtrer les images en fonction du type de sortie qu'elles produisent (AMIou de l'image du conteneur).
Vous pouvez utiliser le filtre source pour rechercher des images importées depuis une machine virtuelle avec leVMIE.

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 image AMI ou une image de conteneur).
Version: La plate-forme du système d'exploitation de la version de la ressource d'image, par exemple « Windows » ou « Linux ».
Plateforme: La plate-forme du système d'exploitation de la version de la ressource d'image, par exemple « Windows » ou « Linux ».
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 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"
		}
	]
}

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 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 ouSTOP. 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 le API ou an SDK pour obtenir une liste des étapes du flux de travail en attente d'une action. Pour l'APIaction, voir ListWaitingWorkflowStepsl'EC2Image Builder API Reference. Pour la SDK demande associée, reportez-vous au lien Voir aussi sur la même page.

Console

Pour accéder à l'onglet En attente d'action de la console, procédez comme suit :

Ouvrez la console EC2 Image Builder à l'adresse https://console.aws.amazon.com/imagebuilder/.
Choisissez Images dans le volet de navigation. Cela ouvre la page de liste des images.
Sélectionnez l'onglet En attente d'action dans la page de liste.
(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.
Flux de travail ARN : 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 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"
        }
    ]
}

Répertorier les versions de génération d'

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'Image Builder API 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'APIaction, voir ListImageBuildVersionsl'EC2Image Builder API Reference. Pour la SDK demande associée, reportez-vous au lien Voir aussi 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 image 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 ouDistributing. Pour la disposition de l'image, le statut Deprecated ou peut s'afficherDeleted.
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 la 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 :

Ouvrez la console EC2 Image Builder à l'adresse https://console.aws.amazon.com/imagebuilder/.
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.
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 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 être propriétaire de 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.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Ressources relatives aux images

Afficher les détails des ressources d'images