aws:runInstances – 啟動 Amazon EC2 執行個體。

啟動新的 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體。

Input

動作支援大部分的 API 參數。如需詳細資訊，請參閱 RunInstances 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

預訂.

類型：字串

必要：否

BlockDeviceMappings

執行個體的區塊型儲存設備。

類型：MapList

必要：否

ClientToken

用於確保請求之冪等的識別符。

類型：字串

必要：否

DisableApiTermination

開啟或關閉執行個體 API 終止。

類型：布林值

必要：否

EbsOptimized

開啟或關閉 Amazon Elastic Block Store (Amazon EBS) 最佳化。

類型：布林值

必要：否

IamInstanceProfileArn

AWS Identity and Access Management (IAM) 執行個體設定檔的 Amazon Resource Name (ARN)。

類型：字串

必要：否

IamInstanceProfileName

執行個體之 IAM 執行個體設定檔的名稱。

類型：字串

必要：否

ImageId

Amazon Machine Image (AMI) 的 ID。

類型：字串

必要：是

InstanceInitiatedShutdownBehavior

指示執行個體在系統關機時停止或終止。

類型：字串

必要：否

InstanceType

執行個體類型。

注意

如果不提供執行個體類型價值，則會使用 m1.small 執行個體類型。

類型：字串

必要：否

KernelId

核心的 ID。

類型：字串

必要：否

KeyName

金鑰對的名稱。

類型：字串

必要：否

MaxInstanceCount

要啟動的執行個體數量上限。

類型：字串

必要：否

MetadataOptions

執行個體的中繼資料選項。如需詳細資訊，請參閱 InstanceMetadataOptionsRequest。

類型：StringMap

必要：否

MinInstanceCount

要啟動的執行個體數量下限。

類型：字串

必要：否

監控

打開或關閉詳細監控。

類型：布林值

必要：否

NetworkInterfaces

網路界面。

類型：MapList

必要：否

配置

執行個體的配置。

類型：StringMap

必要：否

PrivateIpAddress

主要 IPv4 地址。

類型：字串

必要：否

RamdiskId

RAM 磁碟的 ID。

類型：字串

必要：否

SecurityGroupIds

執行個體安全群組的 ID。

類型：StringList

必要：否

SecurityGroups

執行個體安全群組的名稱。

類型：StringList

必要：否

SubnetId

子網路 ID。

類型：字串

必要：否

TagSpecifications

要在啟動期間套用到資源的標籤。您只能在啟動時標記執行個體和磁碟區。指定的標籤會套用至所有於啟動期間建立的執行個體或磁碟區。若要在執行個體啟動後將其標記，請使用 aws:createTags – 建立 AWS 資源的標籤 動作。

類型：MapList (如需詳細資訊，請參閱 TagSpecification。)

必要：否

UserData

做為字串常值提供的指令碼。如果輸入常值，則其必須為 Base64 編碼。

類型：字串

必要：否

輸出

InstanceIds

執行個體的 ID。

InstanceStates

執行個體目前的狀態。