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