List Instances

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

The List Instances step is used to return a list of currently running EC2 instances.

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
Region	The Amazon AWS region the instance is associated with.	AmazonAWSRegion

Outputs

Property	Description	Data Type
Done	List of Instances and their details outputted.	List of EC2RunningInstance

Example Inputs and Outputs

Input	Output Label	Output
us-east-1	Name	newInstance
	InstanceId	i-06724ed110862fdbb
	PublicIP	null
	PrivateIP	ip-172-31-70-122.ec2.internal
	KeyPair	Keypair_1
	Zone	us-east-1f
	ImageId	ami-033594f8862b03bb2
	StartedOn	8/15/2024 11:44:11 AM
	Arch	x86_64
	State	stopped
	Tags	null
	SecurityGroup	launch-wizard-2
	InstanceType	t3.2xlarge
	NetworkInterfaceId	eni-05c049780f39f6c67

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

No Such Host is Known.

If the Region defined in inputs is invalid, the step will cause an error.

To correct this, input a valid region in the step properties.

Exception Message:

DecisionsFramework.Design.Flow.ErrorRunningFlowStep: Error running step Get Network Interfaces By Region 1[GetNetworkInterfacesByRegion] in flow [Step Library Flow]: Exception invoking method GetNetworkInterfacesByRegion on class AmazonEC2Core
 ---> DecisionsFramework.LoggedException: Exception invoking method GetNetworkInterfacesByRegion on class AmazonEC2Core
 ---> System.Net.Http.HttpRequestException: No such host is known. (ec2.u.amazonaws.com:443)
 ---> System.Net.Sockets.SocketException (11001): No such host is known. at System.Net.Sockets.Socket.AwaitableSocketAsyncEventArgs.System.Threading.Tasks.Sources.IValueTaskSource.GetResult(Int16 token)
 at System.Net.Sockets.Socket.<ConnectAsync>g__WaitForConnectWithCancellation|285_0(AwaitableSocketAsyncEventArgs saea, ValueTask connectTask, CancellationToken cancellationToken)
 at System.Net.Http.HttpConnectionPool.ConnectToTcpHostAsync(String host, Int32 port, HttpRequestMessage initialRequest, Boolean async, CancellationToken cancellationToken)
   --- End of inner exception stack trace ---

Related Information

EC2

AWS