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。

示例状态

实例的当前状态。