As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Remarcação de uma imagem no Amazon ECR
<a name="image-retag"></a>

Com as imagens do esquema 2 do manifesto de imagem do Docker V2, você pode usar a opção `--image-tag` do comando **put-image** para remarcar uma imagem existente. Você pode remarcar sem extrair ou enviar a imagem com Docker. Para imagens maiores, esse processo economiza uma quantidade considerável de largura de banda e de tempo necessário para remarcar uma imagem.

## Como remarcar uma imagem (AWS CLI)
<a name="retag-aws-cli"></a>

**Para remarcar uma imagem com a AWS CLI**

1. Use o comando **batch-get-image** para obter o manifesto da imagem para remarcá-la e gravá-la em um arquivo. Neste exemplo, o manifesto de uma imagem com a tag,*latest*, no repositório,*amazonlinux*, é gravado em uma variável de ambiente chamada*MANIFEST*.

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

1. Use a opção `--image-tag` do comando **put-image** para colocar o manifesto da imagem no Amazon ECR com uma nova tag. Neste exemplo, a imagem é marcada como*2017.03*.
**nota**  
Se a `--image-tag` opção não estiver disponível na sua versão do AWS CLI, atualize para a versão mais recente. Para obter mais informações, consulte [Instalar a AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) no *Guia do usuário da AWS Command Line Interface *.

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

1. Verifique se a sua nova tag de imagem está conectada à imagem. Na saída a seguir, a imagem têm as tags `latest` e ` 2017.03`.

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

   A saída é a seguinte:

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

## Como remarcar uma imagem (AWS Tools for Windows PowerShell)
<a name="retag-powershell"></a>

**Para remarcar uma imagem com a AWS Tools for Windows PowerShell**

1. Use o **cmdlet** de **Get-ECRImageBatch** para obter a descrição da imagem para remarcá-la e gravá-la em uma variável de ambiente. Neste exemplo, uma imagem com a tag,* latest*, no repositório,*amazonlinux*, é gravada na variável de ambiente,*\$1Image*.
**nota**  
Se você não tiver o ** cmdlet** de **Get-ECRImageBatch** disponível no sistema, consulte [Configuração do AWS Tools for Windows PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) no *Ferramentas da AWS para PowerShell Manual do usuário*.

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

1. Grave o manifesto da imagem na variável de *\$1Manifest* ambiente.

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

1. Use a opção `-ImageTag` do ** cmdlet** de **Write-ECRImage** para colocar o manifesto da imagem no Amazon ECR com uma nova tag. Neste exemplo, a imagem é marcada como*2017.09*.

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

1. Verifique se a sua nova tag de imagem está conectada à imagem. Na saída a seguir, a imagem têm as tags `latest` e ` 2017.09`.

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

   A saída é a seguinte:

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