aws:runInstances – 啟動 Amazon EC2 執行個體。 - AWS Systems Manager

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" } ] } ] } }
ImageId

Amazon Machine Image (AMI) 的 ID。

類型:字串

必要:是

InstanceType

執行個體類型。

注意

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

類型:字串

必要:否

MinInstanceCount

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

類型:字串

必要:否

MaxInstanceCount

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

類型:字串

必要:否

AdditionalInfo

預訂.

類型:字串

必要:否

BlockDeviceMappings

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

類型:MapList

必要:否

ClientToken

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

類型:字串

必要:否

DisableApiTermination

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

類型:Boolean

必要:否

EbsOptimized

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

類型:Boolean

必要:否

IamInstanceProfileArn

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

類型:字串

必要:否

IamInstanceProfileName

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

類型:字串

必要:否

InstanceInitiatedShutdownBehavior

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

類型:字串

必要:否

KernelId

核心的 ID。

類型:字串

必要:否

KeyName

金鑰對的名稱。

類型:字串

必要:否

MaxInstanceCount

搜尋方案時要篩選的執行個體數量上限。

類型:Integer

必要:否

MinInstanceCount

搜尋方案時要篩選的執行個體數量下限。

類型:Integer

必要:否

監控

打開或關閉詳細監控。

類型:Boolean

必要:否

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

執行個體目前的狀態。