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.
# Utilice capacidades de distribución de AMI mejoradas
Image Builder ofrece funciones de distribución avanzadas que le proporcionan flexibilidad y control sobre la forma en AMIs que se distribuyen entre regiones y cuentas. Estas capacidades separan la distribución del proceso de creación, lo que le permite distribuir las imágenes existentes a pedido, recuperarse de los errores de distribución de manera eficiente e implementar estrategias de distribución controladas y en varias etapas mediante flujos de trabajo personalizables.
Puede utilizar las funciones de distribución de AMI mejoradas de Image Builder para realizar directamente las actividades de distribución sin necesidad de volver a ejecutar una creación de imagen completa.
## Distribución desacoplada
La DistributeImage API acepta tres tipos de referencias a imágenes de origen:
+ **ID de AMI**: un identificador de AMI estándar (por ejemplo,`ami-0abcdef1234567890`)
+ Parámetro **SSM: parámetro** SSM que almacena un ID de AMI (por ejemplo,) `ssm:/my/ami/parameter`
+ **Image Builder versión ARN**: versión de imagen ARN de Image Builder
## Reintento de distribución
Si se produce un error en la distribución de una imagen, utilice la `RetryImage` API para volver a intentarlo. Esto reduce el tiempo necesario para solucionar la causa del error al evitar una reconstrucción completa de la imagen. Úselo `RetryImage` después de resolver la causa subyacente del error de distribución.
La RetryImage API acepta un ARN de la versión de compilación de imágenes (por ejemplo,`arn:aws:imagebuilder:us-west-2:123456789012:image/my-image/1.0.0/1`). Al invocar la API, Image Builder reanuda automáticamente el proceso de distribución desde el punto del error utilizando la configuración y los ajustes de distribución originales. La `RetryImage` API puede volver a intentar las distribuciones que fallaron durante la fase de distribución, la fase de prueba o la fase de integración. Funciona AMIs en los siguientes estados: pendiente, fallido, eliminado o disponible.
**Requisitos previos**
Antes de volver a intentar una distribución, asegúrese de lo siguiente:
+ Ha identificado y resuelto la causa raíz del error. Revise los registros de distribución en CloudWatch Logs para ver los detalles del error.
+ Dispone de los permisos de IAM necesarios para volver a intentar crear la imagen.
+ En caso de errores en la distribución entre cuentas, compruebe que `EC2ImageBuilderDistributionCrossAccountRole` la cuenta de destino tenga la `Ec2ImageBuilderCrossAccountDistributionAccess` política adjunta.
**Importante:** si vuelve a intentarlo sin solucionar el problema subyacente, se producirán errores repetidos.
## flujos de trabajo de distribución
Los flujos de trabajo de distribución son un nuevo tipo de flujo de trabajo que complementa los flujos de trabajo de creación y prueba, lo que permite definir y controlar el proceso de distribución con pasos secuenciales. Con los flujos de trabajo de distribución, puede crear procesos de distribución personalizados que incluyan operaciones de copia de la AMI, wait-for-action puntos de control, modificaciones de atributos de imagen y otros pasos relacionados con la distribución. Esto proporciona un control estructurado sobre la forma en AMIs que se distribuye, con visibilidad escalonada, capacidades de distribución paralela e informes de errores detallados.
Para obtener más información sobre cómo crear y personalizar flujos de trabajo, consulte [Administrar flujos de trabajo de imágenes](manage-image-workflows.html).