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

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

aws:runInstances – 启动 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 系统映像 (AMI) 的 ID。

类型:字符串

必需:是

InstanceType

实例类型。

注意

如果未提供实例类型值,则使用 m1.small 实例类型。

类型:字符串

必需:否

MinInstanceCount

要启动的实例的最小数量。

类型:字符串

必需:否

MaxInstanceCount

要启动的实例的最大数量。

类型:字符串

必需:否

AdditionalInfo

预留。

类型:字符串

必需:否

BlockDeviceMappings

适用于实例的块储存设备。

类型:MapList

必需:否

ClientToken

用于确保请求的幂等性的标识符。

类型:字符串

必需:否

DisableApiTermination

启用或禁用实例 API 终止

类型:布尔值

必需:否

EbsOptimized

启用或禁用 EBS 优化。

类型:布尔值

必需:否

IamInstanceProfileArn

实例的 IAM 实例配置文件的 ARN。

类型:字符串

必需:否

IamInstanceProfileName

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

类型:字符串

必需:否

InstanceInitiatedShutdownBehavior

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

类型:字符串

必需:否

KernelId

内核的 ID。

类型:字符串

必需:否

KeyName

密钥对的名称。

类型:字符串

必需:否

MaxInstanceCount

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

类型:整数

必需:否

MinInstanceCount

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

类型:整数

必需:否

监控

启动或禁用详细监控。

类型:布尔值

必需:否

NetworkInterfaces

网络接口。

类型:MapList

必需:否

Placement

实例的置放。

类型:StringMap

必需:否

PrivateIpAddress

主要 IPv4 地址。

类型:字符串

必需:否

RamdiskId

RAM 磁盘的 ID。

类型:字符串

必需:否

SecurityGroupIds

实例的安全组的 ID。

类型:StringList

必需:否

SecurityGroups

实例的安全组的名称。

类型:StringList

必需:否

SubnetId

子网 ID。

类型:字符串

必需:否

TagSpecifications

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

类型:MapList(有关更多信息,请参阅 TagSpecification.)

必需:否

UserData

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

类型:字符串

必需:否

Output

InstanceIds

实例的 ID。

实例状态

实例的当前状态。