Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Usa funzionalità di distribuzione AMI avanzate
<a name="distribution-enhanced_functionality"></a>

Image Builder offre funzionalità di distribuzione avanzate che offrono flessibilità e controllo sulla modalità di distribuzione tra regioni e account. AMIs Queste funzionalità separano la distribuzione dal processo di creazione, consentendo di distribuire le immagini esistenti su richiesta, ripristinare in modo efficiente gli errori di distribuzione e implementare strategie di distribuzione controllate e in più fasi attraverso flussi di lavoro personalizzabili. 

È possibile utilizzare le funzionalità di distribuzione AMI avanzate in Image Builder per eseguire direttamente le attività di distribuzione senza la necessità di eseguire nuovamente una build di immagine completa. 

## Distribuzione disaccoppiata
<a name="decoupled-distribution"></a>

L' DistributeImage API accetta tre tipi di riferimenti alle immagini di origine: 
+ **ID AMI**: un identificatore AMI standard (ad esempio,`ami-0abcdef1234567890`)
+ **Parametro SSM**: un parametro SSM che memorizza un ID AMI (ad esempio,) `ssm:/my/ami/parameter`
+ **Image Builder versione ARN — Una versione di immagine di Image Builder ARN**

## Riprova di distribuzione
<a name="distribution-retry"></a>

Se la distribuzione di un'immagine fallisce, utilizza l'`RetryImage`API per riprovare la distribuzione. In questo modo si riduce il tempo necessario per risolvere la causa dell'errore evitando una ricostruzione completa dell'immagine. Utilizzare `RetryImage` dopo aver risolto la causa alla base dell'errore di distribuzione. 

L' RetryImage API accetta una versione di build dell'immagine ARN (ad esempio,`arn:aws:imagebuilder:us-west-2:123456789012:image/my-image/1.0.0/1`). Quando si richiama l'API, Image Builder riprende automaticamente il processo di distribuzione dal punto di errore utilizzando la configurazione e le impostazioni di distribuzione originali. L'`RetryImage`API può riprovare le distribuzioni che hanno avuto esito negativo durante la fase di distribuzione, la fase di test o la fase di integrazione. Funziona AMIs nei seguenti stati: in sospeso, non riuscito, eliminato o disponibile. 

**Prerequisiti** 

Prima di riprovare una distribuzione, assicurati quanto segue: 
+ Avete identificato e risolto la causa principale dell'errore. Consulta i log di distribuzione in CloudWatch Logs per i dettagli sugli errori.
+ Disponi delle autorizzazioni IAM necessarie per riprovare a creare l'immagine.
+ In caso di errori di distribuzione tra account diversi, verifica che `EC2ImageBuilderDistributionCrossAccountRole` all'account di destinazione sia associata la policy. `Ec2ImageBuilderCrossAccountDistributionAccess`

**Importante:** se riprovi senza risolvere il problema sottostante, si verificheranno errori ripetuti. 

## Flussi di lavoro di distribuzione
<a name="distribution-workflows"></a>

I flussi di lavoro di distribuzione sono un nuovo tipo di flusso di lavoro che integra i flussi di lavoro di compilazione e test e consente di definire e controllare il processo di distribuzione con passaggi sequenziali. Con i flussi di lavoro di distribuzione, puoi creare processi di distribuzione personalizzati che includono operazioni di copia AMI, wait-for-action checkpoint, modifiche degli attributi dell'immagine e altri passaggi relativi alla distribuzione. Ciò fornisce un controllo strutturato sulla modalità di distribuzione, con visibilità a livello di fase, funzionalità di distribuzione parallela e segnalazione granulare degli errori. AMIs 

[Per ulteriori informazioni sulla creazione e la personalizzazione dei flussi di lavoro, consulta Manage Image Workflows.](manage-image-workflows.html)