Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Abrufen eines Images aus einem privaten Amazon ECR-Repository in Ihre lokale Umgebung
<a name="docker-pull-ecr-image"></a>

Wenn Sie ein Docker-Image ausführen möchten, das in Amazon ECR verfügbar ist, können Sie es mit dem Befehl **docker pull** in Ihre lokale Umgebung ziehen. Sie können dies entweder von Ihrer Standardregistrierung oder von einer Registrierung aus tun, die mit einem anderen AWS Konto verknüpft ist. 

Um ein Amazon-ECR-Image in einer Amazon-ECS-Aufgabendefinition zu verwenden, siehe [Verwendung von Amazon ECR-Bildern mit Amazon ECS](ECR_on_ECS.md). 

**Wichtig**  
Sie können ein archiviertes Bild nicht abrufen. Archivierte Bilder müssen wiederhergestellt werden, bevor sie abgerufen werden können. Weitere Informationen zum Archivieren und Wiederherstellen von Bildern finden Sie unter[Archivieren eines Bilds in Amazon ECR](archive_restore_image.md).

**Wichtig**  
Amazon ECR setzt voraus, dass Benutzer über eine IAM-Richtlinie die Erlaubnis haben, die `ecr:GetAuthorizationToken`-API aufzurufen, bevor sie sich bei einer Registrierung authentifizieren und Images aus einem Amazon ECR-Repository pushen oder pullen können. Amazon ECR bietet mehrere AWS verwaltete Richtlinien zur Steuerung des Benutzerzugriffs auf unterschiedlichen Ebenen. Informationen zu den AWS verwalteten Richtlinien für Amazon ECR finden Sie unter[AWS verwaltete Richtlinien für Amazon Elastic Container Registry](security-iam-awsmanpol.md).

**So pullen Sie ein Docker-Image aus einem Amazon ECR-Repository**

1. Authentifizieren Sie Ihren Docker-Client bei der Amazon-ECR-Registrierung, aus der Sie Ihr Image abrufen möchten. Für jede verwendete Registrierung muss ein Autorisierungs-Token erhalten werden, und die Token sind 12 Stunden lang gültig. Weitere Informationen finden Sie unter [Authentifizierung bei privaten Registern in Amazon ECR](registry_auth.md).

1. (Optional) Identifizieren Sie das abzurufende Image.
   + Sie können die Repositorys in einer Registrierung mit dem Befehl **aws ecr describe-repositories** auflisten:

     ```
     aws ecr describe-repositories
     ```

     Die obige Beispielregistrierung hat ein Repository namens`amazonlinux`.
   + Sie können die Images in einem Repository mit dem Befehl **aws ecr describe-images** beschreiben:

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

     Das obige Beispie-Repsotoryl zeigt ein als `latest` und `2016.09` markiertes Image, mit dem Image-Digest ` sha256:f1d4ae3f7261a72e98c6ebefe9985cf10a0ea5bd762585a43e0700ed99863807`.

1. Rufen Sie das Image mit dem Befehl **docker pull** ab. Das Image-Namensformat sollte `registry/repository [:tag]` für den Abruf per Tag, oder `registry /repository[@digest]` für den Abruf per Digest sein.

   ```
   docker pull aws_account_id.dkr.ecr.us-west-2.amazonaws.com/amazonlinux:latest
   ```
**Wichtig**  
Wenn Sie eine Fehlermeldung `repository-url not found: does not exist or no pull access` erhalten, müssen Sie Ihren Docker-Client möglicherweise mit Amazon ECR authentifizieren. Weitere Informationen finden Sie unter [Authentifizierung bei privaten Registern in Amazon ECR](registry_auth.md).