

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 des contenants
<a name="container-recipe-details"></a>

Cette section décrit comment vous pouvez trouver des informations et afficher les détails de vos recettes de conteneur EC2 Image Builder.

**Topics**
+ [Répertorier les recettes de conteneurs dans la console](#list-container-recipes-console)
+ [Répertoriez les recettes de contenants avec AWS CLI](#cli-list-container-recipes)
+ [Afficher les détails des recettes des contenants dans la console](#view-container-recipe-details-console)
+ [Obtenez des détails sur les recettes des contenants grâce au AWS CLI](#cli-get-container-recipe)
+ [Obtenez les détails de la politique relative aux recettes relatives aux contenants grâce au AWS CLI](#cli-get-container-recipe-policy)

## Répertorier les recettes de conteneurs dans la console
<a name="list-container-recipes-console"></a>

Pour consulter la liste des recettes de conteneurs qui ont été 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/ ](https://console.aws.amazon.com/imagebuilder/) l'adresse.

1. Choisissez des recettes ** de ** conteneurs dans le volet de navigation. Cela affiche une liste des recettes de conteneurs créées sous votre compte.

1. 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 de contenants avec AWS CLI
<a name="cli-list-container-recipes"></a>

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

```
aws imagebuilder list-container-recipes
```

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

```
{
    "requestId": "{{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}}",
    "containerRecipeSummaryList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:{{123456789012}}:container-recipe/{{my-container-recipe}}/1.0.0",
            "name": "{{my-container-recipe}}",
            "containerType": "DOCKER",
            "platform": "Linux",
            "owner": "{{123456789012}}",
            "dateCreated": "2024-01-15T10:30:00.000Z",
            "tags": {}
        }
    ]
}
```

Vous pouvez filtrer les résultats par propriétaire pour contrôler les recettes renvoyées par la commande. `Self`Utilisez-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-container-recipes --owner Self
```

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-container-recipes --max-results 10 --next-token "{{eyJuZXh0VG9rZW4...}}"
```

## Afficher les détails des recettes des contenants dans la console
<a name="view-container-recipe-details-console"></a>

Pour afficher les détails d'une recette de conteneur spécifique à l'aide de la console Image Builder, sélectionnez la recette de conteneur à consulter et suivez les étapes décrites dans[Répertorier les recettes de conteneurs dans la console](#list-container-recipes-console).

Sur la page détaillée de la recette, vous pouvez effectuer les opérations suivantes :
+ Supprimez la recette. Pour plus d'informations sur la suppression de ressources dans Image Builder, consultez[Supprimer les ressources d'Image Builder obsolètes ou inutilisées](delete-resources.md).
+ Créez une nouvelle version.
+ Créez un pipeline à partir de la recette. Une fois que vous avez choisi ** Créer un pipeline à partir de cette recette**, la console ouvre l'assistant de pipeline. Pour plus d'informations sur la création d'un pipeline Image Builder à l'aide de l'assistant de pipeline, voir [Tutoriel : Création d'un pipeline d'images avec une AMI de sortie à partir de l'assistant de console Image Builder](start-build-image-pipeline.md)
**Note**  
Lorsque vous créez un pipeline à partir d'une recette existante, l'option permettant de créer une nouvelle recette n'est pas disponible.

## Obtenez des détails sur les recettes des contenants grâce au AWS CLI
<a name="cli-get-container-recipe"></a>

L'exemple suivant montre comment utiliser une commande **imagebuilder** CLI pour obtenir les détails d'une recette de conteneur en spécifiant son ARN.

```
aws imagebuilder get-container-recipe --container-recipe-arn arn:aws:imagebuilder:us-west-{{2:123456789012}}:container-recipe/{{my-container-recipe}}/1.0.2
```

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

```
{
    "requestId": "{{a1b2c3d4-5678-90ab-cdef-EXAMPLE11111}}",
    "containerRecipe": {
        "arn": "arn:aws:imagebuilder:us-west-2:{{123456789012}}:container-recipe/{{my-container-recipe}}/1.0.2",
        "containerType": "DOCKER",
        "name": "{{my-container-recipe}}",
        "description": "{{My Linux Docker container image}}",
        "platform": "Linux",
        "components": [
            {
                "componentArn": "arn:aws:imagebuilder:us-west-2:{{123456789012}}:component/{{my-component}}/1.0.0/1"
            }
        ],
        "parentImage": "amazonlinux:latest",
        "dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
        "targetRepository": {
            "service": "ECR",
            "repositoryName": "{{my-repo}}"
        },
        "dateCreated": "2024-01-15T10:30:00.000Z",
        "owner": "{{123456789012}}"
    }
}
```

## Obtenez les détails de la politique relative aux recettes relatives aux contenants grâce au AWS CLI
<a name="cli-get-container-recipe-policy"></a>

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-container-recipe-policy` commande.

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

```
aws imagebuilder get-container-recipe-policy --container-recipe-arn arn:aws:imagebuilder:us-west-{{2:123456789012}}:container-recipe/{{my-container-recipe}}/1.0.2
```