• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# `aws:copyImage` – copia ou criptografa um Amazon Machine Image
<a name="automation-action-copyimage"></a>

Copia uma Amazon Machine Image (AMI) de qualquer Região da AWS para a região atual. Essa ação também pode criptografar a nova AMI.

**nota**  
A ação `aws:copyImage` suporta uma nova tentativa automática de controle de utilização. Para obter mais informações, consulte [Configurar a repetição automática para operações com controle de utilização](automation-throttling-retry.md).

**Input**  
Essa ação oferece suporte para a maioria dos parâmetros `CopyImage`. Para obter mais informações, consulte [CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CopyImage.html).

O exemplo a seguir cria uma cópia de uma AMI na região de Seul (`SourceImageID`: ami-0fe10819. `SourceRegion`: ap-northeast-2). A nova AMI é copiada para a região em que você iniciou a ação do Automation. A AMI copiada será criptografada, pois o sinalizador `Encrypted` opcional está definido como `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  
A região em que a AMI de origem existe.  
Tipo: String  
Exigido: sim

SourceImageId  
O ID de AMI a ser copiado da região de origem.  
Tipo: String  
Exigido: sim

ImageName  
O nome da nova imagem.  
Tipo: String  
Exigido: sim

ImageDescription  
Uma descrição da imagem de destino.  
Tipo: string  
Obrigatório: não

Criptografado  
Criptografe a de destino AMI.  
Tipo: booliano  
Obrigatório: não

KmsKeyId  
O nome do recurso da Amazon (ARN) completo da AWS KMS key a ser usado para criptografar os snapshots de uma imagem durante uma operação de cópia. Para obter mais informações, consulte [CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/api_copyimage.html).  
Tipo: string  
Obrigatório: não

ClientToken  
Um identificador único e com diferenciação entre maiúsculas de minúsculas que você fornece para garantir a idempotência da solicitação. Para obter mais informações, consulte [CopyImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/api_copyimage.html).  
Tipo: string  
Obrigatório: nãoOutput

ImageId  
O ID da imagem copiada.

ImageState  
O estado da imagem copiada.  
Valores válidos: `available` \$1 `pending` \$1 `failed`