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

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

aws:runInstances – 启动 Amazon EC2 实例

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

输入

此操作支持大多数 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

针对实例的 Amazon 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

必需:否

Placement

实例的置放。

类型:StringMap

必需:否

PrivateIpAddress

主要 IPv4 地址。

类型:字符串

必需:否

RamdiskId

RAM 磁盘的 ID。

类型:字符串

必需:否

SecurityGroupIds

实例的安全组的 ID。

类型:StringList

必需:否

SecurityGroups

实例的安全组的名称。

类型:StringList

必需:否

SubnetId

子网 ID。

类型:字符串

必需:否

TagSpecifications

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

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

必需:否

UserData

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

类型:字符串

必需:否

输出
InstanceIds

实例的 ID。

InstanceState

实例的当前状态。