

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Enumeración y visualización de los detalles de una receta de contenedor
<a name="container-recipe-details"></a>

Esta sección describe las formas en las que puede encontrar información y ver los detalles de sus recetas de contenedor de Generador de Imágenes de EC2.

**Topics**
+ [Enumeración de las recetas de contenedor en la consola](#list-container-recipes-console)
+ [Enumere las recetas de contenedores con el AWS CLI](#cli-list-container-recipes)
+ [Ver los detalles de la receta de contenedor en la consola](#view-container-recipe-details-console)
+ [Obtén información detallada sobre la receta del contenedor con el AWS CLI](#cli-get-container-recipe)
+ [Obtenga información detallada sobre la política de recetas para contenedores en el AWS CLI](#cli-get-container-recipe-policy)

## Enumeración de las recetas de contenedor en la consola
<a name="list-container-recipes-console"></a>

Para ver una lista de las recetas de contenedor que se han creado en su cuenta en la consola de Generador de Imágenes, siga estos pasos:

1. Abra la consola de EC2 Image Builder en [ https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).

1. En el panel de navegación, elija **Recetas de contenedor**. Aquí se muestra una lista de las recetas de contenedor que se han creado en su cuenta.

1. Para ver los detalles o crear una nueva versión de la receta, seleccione el enlace del **nombre de la receta**. Esto abre la vista detallada de la receta.
**nota**  
También puede seleccionar la casilla junto al **nombre de la receta**, y, a continuación, elegir **Ver detalles**.

## Enumere las recetas de contenedores con el AWS CLI
<a name="cli-list-container-recipes"></a>

En el ejemplo siguiente se indica cómo enumerar todas sus recetas de contenedor mediante la AWS CLI.

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

El comando devuelve un resumen de cada receta de contenedor, como se muestra en el siguiente ejemplo de salida.

```
{
    "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": {}
        }
    ]
}
```

Puede filtrar los resultados por propietario para controlar las recetas que devuelve el comando. `Self`Utilízalo para mostrar las recetas que tienes o `Shared` para mostrar las recetas que otras cuentas han compartido contigo.

```
aws imagebuilder list-container-recipes --owner Self
```

Para limitar el número de resultados que devuelve el comando en cada página, utilice el `--max-results` parámetro. Si hay más resultados disponibles, la respuesta incluye un `nextToken` valor que se pasa al siguiente comando para recuperar la página siguiente.

```
aws imagebuilder list-container-recipes --max-results 10 --next-token "{{eyJuZXh0VG9rZW4...}}"
```

## Ver los detalles de la receta de contenedor en la consola
<a name="view-container-recipe-details-console"></a>

Para ver los detalles de una receta de contenedor específica con la consola de Generador de Imágenes, seleccione la receta de contenedor que desee revisar y siga los pasos que se describen en [Enumeración de las recetas de contenedor en la consola](#list-container-recipes-console).

En la página de detalles de la receta, puede hacer lo siguiente:
+ Elimine la receta. Para obtener más información sobre cómo eliminar recursos en Generador de Imágenes, consulte [Eliminación de recursos de Generador de imágenes obsoletos o no utilizados](delete-resources.md).
+ Cree una nueva versión.
+ Cree una canalización a partir de la receta. Tras seleccionar ** Crear canalización a partir de esta receta**, la consola abre el asistente de canalizaciones. Para obtener más información sobre la creación de una canalización de Generador de Imágenes usando el asistente de canalización, consulte [Tutorial: creación de una canalización de imágenes con una AMI de salida desde el asistente de la consola de Generador de Imágenes](start-build-image-pipeline.md)
**nota**  
Al crear una canalización a partir de una receta existente, la opción de crear una receta nueva no está disponible.

## Obtén información detallada sobre la receta del contenedor con el AWS CLI
<a name="cli-get-container-recipe"></a>

El siguiente ejemplo muestra cómo utilizar un comando **imagebuilder** CLI de para obtener los detalles de una receta de contenedor especificando su ARN.

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

El comando devuelve la receta completa del contenedor, que se muestra en el siguiente ejemplo de salida.

```
{
    "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}}"
    }
}
```

## Obtenga información detallada sobre la política de recetas para contenedores en el AWS CLI
<a name="cli-get-container-recipe-policy"></a>

Una política de recetas es una política basada en los recursos. Controla el acceso multicuenta a tu receta. Cuando compartes una receta a través de AWS Resource Access Manager (AWS RAM), Image Builder crea la política automáticamente. También puede establecer una política personalizada con el `put-container-recipe-policy` comando.

El siguiente ejemplo muestra cómo utilizar un comando **imagebuilder** de la CLI de para obtener los detalles de la política de una receta de contenedor especificando su ARN. Si no hay ninguna política adjunta a la receta, la respuesta está vacía.

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