• 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:runInstances` – Executa uma instância do Amazon EC2
<a name="automation-action-runinstance"></a>

Inicia uma nova instância do Amazon Elastic Compute Cloud (Amazon EC2).

**nota**  
A ação `aws:runInstances` 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**  
A ação oferece suporte para a maioria dos parâmetros de API. Para obter mais informações, consulte a documentação da API [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html).

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

```
name: launchInstance
action: aws:runInstances
maxAttempts: 3
timeoutSeconds: 1200
onFailure: Abort
inputs:
  ImageId: ami-12345678
  InstanceType: t2.micro
  MinInstanceCount: 1
  MaxInstanceCount: 1
  IamInstanceProfileName: myRunCmdRole
  TagSpecifications:
  - ResourceType: instance
    Tags:
    - Key: LaunchedBy
      Value: SSMAutomation
    - Key: Category
      Value: HighAvailabilityFleetHost
```

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

```
{
   "name":"launchInstance",
   "action":"aws:runInstances",
   "maxAttempts":3,
   "timeoutSeconds":1200,
   "onFailure":"Abort",
   "inputs":{
      "ImageId":"ami-12345678",
      "InstanceType":"t2.micro",
      "MinInstanceCount":1,
      "MaxInstanceCount":1,
      "IamInstanceProfileName":"myRunCmdRole",
      "TagSpecifications":[
         {
            "ResourceType":"instance",
            "Tags":[
               {
                  "Key":"LaunchedBy",
                  "Value":"SSMAutomation"
               },
               {
                  "Key":"Category",
                  "Value":"HighAvailabilityFleetHost"
               }
            ]
         }
      ]
   }
}
```

------

AdditionalInfo  
Reservado.  
Tipo: string  
Obrigatório: não

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

ClientToken  
O identificador para garantir a idempotência da solicitação.  
Tipo: string  
Obrigatório: não

DisableApiTermination  
Ativa ou desativa o encerramento da API da instância.  
Tipo: booliano  
Obrigatório: não

EbsOptimized  
Ativa ou desativa a otimização do Amazon Elastic Block Store (Amazon EBS).  
Tipo: booliano  
Obrigatório: não

IamInstanceProfileArn  
O nome do recurso da Amazon (ARN) do perfil da instância do AWS Identity and Access Management (IAM) a ser associado às instâncias.  
Tipo: string  
Obrigatório: não

IamInstanceProfileName  
O nome do perfil de instância do IAM para a instância.  
Tipo: string  
Obrigatório: não

ImageId  
O ID da Amazon Machine Image (AMI).  
Tipo: String  
Exigido: sim

InstanceInitiatedShutdownBehavior  
Indica se a instância é interrompida ou encerrada no desligamento do sistema.  
Tipo: string  
Obrigatório: não

InstanceType  
O tipo de instância.  
Se o valor de um tipo de instância não for fornecido, o tipo de instância m1.small será usado.
Tipo: string  
Obrigatório: não

KernelId  
O ID do kernel.  
Tipo: string  
Obrigatório: não

KeyName  
O nome do par de chaves.  
Tipo: string  
Obrigatório: não

MaxInstanceCount  
O número máximo de instâncias a serem executadas.  
Tipo: string  
Obrigatório: não

MetadataOptions  
As opções de metadados da instância. Para obter mais informações, consulte [InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html).  
Tipo: StringMap  
Obrigatório: não

MinInstanceCount  
O número mínimo de instâncias a serem executadas.  
Tipo: string  
Obrigatório: não

Monitoramento  
Ativa ou desativa o monitoramento detalhado.  
Tipo: booliano  
Obrigatório: não

NetworkInterfaces  
As interfaces de rede.  
Tipo: MapList  
Obrigatório: não

Posicionamento  
O posicionamento da instância.  
Tipo: StringMap  
Obrigatório: não

PrivateIpAddress  
O endereço IPv4 primário.  
Tipo: string  
Obrigatório: não

RamdiskId  
O ID do disco RAM.  
Tipo: string  
Obrigatório: não

SecurityGroupIds  
Os IDs dos security groups da instância.  
Tipo: StringList  
Obrigatório: não

SecurityGroups  
Os nomes dos security groups da instância.  
Tipo: StringList  
Obrigatório: não

SubnetId  
O ID da sub-rede.  
Tipo: string  
Obrigatório: não

TagSpecifications  
As tags a serem aplicadas aos recursos durante a execução. Você só pode marcar instâncias e volumes na inicialização. As tags especificadas são aplicadas a todas as instâncias ou volumes que são criados durante a execução. Para marcar uma instância depois que ela tiver sido iniciada, use a ação [`aws:createTags`: cria tags para os recursos da AWS](automation-action-createtag.md).  
Tipo: MapList (Para obter mais informações, consulte [TagSpecification](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TagSpecification.html).)  
Obrigatório: não

UserData  
Um script fornecido como um valor literal de string. Se um valor literal for inserido, ele deverá ser codificado em Base64.  
Tipo: string  
Obrigatório: nãoOutput

InstanceIds  
Os IDs das instâncias.

InstanceStates  
O estado atual da instância.