• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

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à.

# `aws:copyImage`: copia o crittografa un'Amazon Machine Image
<a name="automation-action-copyimage"></a>

Copia un Amazon Machine Image (AMI) da qualsiasi Regione AWS nella regione corrente. Questa operazione consente inoltre di crittografare la nuova AMI.

**Nota**  
L'azione `aws:copyImage` supporta un nuovo tentativo di limitazione (della larghezza di banda della rete) automatico. Per ulteriori informazioni, consulta [Configurazione della ripetizione dei tentativi automatica per le operazioni di limitazione (della larghezza di banda della rete)](automation-throttling-retry.md).

**Input**  
Questa operazione supporta la maggior parte dei parametri `CopyImage`. Per ulteriori informazioni, consulta [CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CopyImage.html).

L'esempio seguente crea una copia di un'AMI nella regione di Seoul (`SourceImageID`: ami-0fe10819. `SourceRegion`: ap-northeast-2). La nuova AMI viene copiata nella regione in cui è stata avviata l'operazione di automazione. L'AMI copiata verrà crittografata perché il flag `Encrypted` facoltativo è impostato su `true`.

------
#### [ YAML ]

```
name: createEncryptedCopy
action: aws:copyImage
maxAttempts: 3
onFailure: Abort
inputs:
  SourceImageId: ami-0fe10819
  SourceRegion: ap-northeast-2
  ImageName: Encrypted Copy of LAMP base AMI in ap-northeast-2
  Encrypted: true
```

------
#### [ JSON ]

```
{   
    "name": "createEncryptedCopy",
    "action": "aws:copyImage",
    "maxAttempts": 3,
    "onFailure": "Abort",
    "inputs": {
        "SourceImageId": "ami-0fe10819",
        "SourceRegion": "ap-northeast-2",
        "ImageName": "Encrypted Copy of LAMP base AMI in ap-northeast-2",
        "Encrypted": true
    }   
}
```

------

SourceRegion  
Regione in cui esiste l'AMI di origine.  
Tipo: stringa  
Obbligatorio: sì

SourceImageId  
ID dell'AMI da copiare dalla regione di origine.  
Tipo: stringa  
Obbligatorio: sì

ImageName  
Nome della nuova immagine.  
Tipo: stringa  
Obbligatorio: sì

ImageDescription  
Descrizione dell'immagine di destinazione.  
▬Tipo: stringa  
Obbligatorio: no

Crittografato  
Crittografa l'AMI di destinazione.  
Tipo: Booleano  
Obbligatorio: no

KmsKeyId  
L'Amazon Resource Name (ARN) completo AWS KMS key da utilizzare per crittografare le istantanee di un'immagine durante un'operazione di copia. Per ulteriori informazioni, consulta [CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/api_copyimage.html).  
▬Tipo: stringa  
Obbligatorio: no

ClientToken  
Identificatore univoco con distinzione tra maiuscole e minuscole che fornisci per assicurare l'idempotenza della richiesta. Per ulteriori informazioni, consulta [CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/api_copyimage.html).  
▬Tipo: stringa  
Obbligatorio: noOutput

ImageId  
ID dell'immagine copiata.

ImageState  
Stato dell'immagine copiata.  
Valori validi: `available` \$1 `pending` \$1 `failed`