• 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:runInstances`: avvio di un'istanza di Amazon EC2
<a name="automation-action-runinstance"></a>

Avvia una nuova istanza di Amazon Elastic Compute Cloud (Amazon EC2).

**Nota**  
L'azione `aws:runInstances` 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**  
L'operazione supporta la maggior parte dei parametri API. Per ulteriori informazioni, consulta la documentazione dell'[RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html)API.

------
#### [ 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  
Riservata.  
▬Tipo: stringa  
Obbligatorio: no

BlockDeviceMappings  
Dispositivi a blocchi per l'istanza.  
Tipo: MapList  
Obbligatorio: no

ClientToken  
Identificatore univoco per assicurare l'idempotenza della richiesta.  
▬Tipo: stringa  
Obbligatorio: no

DisableApiTermination  
Attiva o disattiva la terminazione dell'API dell'istanza.  
Tipo: Booleano  
Obbligatorio: no

EbsOptimized  
Attiva o disattiva l'ottimizzazione di Amazon Elastic Block Store (Amazon EBS).  
Tipo: Booleano  
Obbligatorio: no

IamInstanceProfileArn  
L'Amazon Resource Name (ARN) del profilo dell'istanza AWS Identity and Access Management (IAM) per l'istanza.  
▬Tipo: stringa  
Obbligatorio: no

IamInstanceProfileName  
Nome del profilo dell'istanza IAM per l'istanza.  
▬Tipo: stringa  
Obbligatorio: no

ImageId  
L'ID del Amazon Machine Image (AMI).  
Tipo: stringa  
Obbligatorio: sì

InstanceInitiatedShutdownBehavior  
Indica se l'istanza viene arrestata o terminata in caso di arresto del sistema.  
▬Tipo: stringa  
Obbligatorio: no

InstanceType  
Il tipo di istanza.  
Se non viene fornito un valore di un tipo di istanza, viene utilizzato il tipo di istanza m1.small.
▬Tipo: stringa  
Obbligatorio: no

KernelId  
ID del kernel.  
▬Tipo: stringa  
Obbligatorio: no

KeyName  
Nome della coppia di chiavi.  
▬Tipo: stringa  
Obbligatorio: no

MaxInstanceCount  
Numero massimo di istanze da avviare.  
▬Tipo: stringa  
Obbligatorio: no

MetadataOptions  
Le opzioni dei metadati per l'istanza. Per ulteriori informazioni, consulta [InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html).  
Tipo: StringMap  
Obbligatorio: no

MinInstanceCount  
Numero minimo di istanze da avviare.  
▬Tipo: stringa  
Obbligatorio: no

Monitoraggio  
Attiva o disattiva il monitoraggio dettagliato.  
Tipo: Booleano  
Obbligatorio: no

NetworkInterfaces  
Interfacce di rete.  
Tipo: MapList  
Obbligatorio: no

Placement  
Posizionamento dell'istanza.  
Tipo: StringMap  
Obbligatorio: no

PrivateIpAddress  
L' IPv4 indirizzo principale.  
▬Tipo: stringa  
Obbligatorio: no

RamdiskId  
L'ID del disco RAM.  
▬Tipo: stringa  
Obbligatorio: no

SecurityGroupIds  
I gruppi IDs di sicurezza per l'istanza.  
Tipo: StringList  
Obbligatorio: no

SecurityGroups  
Nomi dei gruppi di sicurezza per l'istanza.  
Tipo: StringList  
Obbligatorio: no

SubnetId  
L'ID sottorete.  
▬Tipo: stringa  
Obbligatorio: no

TagSpecifications  
I tag da applicare alle risorse durante il lancio. È possibile contrassegnare mediante tag solo le istanze e i volumi all'avvio. I tag specificati vengono applicati a tutti i volumi o le istanze che vengono creati durante il lancio. Per contrassegnare mediante tag un'istanza dopo che è stata avviata, utilizza l'operazione [`aws:createTags`— Crea tag per AWS le risorse](automation-action-createtag.md).  
Tipo: MapList (per ulteriori informazioni, vedere [TagSpecification](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TagSpecification.html).)  
Obbligatorio: no

UserData  
Script fornito sotto forma di valore letterale di stringa. Se viene immesso un valore letterale, deve essere con codifica Base64.  
▬Tipo: stringa  
Obbligatorio: noOutput

InstanceIds  
Le IDs istanze.

InstanceStates  
Lo stato attuale dell'istanza.