• Das AWS Systems Manager CloudWatch Dashboard wird nach dem 30. April 2026 nicht mehr verfügbar sein. Kunden können weiterhin die CloudWatch Amazon-Konsole verwenden, um ihre CloudWatch Amazon-Dashboards anzusehen, zu erstellen und zu verwalten, so wie sie es heute tun. Weitere Informationen finden Sie in der [Amazon CloudWatch Dashboard-Dokumentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# `aws:runInstances` - So starten Sie eine Amazon-EC2-Instance
<a name="automation-action-runinstance"></a>

Startet eine neue Amazon Elastic Compute Cloud (Amazon EC2)-Instance.

**Anmerkung**  
Die Aktion `aws:runInstances` unterstützt die automatische Drosselungswiederholung. Weitere Informationen finden Sie unter [Konfigurieren der automatischen Wiederholung für gedrosselte Vorgänge](automation-throttling-retry.md).

**Input**  
Die Aktion unterstützt die meisten API-Parameter. Weitere Informationen finden Sie in der [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html)API-Dokumentation.

------
#### [ 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  
Reserved Instances.  
Typ: Zeichenfolge  
Erforderlich: Nein

BlockDeviceMappings  
Die Blockgeräte für die Instance.  
Typ: MapList  
Erforderlich: Nein

ClientToken  
Der Bezeichner, um die Idempotenz der Anfrage sicherzustellen.  
Typ: Zeichenfolge  
Erforderlich: Nein

DisableApiTermination  
Aktiviert oder deaktiviert die Instance-API-Beendigung.  
Typ: Boolesch  
Erforderlich: Nein

EbsOptimized  
Aktiviert oder deaktiviert die Amazon Elastic Block Store (Amazon EBS)-Optimierung.  
Typ: Boolesch  
Erforderlich: Nein

IamInstanceProfileArn  
Der Amazon-Ressourcenname (ARN) des AWS Identity and Access Management (IAM) -Instance-Profils für die Instance.  
Typ: Zeichenfolge  
Erforderlich: Nein

IamInstanceProfileName  
Der Name des IAM-Instance-Profils für die Instance.  
Typ: Zeichenfolge  
Erforderlich: Nein

ImageId  
Die ID des Amazon Machine Image (AMI).  
Typ: Zeichenfolge  
Erforderlich: Ja

InstanceInitiatedShutdownBehavior  
Gibt an, ob die Instance beim Herunterfahren des Systems angehalten oder beendet wird.  
Typ: Zeichenfolge  
Erforderlich: Nein

InstanceType  
Der Instance-Typ.  
Wenn kein Wert für den Instance-Typ angegeben wird, wird der Instance-Typ m1.small verwendet.
Typ: Zeichenfolge  
Erforderlich: Nein

KernelId  
Die ID des Kernels.  
Typ: Zeichenfolge  
Erforderlich: Nein

KeyName  
Der Name des Schlüsselpaars.  
Typ: Zeichenfolge  
Erforderlich: Nein

MaxInstanceCount  
Die Höchstanzahl zu startender Instances.  
Typ: Zeichenfolge  
Erforderlich: Nein

MetadataOptions  
Die Metadatenoptionen für die Instance. Weitere Informationen finden Sie unter [InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html).  
Typ: StringMap  
Erforderlich: Nein

MinInstanceCount  
Die Mindestanzahl zu startender Instances.  
Typ: Zeichenfolge  
Erforderlich: Nein

Überwachen  
Aktiviert oder deaktiviert die detaillierte Überwachung.g  
Typ: Boolesch  
Erforderlich: Nein

NetworkInterfaces  
Die Netzwerkschnittstellen.  
Typ: MapList  
Erforderlich: Nein

Placement  
Die Platzierung für die Instance.  
Typ: StringMap  
Erforderlich: Nein

PrivateIpAddress  
Die primäre IPv4 Adresse.  
Typ: Zeichenfolge  
Erforderlich: Nein

RamdiskId  
Die ID des RAM-Datenträgers.  
Typ: Zeichenfolge  
Erforderlich: Nein

SecurityGroupIds  
Die IDs der Sicherheitsgruppen für die Instance.  
Typ: StringList  
Erforderlich: Nein

SecurityGroups  
Die Namen der Sicherheitsgruppen für die Instance.  
Typ: StringList  
Erforderlich: Nein

SubnetId  
Die Subnetz-ID.  
Typ: Zeichenfolge  
Erforderlich: Nein

TagSpecifications  
Die Tags, die beim Start auf die Ressourcen angewendet werden. Instances und Volumes können nur beim Start mit Tags versehen werden. Die angegebenen Tags werden auf alle Instances bzw. Volumes angewendet, die beim Start erstellt werden. Um eine Instance nach dem Start mit Tags zu versehen, verwenden Sie die Aktion [`aws:createTags`— Erstelle Tags für AWS Ressourcen](automation-action-createtag.md).  
Typ: MapList (Weitere Informationen finden Sie unter [TagSpecification](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TagSpecification.html).)  
Erforderlich: Nein

UserData  
Ein Skript, das als Zeichenfolgenliteralwert bereitgestellt wird. Wenn ein Literalwert eingegeben wird, muss er Base64-kodiert sein.  
Typ: Zeichenfolge  
Erforderlich: NeinAusgabe

InstanceIds  
Die IDs der Instanzen.

InstanceStates  
Der Status der Instance.