• El panel de AWS Systems Manager CloudWatch dejará de estar disponible después del 30 de abril de 2026. Los clientes pueden seguir utilizando la consola de Amazon CloudWatch para ver, crear y administrar sus paneles de Amazon CloudWatch, tal y como lo hacen actualmente. Para obtener más información, consulte la [documentación del panel de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# `aws:runInstances`: lanzar una instancia de Amazon EC2
<a name="automation-action-runinstance"></a>

Lanza una instancia nueva de Amazon Elastic Compute Cloud (Amazon EC2).

**nota**  
La acción `aws:runInstances` admite el reintento automático de limitación. Para obtener más información, consulte [Configurar el reintento automático para operaciones limitadas](automation-throttling-retry.md).

**Input**  
La acción admite la mayoría de los parámetros de la API. Para obtener más información, consulte la documentación de la 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: cadena  
Requerido: no

BlockDeviceMappings  
Los dispositivos de bloques para la instancia.  
Tipo: MapList  
Obligatorio: no

ClientToken  
El identificador para garantizar la instancia idempotente de la solicitud.  
Tipo: cadena  
Requerido: no

DisableApiTermination  
Activa o desactiva la terminación de la API de la instancia.  
Tipo: Booleano  
Obligatorio: no

EbsOptimized  
Activa o desactiva la optimización de Amazon Elastic Block Store (Amazon EBS).  
Tipo: Booleano  
Obligatorio: no

IamInstanceProfileArn  
El nombre de recurso de Amazon (ARN) del perfil de instancia de AWS Identity and Access Management (IAM).  
Tipo: cadena  
Requerido: no

IamInstanceProfileName  
El nombre del perfil de instancia de IAM correspondiente a la instancia.  
Tipo: cadena  
Requerido: no

ImageId  
El ID de la Amazon Machine Image (AMI).  
Tipo: cadena  
Obligatorio: sí

InstanceInitiatedShutdownBehavior  
Indica si la instancia se detiene o termina al cerrarse el sistema.  
Tipo: cadena  
Requerido: no

InstanceType  
El tipo de instancia.  
Si no se proporciona el valor de tipo de instancia, se emplea el tipo de instancia m1.small.
Tipo: cadena  
Requerido: no

KernelId  
El ID del kernel.  
Tipo: cadena  
Requerido: no

KeyName  
El nombre del par de claves.  
Tipo: cadena  
Requerido: no

MaxInstanceCount  
El número máximo de instancias que se van a lanzar.  
Tipo: cadena  
Requerido: no

MetadataOptions  
Opciones de metadatos de la instancia. Para obtener más información, consulte [InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html).  
Tipo: StringMap  
Obligatorio: no

MinInstanceCount  
El número mínimo de instancias que se van a lanzar.  
Tipo: cadena  
Requerido: no

Supervisión  
Activa o desactiva el monitoreo detallado.  
Tipo: Booleano  
Obligatorio: no

NetworkInterfaces  
Las interfaces de red.  
Tipo: MapList  
Obligatorio: no

Placement  
La ubicación de la instancia.  
Tipo: StringMap  
Obligatorio: no

PrivateIpAddress  
La dirección IPv4 principal.  
Tipo: cadena  
Requerido: no

RamdiskId  
El ID del disco RAM.  
Tipo: cadena  
Requerido: no

SecurityGroupIds  
Los ID de los grupos de seguridad para la instancia.  
Tipo: StringList  
Obligatorio: no

SecurityGroups  
Los nombres de los grupos de seguridad para la instancia.  
Tipo: StringList  
Obligatorio: no

SubnetId  
El ID de subred.  
Tipo: cadena  
Requerido: no

TagSpecifications  
Las etiquetas que aplicar a los recursos durante el lanzamiento. Solo puede etiquetar instancias y volúmenes en el momento del lanzamiento. Las etiquetas especificadas se aplican a todas las instancias o volúmenes que se crean durante el lanzamiento. Para etiquetar una instancia después de que se haya lanzado, utilice la acción [`aws:createTags`: crear etiquetas para recursos de AWS](automation-action-createtag.md).  
Tipo MapList (Para obtener más información, consulte [TagSpecification](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TagSpecification.html)).  
Obligatorio: no

UserData  
Un script proporcionado como un valor literal de cadena. Si se escribe un valor literal, debe estar codificado en Base64.  
Tipo: cadena  
Requerido: noOutput

InstanceIds  
Los ID de las instancias.

InstanceStates  
El estado actual de la instancia.