Create Key Pair

The Create Key Pair step is used to create an ED25519 or 2948 bit RSA key pair with a specified name for an EC2 instance.

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

Outputs

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

The Keypair Already Exists

If a Key Pair has already been created with the inputted key name, the step will cause an error.

To correct this, change the Key Name to be unique.

Exception Message:

DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Create Key Pair 1[CreateKeyPair] in flow [Step Library Flow]: Exception invoking method CreateKeyPair on class AmazonEC2Core
 ---> DecisionsFramework.LoggedException: Exception invoking method CreateKeyPair on class AmazonEC2Core
 ---> Amazon.EC2.AmazonEC2Exception: The keypair already exists
 ---> 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 ---