Create Instances

Step Details
Introduced in Version	3.0.0
Last Modified in Version	7.0.0
Location	Integration > Amazon AWS > EC2

The Create Instances step is used to create a defined number of EC2 instances in AWS.

Prerequisites

This step requires the Amazon AWS Module to be installed before it will be available in the toolbox, and an active AWS account. The Amazon WebServices Settings must also be configured.
A dependency must be created after installing the module in order for the the steps to be properly used.

Properties

Inputs

Property	Description	Data Type
Image Id	ID of image to be used for the instance.	String
Instance type	Name of an instance type as provided by EC2. (Ex: t3.micro)	AmazonEC2InstanceType
Key Name	Name of a previously created key pair enabling a secure connection to the instance.	String
Network Interface Id	ID of the network to place the instance under.	String
Number of Servers To Launch	Specifies amount of servers to create.	Int32
Owner Name	Name of the intended owner of the instance.	String
Region	The Amazon AWS region the instance will be associated with.	AmazonAWSRegion
Security Group	Security group to associate with the instance.	String
Servers Name	Names of the servers to create.	String
Subnet Id	ID of the subnet in which the network interface is located.	String
User Data	Data defined to automate common tasks such as installing software.	String
Uses Security Group Ids	Toggle permitting the option to use security Ids.	Boolean

Outputs

Property	Description	Data Type
Done	Outputs completed step information.	List of String

Common Errors

AWS Was Not Able To Validate the Provided Access Credentials.

If the access credentials established in system settings are invalid, the step will cause an error.

To correct this, ensure the Access Key Id and Secret Access Key are both correct and active.

Exception Message:

Exception Stack Trace: DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Substring 1[Substring] in flow [Display Steps]: Exception invoking method Substring on class StringSteps 
 ---> DecisionsFramework.LoggedException: Exception invoking method Substring on class StringSteps 
 ---> System.ArgumentOutOfRangeException: Index and length must refer to a location within the string. (Parameter 'length')  
   at System.String.Substring(Int32 startIndex, Int32 length)       
   --- End of inner exception stack trace ---  
   at DecisionsFramework.Design.Flow.StepImplementations.InvokeMethodStep.Run(StepStartData data  at DecisionsFramework.Design.Flow.FlowStep.RunStepInternal(String flowTrackingID, String stepTrackingID, KeyValuePairDataStructure[] stepRunDataValues, AbstractFlowTrackingData trackingData)  
   at DecisionsFramework.Design.Flow.FlowStep.Start(String flowTrackingID, String stepTrackingID, FlowStateData data, AbstractFlowTrackingData trackingData, RunningStepData currentStepData)       
   --- End of inner exception stack trace ---

Incorrect or Missing Id

If there is a mandatory Id required for the step to run successfully that is missing or invalid, the step will cause an error.

To correct this, ensure all mandatory fields are properly filled out and are valid.

Mandatory fields include inputs such as: Key Name, Network Interface Id, Region, and Server Name.

Exception Message:

DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Create Instance 1[CreateInstance] in flow [Step Flows]: Exception invoking method CreateInstance on class AmazonEC2Core
 ---> DecisionsFramework.LoggedException: Exception invoking method CreateInstance on class AmazonEC2Core
 ---> Amazon.EC2.AmazonEC2Exception: Invalid id: "vpc-05cfd87c13032cfce" (expecting "eni-...")
 ---> Amazon.Runtime.Internal.HttpErrorResponseException: Exception of type 'Amazon.Runtime.Internal.HttpErrorResponseException' was thrown. at Amazon.Runtime.HttpWebRequestMessage.ProcessHttpResponseMessage(HttpResponseMessage responseMessage)
 at Amazon.Runtime.HttpWebRequestMessage.GetResponseAsync(CancellationToken cancellationToken)
 at Amazon.Runtime.Internal.HttpHandler`1.InvokeAsync[T](IExecutionContext executionContext)
 at Amazon.Runtime.Internal.Unmarshaller.InvokeAsync[T](IExecutionContext executionContext)
 at Amazon.EC2.Internal.AmazonEC2ResponseHandler.InvokeAsync[T](IExecutionContext executionContext)
 at Amazon.Runtime.Internal.ErrorHandler.InvokeAsync[T](IExecutionContext executionContext)
   --- End of inner exception stack trace ---

Related Information

EC2

AWS