• AWS Systems Manager CloudWatch 控制面板在 2026 年 4 月 30 日之后将不再可用。客户可以像现在一样继续使用 Amazon CloudWatch 控制台来查看、创建和管理其 Amazon CloudWatch 控制面板。有关更多信息，请参阅 [Amazon CloudWatch 控制面板文档](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  
针对实例的 AWS Identity and Access Management (IAM) 实例配置文件的 Amazon Resource Name (ARN)。  
类型：字符串  
必需：否

IamInstanceProfileName  
实例的 IAM 实例配置文件的名称。  
类型：字符串  
必需：否

ImageId  
Amazon Machine Image (AMI) 的 ID。  
类型：字符串  
是否必需：是

InstanceInitiatedShutdownBehavior  
指示此实例是否在系统关闭时停止或终止。  
类型：字符串  
必需：否

InstanceType  
实例类型。  
如果未提供实例类型值，则使用 m1.小型实例类型。
类型：字符串  
必需：否

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。

InstanceState  
实例的当前状态。