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.


Name Description
Dry Run Dry run validates user permissions and inputs without completing the EC2 action (true or false).
Image ID The ID of the AMI.
Minimum Instance Count The minimum number of instances to launch.
Maximum Instance Count The maximum number of instances to launch.
Key Name The name of the key pair.
Security Groups One or more security group names, separated by commas.
Security Group IDs One or more security group IDs, separated by commas.
User Data The Base64-encoded MIME user data for the instances.
Instance Type The instance type.
Placement The placement for the instance.
Kernel ID The ID of the kernel.
Ramdisk ID The ID of the RAM disk.
Block Device Mapping The block device mapping.
Monitoring true or false. The monitoring for the instance.
Subnet ID The ID of the subnet to launch the instance into.
Disable API Termination true or false. If you set this parameter to true, you can't terminate the instance using the Amazon EC2 console.
Instance Initiated Shutdown Behavior Accepts 'stop' or 'terminate'. Indicates whether an instance stops or terminates when you initiate shutdown.
Private IP Address The primary IP address.
Client Token Unique, case-sensitive identifier you provide to ensure the idempotency of the request.
Network Interfaces One or more network interfaces.
IAM Instance Profile The IAM instance profile.
EBS Optimized true or false. Indicates whether the instance is optimized for EBS I/O.

Sample Configuration

Name Description
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


Name Description
Reservation ID Reservation of ID EC2 run instances.
Owner ID Owner ID of EC2 run instances.
Requester ID Requester ID of EC2 run instances.
Groups XLM Groups XLM of EC2 run instances.
Groups String Groups String of EC2 run instances.
Instances XML Instances XML of EC2 run instances.
Instances String Instances String of EC2 run instances.


AWS EC2 Run Instances V1 (2017-08-24)

  • Initial version. See README for details.

Related Handlers

AWS EC2 Attach Internet Gateway
Attaches an Internet gateway to a VPC, enabling connectivity between the Internet and the VPC.
AWS EC2 Create Internet Gateway
Creates an internet gateway
AWS EC2 Create Key Pair
Creates a 2048-bit RSA key pair with the specified name.
AWS EC2 Create Route Table
Creates a route table for the specified VPC.
AWS EC2 Create Security Group
This handler is used to create a security group in AWS.
AWS EC2 Create Tag
Creates a single tag against a single resource.
AWS EC2 Delete Internet Gateway
Deletes a VPC
AWS EC2 Delete Network Interface
Deletes the specified network interface. You must detach the network interface before you can delete it.
AWS EC2 Delete Route
Deletes the specified route from the specified route table.
AWS EC2 Delete Subnet
Deletes a specified subnet.
AWS EC2 Delete VPC
Deletes a VPC
AWS EC2 Describe Availability Zones
Returns a set of availability zones and details for each of those zones.
AWS EC2 Detach Internet Gateway
Detaches an Internet gateway from a VPC, disabling connectivity between the Internet and the VPC.
AWS EC2 Disassociate Route Table
Disassociates a subnet from a route table.
AWS EC2 Instance List
Retrieves list of machine instances attached to the AWS credentials supplied
AWS EC2 Instance Retrieve Status
Retrieves the status of a particular EC2 instance.
AWS EC2 Instance Start
This handler sends a start request to an AWS EC2 machine instance
AWS EC2 Revoke Security Group Ingress
Removes one or more ingress rules from a security group.