Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Modifier le balisage d'une image dans Amazon ECR
<a name="image-retag"></a>

Avec les images Docker Image Manifest V2 Schéma 2, vous pouvez utiliser l'option `--image-tag` de la commande **put-image** pour réétiqueter une image existante. Vous pouvez réétiqueter une image sans la transmettre ni l'extraire avec Docker. Pour les images plus grandes, ce processus permet d'économiser une grande quantité de bande passante réseau et de temps nécessaires au réétiquetage d'une image.

## Réétiqueter une image (AWS CLI)
<a name="retag-aws-cli"></a>

**Pour réétiqueter une image à l'aide du AWS CLI**

1. Utilisez la commande **batch-get-image** pour obtenir le manifeste d'image pour l'image à réétiqueter et l'écrire dans un fichier. Dans cet exemple, le manifeste d'une image avec la balise*latest*, dans le référentiel*amazonlinux*, est écrit dans une variable d'environnement nommée*MANIFEST*.

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

1. Utilisez l'option `--image-tag` de la commande **put-image** afin de placer le manifeste de l'image dans Amazon ECR avec une nouvelle étiquette. Dans cet exemple, l'image est étiquetée comme*2017.03*.
**Note**  
Si l'`--image-tag`option n'est pas disponible dans votre version du AWS CLI, passez à la dernière version. Pour en savoir plus, consultez [Installer la AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) dans le *guide de l'utilisateur AWS Command Line Interface *.

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

1. Vérifiez que la nouvelle étiquette de l'image est attachée à l'image. Dans la sortie ci-dessous, l'image porte les étiquettes `latest` et ` 2017.03`.

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

   La sortie est la suivante :

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

## Réétiqueter une image (AWS Tools for Windows PowerShell)
<a name="retag-powershell"></a>

**Pour réétiqueter une image à l'aide du AWS Tools for Windows PowerShell**

1. Utilisez le **Get-ECRImageBatch** **cmdlet** pour obtenir la description de l'image à rebaliser et l'écrire dans une variable d'environnement. Dans cet exemple, une image avec la balise* latest*, dans le référentiel*amazonlinux*, est écrite dans la variable d'environnement,*\$1Image*.
**Note**  
Si ce n'est pas le cas **Get-ECRImageBatch** ** cmdlet** sur votre système, reportez-vous à la section [Configuration du AWS Tools for Windows PowerShell dans le](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) *guide de Outils AWS pour PowerShell l'utilisateur*.

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

1. Écrivez le manifeste de l'image dans la variable d'*\$1Manifest*environnement.

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

1. Utilisez l'`-ImageTag`option **Write-ECRImage** ** cmdlet** pour placer le manifeste de l'image sur Amazon ECR avec une nouvelle balise. Dans cet exemple, l'image est étiquetée comme*2017.09*.

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

1. Vérifiez que la nouvelle étiquette de l'image est attachée à l'image. Dans la sortie ci-dessous, l'image porte les étiquettes `latest` et ` 2017.09`.

   ```
   Get-ECRImage -RepositoryName amazonlinux
   ```

   La sortie est la suivante :

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