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.

# Ein Bild in Amazon ECR neu taggen
<a name="image-retag"></a>

Bei Docker Image Manifest V2 Schema 2-Images können Sie mit der Option `--image-tag` des Befehls **put-image** ein vorhandenes Image erneut markieren. Eine erneute Markierung ist möglich, ohne das Image per Push oder Pull mit Docker zu übertragen. Bei umfangreichen Images lassen sich so die benötigte Netzwerkbandbreite und der Zeitaufwand, der zum erneuten Markieren eines Image nötig ist, ganz erheblich reduzieren.

## So markieren Sie ein Image neu (AWS CLI)
<a name="retag-aws-cli"></a>

**Um ein Bild erneut zu taggen mit dem AWS CLI**

1. Verwenden Sie den **batch-get-image**-Befehl, um das Image-Manifest für das Image abzurufen, um es neu zu markieren und in eine Datei zu schreiben. In diesem Beispiel wird das Manifest für ein Bild mit dem Tag,{{latest}}, im Repository,{{amazonlinux}}, in eine Umgebungsvariable mit dem Namen {{MANIFEST}} geschrieben.

   ```
   MANIFEST=$(aws ecr batch-get-image --repository-name {{amazonlinux}} --image-ids imageTag={{latest}} --output text --query 'images[].imageManifest')
   ```

1. Verwenden Sie die Option `--image-tag` des Befehls **put-image**, um das Image-Manifest in Amazon ECR mit einem neuen Tag zu versehen. In diesem Beispiel ist das Bild als gekennzeichnet{{2017.03}}.
**Anmerkung**  
Wenn die `--image-tag` Option in Ihrer Version von nicht verfügbar ist AWS CLI, führen Sie ein Upgrade auf die neueste Version durch. Weitere Informationen finden Sie unter [Installieren der AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) im *AWS Command Line Interface -Benutzerhandbuch*.

   ```
   aws ecr put-image --repository-name {{amazonlinux}} --image-tag {{2017.03}} --image-manifest "$MANIFEST"
   ```

1. Vergewissern Sie sich, dass Ihr neues Image-Tag mit Ihrem Image verbunden ist. In der nachfolgenden Ausgabe hat das Image die Tags `latest` und ` 2017.03`.

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

   Die Ausgabe sieht wie folgt aus:

   ```
   {
       "imageDetails": [
           {
               "imageSizeInBytes": 98755613,
               "imageDigest": "sha256:8d00af8f076eb15a33019c2a3e7f1f655375681c4e5be157a26EXAMPLE",
               "imageTags": [
                   "latest",
                   "2017.03"
               ],
               "registryId": "{{aws_account_id}}",
               "repositoryName": "amazonlinux",
               "imagePushedAt": 1499287667.0
           }
       ]
   }
   ```

## So markieren Sie ein Image neu (AWS Tools for Windows PowerShell)
<a name="retag-powershell"></a>

**Um ein Bild erneut zu taggen mit dem AWS Tools for Windows PowerShell**

1. Verwenden Sie die **Get-ECRImageBatch****cmdlet**, um die Beschreibung des Bilds abzurufen, um es erneut zu taggen und in eine Umgebungsvariable zu schreiben. In diesem Beispiel wird ein Bild mit dem Tag,{{ latest}}, im Repository,{{amazonlinux}}, in die Umgebungsvariable, {{$Image}} geschrieben.
**Anmerkung**  
Falls das nicht auf Ihrem System **Get-ECRImageBatch** ** cmdlet** verfügbar ist, finden Sie [weitere Informationen unter Einrichten von AWS Tools for Windows PowerShell im AWS -Tools für PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) *Benutzerhandbuch*.

   ```
   $Image = Get-ECRImageBatch -ImageId @{ imageTag="{{latest}}" } -RepositoryName {{amazonlinux}}
   ```

1. Schreiben Sie das Manifest des Images in die {{$Manifest}} Umgebungsvariable.

   ```
   $Manifest = $Image.Images[0].ImageManifest
   ```

1. Verwenden Sie die `-ImageTag` Option von **Write-ECRImage**** cmdlet**, um das Image-Manifest mit einem neuen Tag in Amazon ECR zu speichern. In diesem Beispiel ist das Bild gekennzeichnet als{{2017.09}}.

   ```
   Write-ECRImage -RepositoryName {{amazonlinux}} -ImageManifest $Manifest -ImageTag {{2017.09}}
   ```

1. Vergewissern Sie sich, dass Ihr neues Image-Tag mit Ihrem Image verbunden ist. In der nachfolgenden Ausgabe hat das Image die Tags `latest` und ` 2017.09`.

   ```
   Get-ECRImage -RepositoryName {{amazonlinux}}
   ```

   Die Ausgabe sieht wie folgt aus:

   ```
   ImageDigest                                                             ImageTag
   -----------                                                             --------
   sha256:359b948ea8866817e94765822787cd482279eed0c17bc674a7707f4256d5d497 latest
   sha256:359b948ea8866817e94765822787cd482279eed0c17bc674a7707f4256d5d497 2017.09
   ```