

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 imágenes
<a name="image-recipe-details"></a>

En esta sección se describen las distintas formas de encontrar información y ver los detalles de sus recetas de imágenes de Generador de Imágenes de EC2.

**Topics**
+ [Enumerar recetas de imágenes de la consola](#list-image-recipes-console)
+ [Enumere las recetas de imágenes del AWS CLI](#cli-list-image-recipes)
+ [Ver los detalles de la receta de imágenes de la consola](#view-image-recipe-details-console)
+ [Obtenga detalles de la receta en imagen en el AWS CLI](#cli-get-image-recipe)
+ [Obtenga información detallada sobre la política de recetas en la AWS CLI](#cli-get-image-recipe-policy)

## Enumerar recetas de imágenes de la consola
<a name="list-image-recipes-console"></a>

Para ver una lista de las recetas de imágenes creadas 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. Elija **Recetas de imágenes** en el panel de navegación. Aquí se muestra una lista de las recetas de imágenes 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 imágenes del AWS CLI
<a name="cli-list-image-recipes"></a>

En el siguiente ejemplo se indica cómo enumerar todas las recetas de imágenes mediante la AWS CLI.

```
aws imagebuilder list-image-recipes
```

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

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

Puede filtrar los resultados por propietario para controlar las recetas que devuelve el comando.

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

`Self`Utilízalo para mostrar las recetas que tienes o `Shared` para mostrar las recetas que otras cuentas han compartido contigo.

```
aws imagebuilder list-image-recipes --owner Shared
```

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

## Ver los detalles de la receta de imágenes de la consola
<a name="view-image-recipe-details-console"></a>

Para ver los detalles de una receta de imágenes específica usando la consola de Generador de Imágenes, seleccione la receta de imágenes que desee revisar siguiendo los pasos que se describen en [Enumerar recetas de imágenes de la consola](#list-image-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. Después de seleccionar **Crear canalización a partir de esta receta**, accederá al asistente de canalización. 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 nueva receta no está disponible.

## Obtenga detalles de la receta en imagen en el AWS CLI
<a name="cli-get-image-recipe"></a>

El siguiente ejemplo muestra cómo usar un comando **imagebuilder** de la CLI para ver los detalles de una receta de imágenes especificando su nombre de recurso de Amazon (ARN).

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

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

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

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

Una política de recetas es una política basada en 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-image-recipe-policy` comando.

**nota**  
Si configuras la política de recursos directamente con`put-image-recipe-policy`, debes promover el recurso a un AWS RAM recurso compartido para que sea visible para los principales con los que lo compartes. Para obtener más información, consulte [Opción 2: aplicar una política de recursos y convertirla en un recurso compartido existente](manage-shared-resources-share.md#share-opt2-promote-resource-share).

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

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