AWS EC2 Run Instances VERSION 1

This handler uses the AWS REST API Launch the specified number of instances using an AMI for which you have permissions. For more information see the AWS Amazon Virtual Private Cloud User Guide online.

The Dry Run parameter validates user permissions and inputs. If it is set to true, an error will always be thrown by the handler before completing the handler action. Error response will be 'DryRunOperation' if the account has proper permissions and inputs; 'UnauthorizedOperation' if the account does not have proper permissions.


Dry RunDry run validates user permissions and inputs without completing the EC2 action (true or false).
Image IDThe ID of the AMI.
Minimum Instance CountThe minimum number of instances to launch.
Maximum Instance CountThe maximum number of instances to launch.
Key NameThe name of the key pair.
Security GroupsOne or more security group names, separated by commas.
Security Group IDsOne or more security group IDs, separated by commas.
User DataThe Base64-encoded MIME user data for the instances.
Instance TypeThe instance type.
PlacementThe placement for the instance.
Kernel IDThe ID of the kernel.
Ramdisk IDThe ID of the RAM disk.
Block Device MappingThe block device mapping.
Monitoringtrue or false. The monitoring for the instance.
Subnet IDThe ID of the subnet to launch the instance into.
Disable API Terminationtrue or false. If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console.
Instance Initiated Shutdown BehaviorAccepts 'stop' or 'terminate'. Indicates whether an instance stops or terminates when you initiate shutdown.
Private IP AddressThe primary IP address.
Client TokenUnique, case-sensitive identifier you provide to ensure the idempotency of the request.
Network InterfacesOne or more network interfaces.
IAM Instance ProfileThe IAM instance profile.
EBS Optimizedtrue or false. Indicates whether the instance is optimized for EBS I/O.

Sample Configuration

Dry Run
Image ID
Minimum Instance Count
Maximum Instance Count
Key Name
Security Groups
Security Group IDs
User Data
Instance Type
Kernel ID
Ramdisk ID
Block Device Mapping
Subnet ID
Disable API Termination
Instance Initiated Shutdown Behavior
Private IP Address
Client Token
Network Interfaces
IAM Instance Profile
EBS Optimized


NameSample Result
Reservation IDReservation of ID EC2 run instances.
Owner IDOwner ID of EC2 run instances.
Requester IDRequester ID of EC2 run instances.
Groups XLMGroups XLM of EC2 run instances.
Groups StringGroups String of EC2 run instances.
Instances XMLInstances XML of EC2 run instances.
Instances StringInstances String of EC2 run instances.


No Changelog Available.