• 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:createImage`: cria uma imagem de máquina da Amazon
<a name="automation-action-create"></a>

Cria uma Amazon Machine Image (AMI) de uma instância que está em execução, parando ou parada e solicita que `ImageState` seja `available`.

**nota**  
A ação `aws:createImage` 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 aos seguintes parâmetros de `CreateImage`: Para obter mais informações, consulte [CreateImage](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateImage.html).

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

```
name: createMyImage
action: aws:createImage
maxAttempts: 3
onFailure: Abort
inputs:
  InstanceId: i-1234567890abcdef0
  ImageName: AMI Created on{{global:DATE_TIME}}
  NoReboot: true
  ImageDescription: My newly created AMI
```

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

```
{
    "name": "createMyImage",
    "action": "aws:createImage",
    "maxAttempts": 3,
    "onFailure": "Abort",
    "inputs": {
        "InstanceId": "i-1234567890abcdef0",
        "ImageName": "AMI Created on{{global:DATE_TIME}}",
        "NoReboot": true,
        "ImageDescription": "My newly created AMI"
    }
}
```

------

InstanceId  
O ID da instância.  
Tipo: String  
Exigido: sim

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

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

NoReboot  
Um literal booleana.  
Por padrão, o Amazon Elastic Compute Cloud (Amazon EC2) tenta desligar e reinicializar a instância antes de criar a imagem. Se a opção **No Reboot** (Não reinicializar) estiver definida como `true`, o Amazon EC2 não desligará a instância antes de criar a imagem. Quando esta opção é usada, não é possível garantir a integridade do sistema de arquivos na imagem criada.   
Se você não quiser executar a instância depois de criar uma AMI nela, primeiro use a ação [`aws:changeInstanceState`: altera ou declara o estado da instância](automation-action-changestate.md) para interromper a instância e, depois, use a ação `aws:createImage` com a opção **NoReboot** (Não inicializar) definida como `true`.  
Tipo: booliano  
Obrigatório: não

BlockDeviceMappings  
Os dispositivos de bloco para a instância.  
Tipo: mapa  
Obrigatório: nãoOutput

ImageId  
O ID da imagem recém-criada.  
Tipo: string

ImageState  
O estado atual da imagem. Se o estado estiver disponível, a imagem será registrada com êxito e poderá ser usada para executar uma instância.  
Tipo: string