aws:runInstances - So starten Sie eine Amazon-EC2-Instance - AWS Systems Manager

aws:runInstances - So starten Sie eine Amazon-EC2-Instance

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

Eingabe

Die Aktion unterstützt die meisten API-Parameter. Weitere Informationen finden Sie in der RunInstances-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.

Anmerkung

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.

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 - Erstellen von Tags für AWS-Ressourcen.

Type: MapList (Weitere Informationen finden Sie unter TagSpecification.)

Erforderlich: Nein

UserData

Ein Skript, das als Zeichenfolgenliteralwert bereitgestellt wird. Wenn ein Literalwert eingegeben wird, muss er Base64-kodiert sein.

Typ: Zeichenfolge

Erforderlich: Nein

Output
InstanceIds

Die IDs der Instances.

InstanceStates

Der Status der Instance.