View a markdown version of this page

Répertorier et afficher les détails des recettes avec des images - EC2 Image Builder
Répertorier les recettes d'images depuis la consoleRépertoriez les recettes illustrées du AWS CLIAfficher les détails des recettes illustrées depuis la consoleObtenez des informations détaillées sur les recettes avec des images sur AWS CLIObtenez les détails de la politique relative aux recettes illustrées auprès 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 recettes avec des images

Cette section décrit les différentes manières de rechercher des informations et de visualiser les détails de vos recettes d'images EC2 Image Builder.

Répertorier les recettes d'images depuis la console

Pour consulter la liste des recettes d'images créées sous votre compte dans la console Image Builder, procédez comme suit :

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

  2. Choisissez des recettes d'images dans le volet de navigation. Cela affiche une liste des recettes d'images créées sous votre compte.

  3. Pour afficher les détails ou créer une nouvelle version de recette, cliquez sur le lien Nom de la recette. Cela ouvre la vue détaillée de la recette.

    Note

    Vous pouvez également cocher la case à côté du nom de la recette, puis choisir Afficher les détails.

Répertoriez les recettes illustrées du AWS CLI

L'exemple suivant montre comment répertorier toutes vos recettes d'images à l'aide du AWS CLI.

aws imagebuilder list-image-recipes

La commande renvoie un résumé pour chaque recette d'image, comme indiqué dans l'exemple de sortie suivant.

{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "imageRecipeSummaryList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.0",
            "name": "my-recipe",
            "platform": "Linux",
            "owner": "123456789012",
            "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/amazon-linux-2023-x86/x.x.x",
            "dateCreated": "2024-01-15T10:30:00.000Z",
            "tags": {
                "Environment": "Production"
            }
        }
    ]
}

Vous pouvez filtrer les résultats par propriétaire pour contrôler les recettes renvoyées par la commande.

aws imagebuilder list-image-recipes --owner Self

SelfUtilisez-le pour répertorier les recettes que vous possédez ou Shared pour répertorier les recettes que d'autres comptes ont partagées avec vous.

aws imagebuilder list-image-recipes --owner Shared

Pour limiter le nombre de résultats renvoyés par la commande sur chaque page, utilisez le --max-results paramètre. Si d'autres résultats sont disponibles, la réponse inclut une nextToken valeur que vous transmettez à la commande suivante pour récupérer la page suivante.

aws imagebuilder list-image-recipes --max-results 10 --next-token "eyJuZXh0VG9rZW4..."

Afficher les détails des recettes illustrées depuis la console

Pour afficher les détails d'une recette d'image spécifique à l'aide de la console Image Builder, sélectionnez la recette d'image à consulter en suivant les étapes décrites dansRépertorier les recettes d'images depuis la console.

Sur la page détaillée de la recette, vous pouvez :

Obtenez des informations détaillées sur les recettes avec des images sur AWS CLI

L'exemple suivant montre comment utiliser une commande imagebuilder CLI pour obtenir les détails d'une recette d'image en spécifiant son Amazon Resource Name (ARN).

aws imagebuilder get-image-recipe --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.0

La commande renvoie la recette d'image complète, illustrée dans l'exemple de sortie suivant.

{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "imageRecipe": {
        "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.0",
        "name": "my-recipe",
        "description": "My Linux image recipe",
        "platform": "Linux",
        "version": "1.0.0",
        "components": [
            {
                "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.0.0/1"
            }
        ],
        "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/amazon-linux-2023-x86/x.x.x",
        "dateCreated": "2024-01-15T10:30:00.000Z",
        "tags": {},
        "owner": "123456789012"
    }
}

Obtenez les détails de la politique relative aux recettes illustrées auprès du AWS CLI

Une politique de recette est une politique basée sur les ressources. Il contrôle l'accès de tous les comptes à votre recette. Lorsque vous partagez une recette via AWS Resource Access Manager (AWS RAM), Image Builder crée automatiquement la politique. Vous pouvez également définir une politique personnalisée à l'aide de la put-image-recipe-policy commande.

Note

Si vous définissez la politique des ressources directement auprès deput-image-recipe-policy, vous devez ensuite promouvoir la ressource vers un partage de AWS RAM ressources afin qu'elle soit visible par les principaux acteurs avec lesquels vous la partagez. Pour de plus amples informations, veuillez consulter Option 2 : appliquer une politique de ressources et promouvoir vers un partage de ressources existant.

L'exemple suivant montre comment utiliser une commande imagebuilder CLI pour obtenir les détails d'une politique de recette d'image en spécifiant son ARN. Si aucune politique n'est associée à la recette, la réponse est vide.

aws imagebuilder get-image-recipe-policy --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.0