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 de imágenes y versiones de compilación
En la página **Imágenes** de la consola de Generador de imágenes, puede ver listas de todos los recursos de imágenes de Generador de imágenes que le pertenecen, que han compartido con usted y a los que tiene acceso. Los resultados de la lista incluyen algunos detalles clave sobre esos recursos.
También puede ver todas las imágenes de la cuenta que tienen pendientes acciones de flujo de trabajo.
**Topics**
+ [Enumeración de imágenes](#list-images)
+ [Enumeración de imágenes en espera de acción](#list-images-waiting-for-action)
+ [Enumeración de las versiones de compilación de imágenes](#list-image-build-versions)
## Enumeración de imágenes
En esta sección se describen las distintas formas de enumerar la información sobre las imágenes.
Puede usar uno de los siguientes métodos para enumerar los recursos de imágenes de Generador de Imágenes a los que tiene acceso. Para ver la acción de la API, consulte [ListImages](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html)la *Referencia de la API de EC2 Image Builder*. Para la solicitud de SDK asociada, consulte el enlace [Véase también](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImages.html#API_ListImages_SeeAlso) en la misma página.
**Topics**
+ [Enumeración de las imágenes en la consola](#list-images-console)
+ [Enumere las imágenes con comandos AWS CLI](#list-images-cli)
### Enumeración de las imágenes en la consola
Para abrir la página de lista **Imágenes** en la consola, sigue estos pasos:
1. Abra la consola EC2 de Image Builder en [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Elija **Imágenes** en el panel de navegación.
La página **Imágenes** de la consola se divide en pestañas, según la propiedad de la imagen o las acciones pendientes del flujo de trabajo. En esta sección se describen las tres primeras pestañas en las que se muestran las imágenes de su propiedad o a las que tiene acceso.
#### Pestaña de la consola: De mi propiedad
En la pestaña **De mi propiedad**, puede utilizar los siguientes filtros para optimizar los resultados de la lista de imágenes.
+ En la barra de búsqueda, puede buscar la totalidad o parte del nombre.
+ Puede filtrar las imágenes en función de la plataforma del sistema operativo (Windows, Linux o macOS).
+ Puede filtrar las imágenes en función del tipo de salida que producen (imagen de AMI o de contenedor).
+ Puede utilizar la **fuente del filtro** para buscar imágenes importadas desde una máquina virtual (VMIE) o desde una imagen de disco ISO.
Siguiendo los controles de filtro, en la pestaña **De mi propiedad** se muestra una lista de las imágenes de Generador de imágenes que ha creado, con los siguientes detalles de los recursos de la lista:
**Nombre y versión**
Los nombres de los recursos de imagen de Generador de imágenes comienzan con el nombre de la receta y la versión a partir de la cual se crearon. Seleccione el enlace para ver todas las versiones de creación de imágenes relacionadas.
**Tipo**
Tipo de la imagen de salida que Generador de imágenes crea para este recurso de imagen (una imagen de AMI o de contenedor).
**Plataforma**
Plataforma del sistema operativo del recurso de imagen, por ejemplo, "Linux", "Windows" o "macOS".
**Fuente de imagen**
Origen de la imagen base que Generador de imágenes utilizó para crear este recurso de imagen. Se utiliza principalmente para filtrar los resultados de las imágenes importadas desde una máquina virtual (**VMIE**).
**Hora de creación**
Fecha y hora en que Generador de imágenes creó la versión actual del recurso de imagen.
**ARN**
Nombre de recurso de Amazon (ARN) de la versión actual del recurso de imagen.
#### Pestaña de la consola: Compartido conmigo
En la pestaña **Compartido conmigo**, puede utilizar los siguientes filtros para optimizar los resultados de la lista de imágenes.
+ En la barra de búsqueda, puede buscar la totalidad o parte del nombre.
+ Puede filtrar las imágenes en función de la plataforma del sistema operativo (Windows, Linux o macOS).
+ Puede filtrar las imágenes en función del tipo de salida que producen (imagen de AMI o de contenedor).
+ Puede utilizar la **fuente del filtro** para buscar imágenes importadas de una máquina virtual (VMIE) o de una imagen de disco ISO.
Siguiendo los controles de filtro, en la pestaña **Compartido conmigo** se muestra una lista de las imágenes de Generador de imágenes que se han compartido con usted, con los siguientes detalles de los recursos de la lista:
**Nombre de la imagen**
Nombre del recurso de imagen que se compartió con usted. Para utilizar una imagen compartida en una receta, seleccione la opción **Seleccionar imágenes administradas** y cambie el **Origen de la imagen** a **Imágenes compartidas conmigo**.
**Tipo**
Tipo de la imagen de salida que Generador de imágenes crea para este recurso de imagen (una imagen de AMI o de contenedor).
**Versión**
La versión de la plataforma del sistema operativo para el recurso de imagen, normalmente un campo numérico con el siguiente formato:. . .
**Fuente de imagen**
Origen de la imagen base que Generador de imágenes utilizó para crear este recurso de imagen, si corresponde. Se utiliza principalmente para filtrar los resultados de las imágenes importadas desde una máquina virtual (**VMIE**).
**Plataforma**
Plataforma del sistema operativo del recurso de imagen, por ejemplo, "Linux", "Windows" o "macOS".
**Hora de creación**
Fecha y hora en que Generador de imágenes creó la versión del recurso de imagen que se compartió con usted.
**Propietario**
Propietario del recurso de imagen compartido.
**ARN**
Nombre de recurso de Amazon (ARN) de la versión del recurso de imagen que se compartió con usted.
#### Pestaña de la consola: Administrado por Amazon
En la pestaña **Administrado por Amazon**, puede utilizar los siguientes filtros para optimizar los resultados de la lista de imágenes.
+ En la barra de búsqueda, puede buscar la totalidad o parte del nombre.
+ Puede filtrar las imágenes en función de la plataforma del sistema operativo (Windows, Linux o macOS).
+ Puede filtrar las imágenes en función del tipo de salida que producen (imagen de AMI o de contenedor).
+ Puede utilizar la **fuente del filtro** para buscar imágenes importadas de una máquina virtual (VMIE) o de una imagen de disco ISO.
Siguiendo los controles de filtro, en la pestaña **Administrado por Amazon** se muestra una lista de imágenes de Generador de imágenes administradas por Amazon que puede utilizar como imágenes base para las recetas. En Generador de imágenes se muestran los siguientes detalles de los recursos enumerados:
**Nombre de la imagen**
Nombre de la imagen administrada. Al crear una receta, el valor predeterminado de la imagen base es **Inicio rápido (administrado por Amazon)**. Las imágenes que aparecen en esta pestaña rellenan la lista **Nombre de la imagen**, asociada a la plataforma del sistema operativo que elija como imagen base al crear una receta.
**Tipo**
Tipo de la imagen de salida que Generador de imágenes crea para este recurso de imagen (una imagen de AMI o de contenedor).
**Versión**
La versión de la plataforma del sistema operativo para el recurso de imagen, normalmente un campo numérico con el siguiente formato:. . .
**Plataforma**
Plataforma del sistema operativo del recurso de imagen, por ejemplo, "Linux", "Windows" o "macOS".
**Hora de creación**
Fecha y hora en que Generador de imágenes creó la versión del recurso de imagen que se compartió con usted.
**Propietario**
Las imágenes administradas son propiedad de Amazon.
**ARN**
Nombre de recurso de Amazon (ARN) de la versión del recurso de imagen que se compartió con usted.
### Enumere las imágenes con comandos AWS CLI
Al ejecutar el **[list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html)** comando en el AWS CLI, puede obtener una lista de imágenes de su propiedad o a las que tiene acceso.
En el siguiente ejemplo de comando se muestra cómo utilizar el comando **list-images** sin filtros para enumerar todos los recursos de imágenes de Generador de imágenes de su propiedad.
**Ejemplo: enumerar todas las imágenes**
```
aws imagebuilder list-images
```
**Salida:**
```
{
"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"
},
{
"arn": "arn:aws:imagebuilder:us-west-2:123456789012:image/image-recipe-macos/1.1.1",
"name": "image-recipe-macos",
"type": "AMI",
"version": "1.1.1",
"platform": "macOS",
"owner": "123456789012",
"dateCreated": "2022-04-28T01:38:23.286Z"
}
]
}
```
Al ejecutar el comando **list-images**, puede aplicar filtros para agilizar los resultados, como se muestra en el siguiente ejemplo. Para obtener más información sobre cómo filtrar los resultados, consulte el comando [list-images](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-images.html) en la *referencia de comandos de la AWS CLI *.
**Ejemplo: filtro para imágenes de Linux**
```
aws imagebuilder list-images --filters name="{{platform}}",values="{{Linux}}"
```
**Salida:**
```
{
"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"
}
]
}
```
## Enumeración de imágenes en espera de acción
Cuando se utiliza la acción de paso `WaitForAction` en el flujo de trabajo de imágenes, se pausa el flujo de trabajo hasta que le envíe una señal para reanudar el procesamiento o se produzca un error en el flujo de trabajo. Puede utilizar esta acción de paso si tiene un proceso externo que debe ejecutarse antes de continuar. A continuación, puede utilizar `SendWorkflowStepAction` para enviar una señal al paso en pausa para `RESUME` o `STOP`. También puede detener o reanudar el flujo de trabajo desde la consola.
En las siguientes pestañas se muestra cómo obtener una lista de todos los recursos de imagen de su cuenta con los pasos del flujo de trabajo que actualmente están en pausa en espera de una señal para reanudarse o detenerse. Las pestañas muestran los pasos de la consola y el AWS CLI comando.
También puede utilizar la API o un SDK para obtener una lista de los pasos del flujo de trabajo que están pendientes de acción. Para ver la acción de la API, consulte [ListWaitingWorkflowSteps](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html)la *Referencia de la API de EC2 Image Builder*. Para la solicitud de SDK asociada, consulte el enlace [Véase también](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListWaitingWorkflowSteps.html#API_ListWaitingWorkflowSteps_SeeAlso) en la misma página.
------
#### [ Console ]
Para acceder a la pestaña **Esperando acción** de la consola, siga estos pasos:
1. Abra la consola EC2 de Image Builder en [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Elija **Imágenes** en el panel de navegación. Se abrirá la página de lista **Imágenes**.
1. Seleccione la pestaña **Esperando acción** en la página de lista.
1. (Opcional) Para detener o reanudar un paso, active la casilla situada junto al nombre y, a continuación, elija **Detener paso** o **Reanudar paso**. Puede seleccionar más de una casilla para realizar la misma acción en todos los pasos seleccionados.
**Detalles de los pasos pendientes del flujo de trabajo**
Los detalles del flujo de trabajo del paso pendiente incluyen lo siguiente:
+ **Nombre de la imagen**: nombre del recurso de imagen que tiene el paso pendiente. Puede seleccionar el enlace del nombre para mostrar la página de detalles de esa imagen.
+ **Nombre del paso pendiente**: nombre del paso del flujo de trabajo que está esperando la acción.
+ **ID de ejecución del paso**: identifica de forma exclusiva la instancia de tiempo de ejecución del paso del flujo de trabajo. Puede seleccionar el ID vinculado para mostrar los detalles del tiempo de ejecución del paso.
+ **Inicio del paso**: marca de tiempo del inicio de la instancia de tiempo de ejecución del paso en el flujo de trabajo.
+ **ARN de flujo de trabajo**: nombre de recurso de Amazon (ARN) del flujo de trabajo con el paso pendiente.
+ **Acciones**: acción del paso que está en estado de espera.
------
#### [ AWS CLI ]
Cuando ejecutes el **[list-waiting-workflow-steps](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-waiting-workflow-steps.html)** comando en AWS CLI, obtendrás una lista de todas las imágenes de tu cuenta que incluyen pasos de flujo de trabajo que están pendientes de acción antes de completar el proceso de creación de la imagen.
En el siguiente ejemplo de comando, se muestra cómo utilizar el comando **list-waiting-workflow-steps** para enumerar todas las imágenes de su cuenta con pasos del flujo de trabajo que están en espera de una acción.
**Ejemplo: enumeración de imágenes de la cuenta con los pasos del flujo de trabajo en espera**
```
aws imagebuilder list-waiting-workflow-steps
```
**Salida:**
En la salida de este ejemplo se muestra una imagen de la cuenta con un paso en espera de una acción.
```
{
"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"
}
]
}
```
------
## Enumeración de las versiones de compilación de imágenes
En la página **Versiones de compilación de imágenes** de la consola de Generador de Imágenes, puede ver una lista de versiones de compilación y detalles adicionales de un recurso de imagen de su propiedad. También puede usar comandos o acciones con la API Image Builder o AWS CLI para enumerar las versiones de creación de imágenes. SDKs
Puede usar uno de los siguientes métodos para enumerar las versiones de compilación de imágenes para los recursos de imágenes de su propiedad. Para ver la acción de la API, consulte [ListImageBuildVersions](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html)la *Referencia de la API de EC2 Image Builder*. Para la solicitud de SDK asociada, consulte el enlace [Véase también](https://docs.aws.amazon.com/imagebuilder/latest/APIReference/API_ListImageBuildVersions.html#API_ListImageBuildVersions_SeeAlso) en la misma página.
------
#### [ Console ]
**Detalles de la versión**
Los detalles de la página **Versiones de compilación de imágenes** en la consola de Generador de Imágenes incluyen lo siguiente:
+ **versión**: la versión de compilación del recurso de imagen. En la consola de Generador de Imágenes, la versión se enlaza con una página de detalles de la imagen.
+ **Tipo**: el tipo de salida que Generador de Imágenes distribuyó al crear este recurso de imagen (una AMI o una imagen de contenedor).
+ **Fecha de creación**: fecha y hora en que Generador de Imágenes creó la versión de compilación de imágenes.
+ **Estado de la imagen**: el estado actual de la versión de compilación de la imagen. El estado puede estar relacionado con la compilación o disposición de la imagen. Por ejemplo, durante el proceso de compilación, es posible que vea un estado `Building` o `Distributing`. Para la disposición de la imagen, es posible que vea un estado `Deprecated` o `Deleted`.
+ **Motivo del error**: el motivo del estado de la imagen. La consola de Generador de Imágenes solo muestra el motivo por el que se produce un error en la compilación (“**Image status** equals `Failed`“).
+ **Resultados de seguridad**: los resultados agregados del escaneo de imágenes para la versión de compilación de imágenes a la que se hace referencia.
+ **ARN**: el nombre de recurso de Amazon (ARN) de la versión a la que se hace referencia del recurso de imagen.
+ **Flujo de registro**: enlace a los detalles del flujo de registro de la versión de compilación de la imagen a la que se hace referencia.
**Enumeración de versiones**
Para enumerar las versiones de compilación de imágenes en la consola de Generador de Imágenes, lleve a cabo los siguientes pasos:
1. Abra la consola EC2 de Image Builder en [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/).
1. Elija **Imágenes** en el panel de navegación. De forma predeterminada, la lista de imágenes muestra la versión actual de cada una de las imágenes que posee.
1. Para ver una lista de todas las versiones de una imagen, seleccione el enlace de la versión actual. El enlace abre la página **Versiones de compilación de imágenes**, que muestra todas las versiones de compilación de una imagen específica.
------
#### [ AWS CLI ]
Al ejecutar el **[list-image-build-versions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/list-image-build-versions.html)** comando en AWS CLI, obtendrá una lista completa de las versiones de compilación del recurso de imagen especificado. Debe ser el propietario de la imagen para ejecutar este comando.
El siguiente ejemplo de comando muestra cómo usar el comando **list-image-build-versions** para enumerar todas las versiones de compilación de la imagen especificada.
**Ejemplo: enumerar las versiones de compilación de una imagen específica**.
```
aws imagebuilder list-image-build-versions --image-version-arn arn:aws:imagebuilder:{{us-west-2}}:{{123456789012}}:image/{{image-recipe-name}}/{{1.0.0}}
```
**Salida:**
El resultado de este ejemplo incluye dos versiones de compilación para la receta de imagen especificada.
```
{
"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": {}
}
]
}
```
**nota**
El resultado del comando **list-image-build-versions** no incluye los resultados de seguridad ni los flujos de registro en este momento.
------