aws:runInstances – 启动 Amazon EC2 实例 - AWS Systems Manager

aws:runInstances – 启动 Amazon EC2 实例

启动新的 Amazon Elastic Compute Cloud (Amazon EC2) 实例。

注意

aws:runInstances 操作支持自动节流重试。有关更多信息，请参阅 为节流的操作配置自动重试。

输入

此操作支持大多数 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.小型实例类型。

类型：字符串

必需：否

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。

InstanceState

实例的当前状态。