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.

# Extracción de una imagen a su entorno local desde un repositorio privado de Amazon ECR
<a name="docker-pull-ecr-image"></a>

Si desea ejecutar una imagen de Docker que está disponible en Amazon ECR, puede extraerla a su entorno local con el comando **docker pull**. Puedes hacerlo desde tu registro predeterminado o desde un registro asociado a otra AWS cuenta. 

Para utilizar una imagen de Amazon ECR en una definición de tarea de Amazon ECS, consulte [Uso de imágenes de Amazon ECR con Amazon ECS](ECR_on_ECS.md). 

**importante**  
No puede extraer una imagen archivada. Las imágenes archivadas deben restaurarse antes de poder extraerlas. Para obtener más información sobre el archivado y la restauración de imágenes, consulte. [Archivar una imagen en Amazon ECR](archive_restore_image.md)

**importante**  
Amazon ECR requiere que los usuarios tengan permiso para realizar llamadas a la API `ecr:GetAuthorizationToken` a través de una política de IAM para que puedan autenticarse en un registro, así como insertar o extraer imágenes de cualquier repositorio de Amazon ECR. Amazon ECR proporciona varias políticas AWS administradas para controlar el acceso de los usuarios en distintos niveles. Para obtener información sobre las políticas AWS gestionadas de Amazon ECR, consulte[AWS políticas gestionadas para Amazon Elastic Container Registry](security-iam-awsmanpol.md).

**Extracción de una imagen de Docker de un repositorio de Amazon ECR**

1. Autentique su cliente de Docker en el registro de Amazon ECR del que va a extraer la imagen. Debe obtener tokens de autenticación para cada registro usado, cuya validez es de 12 horas. Para obtener más información, consulte [Autenticación de registro privado en Amazon ECR](registry_auth.md).

1. (Opcional) Identifique la imagen que va a extraer.
   + Puede mostrar los repositorios de un registro con el comando: **aws ecr describe-repositories**.

     ```
     aws ecr describe-repositories
     ```

     El registro de ejemplo anterior tiene un repositorio llamado`amazonlinux`.
   + Puede describir las imágenes de un repositorio con el comando: **aws ecr describe-images**.

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

     El repositorio de ejemplo anterior tiene una imagen etiquetada como `latest` y `2016.09`, con el resumen de imagen ` sha256:f1d4ae3f7261a72e98c6ebefe9985cf10a0ea5bd762585a43e0700ed99863807`.

1. Extraiga la imagen con el comando **docker pull**. El formato del nombre de imagen debe ser `registry/repository [:tag]` para extraer la imagen por etiqueta o `registry /repository[@digest]` para extraerla por resumen.

   ```
   docker pull aws_account_id.dkr.ecr.us-west-2.amazonaws.com/amazonlinux:latest
   ```
**importante**  
Si aparece un error `repository-url not found: does not exist or no pull access`, es posible que tenga que autenticar su cliente de Docker con Amazon ECR. Para obtener más información, consulte [Autenticación de registro privado en Amazon ECR](registry_auth.md).