• Le AWS Systems Manager CloudWatch tableau de bord ne sera plus disponible après le 30 avril 2026. Les clients peuvent continuer à utiliser CloudWatch la console Amazon pour consulter, créer et gérer leurs CloudWatch tableaux de bord Amazon, comme ils le font aujourd'hui. Pour plus d'informations, consultez la [documentation Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# `aws:runInstances` – lancer une instance Amazon EC2
<a name="automation-action-runinstance"></a>

Lance une nouvelle instance Amazon Elastic Compute Cloud (Amazon EC2).

**Note**  
L’action `aws:runInstances` prend en charge la limitation des nouvelles tentatives. Pour de plus amples informations, veuillez consulter [Configuration des nouvelles tentatives automatiques pour les opérations limitées](automation-throttling-retry.md).

**Input**  
L'action prend en charge la plupart des paramètres de l'API. Pour plus d'informations, consultez la documentation de [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html)l'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  
Instances réservées.  
Type : chaîne  
Obligatoire : non

BlockDeviceMappings  
Périphériques de stockage en mode bloc pour l'instance.  
Type : MapList  
Obligatoire : non

ClientToken  
Identifiant permettant de garantir l'idempotence de la demande.  
Type : chaîne  
Obligatoire : non

DisableApiTermination  
Active ou désactive la résiliation de l'API d'instance.  
Type : booléen  
Obligatoire : non

EbsOptimized  
Active ou désactive l'optimisation Amazon Elastic Block Store (Amazon EBS).  
Type : booléen  
Obligatoire : non

IamInstanceProfileArn  
Le nom de ressource Amazon (ARN) du profil d'instance Gestion des identités et des accès AWS (IAM) de l'instance.  
Type : chaîne  
Obligatoire : non

IamInstanceProfileName  
Nom du profil d'instance IAM pour l'instance.  
Type : chaîne  
Obligatoire : non

ImageId  
ID de l'Amazon Machine Image (AMI).  
Type : Chaîne  
Obligatoire : oui

InstanceInitiatedShutdownBehavior  
Indique si l'instance s'arrête ou est résiliée lors de l'arrêt du système.  
Type : chaîne  
Obligatoire : non

InstanceType  
Type d'instance.  
Si aucune valeur de type d'instance n'est fournie, le type d'instance m1.small est utilisé.
Type : chaîne  
Obligatoire : non

KernelId  
ID du noyau.  
Type : chaîne  
Obligatoire : non

KeyName  
Nom de la paire de clés.  
Type : chaîne  
Obligatoire : non

MaxInstanceCount  
Nombre maximum d'instances à lancer.  
Type : chaîne  
Obligatoire : non

MetadataOptions  
Options de métadonnées de l'instance. Pour de plus amples informations, veuillez consulter [InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html).  
Type : StringMap  
Obligatoire : non

MinInstanceCount  
Nombre minimum d'instances à lancer.  
Type : chaîne  
Obligatoire : non

Contrôle  
Active ou désactive la surveillance détaillée.  
Type : booléen  
Obligatoire : non

NetworkInterfaces  
Interfaces réseau.  
Type : MapList  
Obligatoire : non

Placement  
Placement de l'instance.  
Type : StringMap  
Obligatoire : non

PrivateIpAddress  
Adresse IPv4 principale.  
Type : chaîne  
Obligatoire : non

RamdiskId  
ID du disque RAM.  
Type : chaîne  
Obligatoire : non

SecurityGroupIds  
ID des groupes de sécurité de l'instance.  
Type : StringList  
Obligatoire : non

SecurityGroups  
Noms des groupes de sécurité de l'instance.  
Type : StringList  
Obligatoire : non

SubnetId  
ID de sous-réseau.  
Type : chaîne  
Obligatoire : non

TagSpecifications  
Balises à appliquer aux ressources lors du lancement. Vous pouvez uniquement baliser des instances et des volumes au moment du lancement. Les balises spécifiées sont appliquées à toutes les instances ou volumes qui sont créés lors du lancement. Pour ajouter des balises à une instance après qu'elle a été lancée, utilisez l'action [`aws:createTags`— Crée des tags pour les AWS ressources](automation-action-createtag.md).  
Type : MapList (Pour plus d'informations, voir [TagSpecification](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TagSpecification.html).)  
Obligatoire : non

UserData  
Script fourni en tant que valeur de littéral de chaîne. Si une valeur littérale est saisie, elle doit l'être Base64-encoded.  
Type : chaîne  
Obligatoire : nonOutput

InstanceIds  
ID des instances.

InstanceStates  
Statut actuel de l'instance.