• 2026 年 4 月 30 日之後將不再提供 AWS Systems Manager CloudWatch Dashboard。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板，就像現在一樣。如需詳細資訊，請參閱 [Amazon CloudWatch Dashboard 文件](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `aws:runInstances` – 啟動 Amazon EC2 執行個體。
<a name="automation-action-runinstance"></a>

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

**注意**  
`aws:runInstances` 動作支援自動限流重試。如需詳細資訊，請參閱[設定限流操作的自動重試](automation-throttling-retry.md)。

**Input**  
動作支援大部分的 API 參數。如需詳細資訊，請參閱 [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html) 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  
執行個體之 (IAM) 執行個體描述檔的 Amazon Resource Name AWS Identity and Access Management (ARN)。  
類型：字串  
必要：否

IamInstanceProfileName  
執行個體之 IAM 執行個體設定檔的名稱。  
類型：字串  
必要：否

ImageId  
Amazon Machine Image (AMI) 的 ID。  
類型：字串  
必要：是

InstanceInitiatedShutdownBehavior  
指示執行個體在系統關機時停止或終止。  
類型：字串  
必要：否

InstanceType  
執行個體類型。  
如果不提供執行個體類型價值，則會使用 m1.small 執行個體類型。
類型：字串  
必要：否

KernelId  
核心的 ID。  
類型：字串  
必要：否

KeyName  
金鑰對的名稱。  
類型：字串  
必要：否

MaxInstanceCount  
要啟動的執行個體數量上限。  
類型：字串  
必要：否

MetadataOptions  
執行個體的中繼資料選項。如需詳細資訊，請參閱 [InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html)。  
類型：StringMap  
必要：否

MinInstanceCount  
要啟動的執行個體數量下限。  
類型：字串  
必要：否

監控  
打開或關閉詳細監控。  
類型：布林值  
必要：否

NetworkInterfaces  
網路界面。  
類型：MapList  
必要：否

配置  
執行個體的配置。  
類型：StringMap  
必要：否

PrivateIpAddress  
主要 IPv4 地址。  
類型：字串  
必要：否

RamdiskId  
RAM 磁碟的 ID。  
類型：字串  
必要：否

SecurityGroupIds  
執行個體安全群組的 ID。  
類型：StringList  
必要：否

SecurityGroups  
執行個體安全群組的名稱。  
類型：StringList  
必要：否

SubnetId  
子網路 ID。  
類型：字串  
必要：否

TagSpecifications  
要在啟動期間套用到資源的標籤。您只能在啟動時標記執行個體和磁碟區。指定的標籤會套用至所有於啟動期間建立的執行個體或磁碟區。若要在執行個體啟動後將其標記，請使用 [`aws:createTags` – 建立 AWS 資源的標籤](automation-action-createtag.md) 動作。  
類型：MapList (如需詳細資訊，請參閱 [TagSpecification](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TagSpecification.html)。)  
必要：否

UserData  
做為字串常值提供的指令碼。如果輸入常值，則其必須為 Base64 編碼。  
類型：字串  
必要：否Output

InstanceIds  
執行個體的 ID。

InstanceStates  
執行個體目前的狀態。