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.

# Reetiquetación de una imagen en Amazon ECR
<a name="image-retag"></a>

Con las imágenes de Docker Image Manifest V2 Schema 2 puede usar la opción `--image-tag` del comando **put-image** para volver a etiquetar una imagen existente. Puede volver a etiquetar sin extraer o insertar la imagen con Docker. Para imágenes grandes, este proceso ahorra una cantidad considerable de ancho de banda de la red y del tiempo necesario para volver a etiquetar una imagen.

## Para volver a etiquetar una imagen (AWS CLI)
<a name="retag-aws-cli"></a>

**Para volver a etiquetar una imagen con AWS CLI**

1. Utilice el comando **batch-get-image** para obtener el manifiesto de la imagen para volver a etiquetarla y escribirla en un archivo. En este ejemplo, el manifiesto de una imagen con la etiqueta,*latest*, en el repositorio*amazonlinux*, se escribe en una variable de entorno denominada*MANIFEST*.

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

1. Use la opción `--image-tag` del comando **put-image** para colocar el manifiesto de imagen en Amazon ECR con una nueva etiqueta. En este ejemplo, la imagen está etiquetada como*2017.03*.
**nota**  
Si la `--image-tag` opción no está disponible en su versión AWS CLI, actualice a la versión más reciente. Para obtener más información, consulte [Installing the AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) en la *Guía del usuario de AWS Command Line Interface *.

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

1. Verifique que la nueva etiqueta de imagen está asociada a la imagen. En la salida siguiente, la imagen tiene las etiquetas `latest` y ` 2017.03`.

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

   La salida es la siguiente:

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

## Para volver a etiquetar una imagen (AWS Tools for Windows PowerShell)
<a name="retag-powershell"></a>

**Para volver a etiquetar una imagen con el AWS Tools for Windows PowerShell**

1. Use el **cmdlet** **Get-ECRImageBatch** para obtener la descripción de la imagen para volver a etiquetarla y escribirla en una variable de entorno. En este ejemplo, una imagen con la etiqueta,* latest*, en el repositorio,*amazonlinux*, se escribe en la variable de entorno,*\$1Image*.
**nota**  
Si el ** cmdlet** **Get-ECRImageBatch** no está disponible en su sistema, consulte la [Configuración de AWS Tools for Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) en la *Guía del usuario de Herramientas de AWS para PowerShell *.

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

1. Escribe el manifiesto de la imagen en la variable de *\$1Manifest* entorno.

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

1. Use la opción `-ImageTag` del ** cmdlet** **Write-ECRImage** para colocar el manifiesto de imagen en Amazon ECR con una nueva etiqueta. En este ejemplo, la imagen está etiquetada como*2017.09*.

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

1. Verifique que la nueva etiqueta de imagen está asociada a la imagen. En la salida siguiente, la imagen tiene las etiquetas `latest` y ` 2017.09`.

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

   La salida es la siguiente:

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