• AWS Systems Manager CloudWatch Dasbor tidak akan lagi tersedia setelah 30 April 2026. Pelanggan dapat terus menggunakan CloudWatch konsol Amazon untuk melihat, membuat, dan mengelola CloudWatch dasbor Amazon mereka, seperti yang mereka lakukan hari ini. Untuk informasi selengkapnya, lihat [dokumentasi CloudWatch Dasbor Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# `aws:runInstances` – Luncurkan Instans Amazon EC2
<a name="automation-action-runinstance"></a>

Luncurkan Amazon Elastic Compute Cloud (Amazon EC2) yang baru.

**catatan**  
`aws:runInstances`Tindakan ini mendukung percobaan ulang pelambatan otomatis. Untuk informasi selengkapnya, lihat [Mengkonfigurasi percobaan ulang otomatis untuk operasi yang dibatasi](automation-throttling-retry.md).

**Input**  
Tindakan ini mendukung sebagian besar parameter API. Untuk informasi selengkapnya, lihat dokumentasi [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  
Dicadangkan.  
Jenis: String  
Wajib: Tidak

BlockDeviceMappings  
Perangkat blok untuk instans.  
Jenis: MapList  
Wajib: Tidak

ClientToken  
Pengenal untuk memastikan idempotensi permintaan.  
Jenis: String  
Wajib: Tidak

DisableApiTermination  
Menghidupkan atau mematikan penghentian API instans.  
Jenis: Boolean  
Wajib: Tidak

EbsOptimized  
Menghidupkan atau mematikan optimisasi Amazon Elastic Block Store (Amazon EBS).  
Jenis: Boolean  
Wajib: Tidak

IamInstanceProfileArn  
Nama Sumber Daya Amazon (ARN) dari profil instans AWS Identity and Access Management (IAM) untuk instance tersebut.  
Tipe: String  
Wajib: Tidak

IamInstanceProfileName  
Nama profil instans (IAM) untuk instans.  
Jenis: String  
Wajib: Tidak

ImageId  
ID Amazon Machine Image (AMI).  
Jenis: String  
Diperlukan: Ya

InstanceInitiatedShutdownBehavior  
Menunjukkan apakah instans berhenti atau berakhir pada sistem shutdown.  
Jenis: String  
Wajib: Tidak

InstanceType  
Jenis instance.  
Jika nilai jenis instans tidak disediakan, jenis instans m1.small digunakan.
Jenis: String  
Wajib: Tidak

KernelId  
ID kernel.  
Jenis: String  
Wajib: Tidak

KeyName  
Nama pasangan kunci.  
Jenis: String  
Wajib: Tidak

MaxInstanceCount  
Jumlah instans maksimum untuk diluncurkan.  
Jenis: String  
Wajib: Tidak

MetadataOptions  
Opsi metadata untuk instans. Untuk informasi selengkapnya, lihat [InstanceMetadataOptionsRequest](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InstanceMetadataOptionsRequest.html).  
Jenis: StringMap  
Wajib: Tidak

MinInstanceCount  
Jumlah instans minimum untuk diluncurkan.  
Jenis: String  
Wajib: Tidak

Pemantauan  
Menghidupkan atau mematikan pemantauan terperinci.  
Jenis: Boolean  
Wajib: Tidak

NetworkInterfaces  
Antarmuka jaringan.  
Jenis: MapList  
Wajib: Tidak

Penempatan  
Penempatan untuk instans.  
Jenis: StringMap  
Wajib: Tidak

PrivateIpAddress  
Primer alamat penyuratan IPv4.  
Jenis: String  
Wajib: Tidak

RamdiskId  
ID disk RAM.  
Jenis: String  
Wajib: Tidak

SecurityGroupIds  
ID grup keamanan untuk instans.  
Jenis: StringList  
Wajib: Tidak

SecurityGroups  
Nama grup keamanan untuk instans.  
Jenis: StringList  
Wajib: Tidak

SubnetId  
ID subnet.  
Jenis: String  
Wajib: Tidak

TagSpecifications  
Tag untuk diterapkan ke sumber daya selama peluncuran. Anda hanya dapat menandai instans dan volume saat peluncuran. Tag tertentu diterapkan untuk semua instans atau volume yang dibuat selama peluncuran. Untuk menandai instans setelah diluncurkan, gunakan [`aws:createTags`— Buat tag untuk AWS sumber daya](automation-action-createtag.md) tindakan.  
Jenis: MapList (Untuk informasi lebih lanjut, lihat [TagSpecification](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TagSpecification.html).)  
Wajib: Tidak

UserData  
Sebuah skrip yang disediakan sebagai nilai literal string. Jika nilai literal dimasukkan, maka itu harus Base64-encoded.  
Tipe: String  
Wajib: TidakOutput

InstanceIds  
ID instans.

InstanceStates  
Status tabel saat ini ().