Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Ritaggare un'immagine in Amazon ECR
<a name="image-retag"></a>

Con le immagini Docker Image Manifest V2 Schema 2, puoi usare l'opzione `--image-tag` del comando **put-image** per inserire nuovamente un tag in un'immagine esistente. Puoi inserire nuovamente il tag senza estrarre o inviare l'immagine con Docker. Per le immagini più grandi, questo processo consente di risparmiare una notevole quantità di larghezza di banda di rete e il tempo richiesto per reinserire un tag a un'immagine.

## Per inserire nuovamente un tag in un'immagine (AWS CLI)
<a name="retag-aws-cli"></a>

**Per rietichettare un'immagine con AWS CLI**

1. Utilizza il comando **batch-get-image** per ottenere il manifesto dell'immagine al fine di inserire nuovamente il tag nell'immagine e scriverla su un file. In questo esempio, il manifesto di un'immagine con il tag{{latest}}, nel repository{{amazonlinux}}, viene scritto in una variabile di ambiente denominata. {{MANIFEST}}

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

1. Utilizza l'opzione `--image-tag` del comando **put-image** per inserire il manifesto dell'immagine in Amazon ECR con un nuovo tag. In questo esempio, l'immagine è etichettata come{{2017.03}}.
**Nota**  
Se l'`--image-tag`opzione non è disponibile nella tua versione di AWS CLI, esegui l'aggiornamento alla versione più recente. Per ulteriori informazioni, consulta [Installazione dell’ AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) nella *Guida per l’utente dell’AWS Command Line Interface *.

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

1. Verifica che il nuovo tag dell'immagine sia collegato all'immagine. Nell'output seguente, l'immagine presenta i tag `latest` e ` 2017.03`.

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

   L'output è il seguente:

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

## Per inserire nuovamente un tag in un'immagine (AWS Tools for Windows PowerShell)
<a name="retag-powershell"></a>

**Per rietichettare un'immagine con AWS Tools for Windows PowerShell**

1. Utilizzate il **Get-ECRImageBatch** **cmdlet** per ottenere la descrizione dell'immagine da rietichettare e scriverla in una variabile di ambiente. In questo esempio, un'immagine con il tag,{{ latest}}, nel repository{{amazonlinux}}, viene scritta nella variabile di ambiente,. {{$Image}}
**Nota**  
Se non è **Get-ECRImageBatch** ** cmdlet** disponibile sul sistema, consulta [Configurazione](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) di AWS Tools for Windows PowerShell nella *Guida per l'AWS Strumenti per PowerShell utente*.

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

1. Scrivi il manifesto dell'immagine nella variabile di {{$Manifest}} ambiente.

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

1. Utilizza l'`-ImageTag`opzione di **Write-ECRImage** ** cmdlet** inserire il manifesto dell'immagine in Amazon ECR con un nuovo tag. In questo esempio, l'immagine è etichettata come{{2017.09}}.

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

1. Verifica che il nuovo tag dell'immagine sia collegato all'immagine. Nell'output seguente, l'immagine presenta i tag `latest` e ` 2017.09`.

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

   L'output è il seguente:

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