aws:runInstances— 启动 Amazon EC2 实例 - Amazon Web Services Systems Manager
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

的 IDAmazon Machine Image(AMI)。

类型: 字符串

：必需 是

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 资源名称 (ARN)。

类型: 字符串

：必需 否

IamInstanceProfileName

实例的 IAM 实例配置文件的名称。

类型: 字符串

：必需 否

InstanceInitiatedShutdownBehavior

指示此实例是否在系统关闭时停止或终止。

类型: 字符串

：必需 否

KernelId

内核的 ID。

类型: 字符串

：必需 否

KeyName

密钥对的名称。

类型: 字符串

：必需 否

MaxInstanceCount

搜索服务时可筛选的实例数量上限。

类型: 整数

：必需 否

MinInstanceCount

搜索服务时可筛选的实例数量下限。

类型: 整数

：必需 否

监控

启动或禁用详细监控。

类型: Boolean

：必需 否

NetworkInterfaces

网络接口。

类型: MapList

：必需 否

Placement

实例的置放。

类型: StringMap

：必需 否

PrivateIpAddress

主要 IPv4 地址。

类型: 字符串

：必需 否

RamdiskId

RAM 磁盘的 ID。

类型: 字符串

：必需 否

SecurityGroupIds

实例的安全组的 ID。

类型: StringList

：必需 否

SecurityGroups

实例的安全组的名称。

类型: StringList

：必需 否

SubnetId

子网 ID。

类型: 字符串

：必需 否

TagSpecifications

在启动期间应用于资源的标签。您只能在启动时标记实例和卷。指定的标签将应用于在启动期间创建的所有实例或卷。要在启动实例后对其进行标记，请使用 aws:createTags— 为创建标签Amazonresources 操作。

类型: MapList（有关更多信息，请参阅TagSpecification。）

：必需 否

UserData

作为字符串文本值提供的脚本。如果输入文本值，则必须为 Base64 编码。

类型: 字符串

：必需 否

Output

InstanceIds

实例的 ID。

示例状态

实例的当前状态。