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à.

# Estrazione di un'immagine nel tuo ambiente locale da un repository privato Amazon ECR
<a name="docker-pull-ecr-image"></a>

Se desideri eseguire un'immagine Docker disponibile in Amazon ECR, puoi estrarla nel tuo ambiente locale con il comando **docker pull**. È possibile eseguire questa operazione dal registro predefinito o da un registro associato a un altro AWS account. 

Per utilizzare un'immagine Amazon ECR in una definizione di attività Amazon ECS, consulta [Utilizzo delle immagini Amazon ECR con Amazon ECS](ECR_on_ECS.md). 

**Importante**  
Non è possibile estrarre un'immagine archiviata. Le immagini archiviate devono essere ripristinate prima di poter essere recuperate. Per ulteriori informazioni sull'archiviazione e il ripristino delle immagini, vedere. [Archiviazione di un'immagine in Amazon ECR](archive_restore_image.md)

**Importante**  
Amazon ECR richiede che gli utenti dispongano dell'autorizzazione per effettuare chiamate all'API `ecr:GetAuthorizationToken` tramite una policy IAM prima che possano autenticarsi in un registro ed eseguire l'invio o l'estrazione delle immagini da un repository Amazon ECR. Amazon ECR fornisce diverse policy AWS gestite per controllare l'accesso degli utenti a vari livelli. Per informazioni sulle politiche AWS gestite per Amazon ECR, consulta[AWS politiche gestite per Amazon Elastic Container Registry](security-iam-awsmanpol.md).

**Per estrarre un'immagine Docker da un repository Amazon ECR**

1. Autentica il tuo client Docker nel registro Amazon ECR dal quale desideri estrarre la tua immagine. Devi ottenere i token di autenticazione per ciascun registro utilizzato. I token hanno una validità di 12 ore. Per ulteriori informazioni, consulta [Autenticazione del registro privato in Amazon ECR](registry_auth.md).

1. (Opzionale) Identifica l'immagine da estrarre.
   + Puoi elencare i repository in un registro con il comando **aws ecr describe-repositories**:

     ```
     aws ecr describe-repositories
     ```

     Il registro di esempio riportato sopra ha un repository chiamato. `amazonlinux`
   + Puoi descrivere le immagini in un repository con il comando **aws ecr describe-images**:

     ```
     aws ecr describe-images --repository-name amazonlinux
     ```

     Il precedente repository di esempio ha un'immagine taggata come `latest` e `2016.09`, con il digest dell'immagine ` sha256:f1d4ae3f7261a72e98c6ebefe9985cf10a0ea5bd762585a43e0700ed99863807`.

1. Estrai l'immagine con il comando **docker pull**. Il formato del nome dell'immagine deve essere `{{registry}}/{{repository}} [:{{tag}}]` per effettuare l'estrazione tramite tag o `{{registry}} /{{repository}}[@{{digest}}]` per effettuare l'estrazione tramite digest.

   ```
   docker pull {{aws_account_id}}.dkr.ecr.{{us-west-2}}.amazonaws.com/amazonlinux:latest
   ```
**Importante**  
Se ricevi un errore `{{repository-url}} not found: does not exist or no pull access`, potrebbe essere necessario autenticare il tuo client Docker con Amazon ECR. Per ulteriori informazioni, consulta [Autenticazione del registro privato in Amazon ECR](registry_auth.md).