• AWS Systems Manager CloudWatch ダッシュボードは、2026 年 4 月 30 日以降は利用できなくなります。お客様は、これまでと同様に Amazon CloudWatch コンソールを使用して、Amazon CloudWatch ダッシュボードの表示、作成、管理を継続できます。詳細については、「[Amazon CloudWatch ダッシュボードのドキュメント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)」を参照してください。

# `aws:runInstances` – Amazon EC2 インスタンスの起動
<a name="automation-action-runinstance"></a>

新しい Amazon Elastic Compute Cloud (Amazon EC2) インスタンスを起動します。

**注記**  
`aws:runInstances` アクションは、自動スロットリング再試行をサポートしています。詳細については、「[スロットリングされたオペレーションの自動再試行の設定](automation-throttling-retry.md)」を参照してください。

**Input**  
このアクションでは、ほとんどの API パラメータがサポートされています。詳細については、[RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html) 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 リソースネーム (ARN)。  
型: 文字列  
必須: いいえ

IamInstanceProfileName  
インスタンスの IAM インスタンスプロファイルの名前。  
型: 文字列  
必須: いいえ

ImageId  
Amazon Machine Image (AMI) の ID。  
型: 文字列  
必須: はい

InstanceInitiatedShutdownBehavior  
システムのシャットダウン時にインスタンスを停止するか終了するかを示します。  
型: 文字列  
必須: いいえ

InstanceType  
インスタンスタイプ。  
インスタンスタイプの値が指定されていない場合は、インスタンスタイプ m1.small を使用します。
型: 文字列  
必須: いいえ

KernelId  
カーネルの ID。  
型: 文字列  
必須: いいえ

KeyName  
キーペアの名前。  
型: 文字列  
必須: いいえ

MaxInstanceCount  
起動するインスタンスの最大数。  
型: 文字列  
必須: いいえ

MetadataOptions  
インスタンスのメタデータオプション。詳細については、「[InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html)」を参照してください。  
型: StringMap  
必須: いいえ

MinInstanceCount  
起動するインスタンスの最小数。  
型: 文字列  
必須: いいえ

Monitoring  
詳細モニタリングをオンまたはオフにします。  
タイプ: ブール値  
必須: いいえ

NetworkInterfaces  
ネットワークインターフェイス。  
型: MapList  
必須: いいえ

Placement  
インスタンスのプレイスメント。  
型: StringMap  
必須: いいえ

PrivateIpAddress  
プライマリ IPv4 アドレス。  
型: 文字列  
必須: いいえ

RamdiskId  
RAM ディスクの ID。  
型: 文字列  
必須: いいえ

SecurityGroupIds  
インスタンスのセキュリティグループの ID。  
タイプ: StringList  
必須: いいえ

SecurityGroups  
インスタンスのセキュリティグループの名前。  
タイプ: StringList  
必須: いいえ

SubnetId  
サブネット ID。  
型: 文字列  
必須: いいえ

TagSpecifications  
タグは、起動中のリソースに適用されます。起動時にインスタンスとボリュームにのみタグを付けることができます。指定されたタグは、すべてのインスタンス、または起動時に作成されたボリュームに適用されます。インスタンスを起動した後にタグを付けるには、[`aws:createTags` – AWS リソースのタグを作成する](automation-action-createtag.md) アクションを使用します。  
タイプ: MapList (詳細については、「[TagSpecification](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TagSpecification.html)」を参照してください)。  
必須: いいえ

UserData  
文字列リテラル値として渡されるスクリプト。リテラル値を入力する場合、Base64 エンコードである必要があります。  
型: 文字列  
必須: いいえOutput

InstanceIds  
インスタンスの ID。

InstanceStates  
インスタンスの現在の状態。