Official |[Amazon EC2] Start Instances

Operation name

Start Instances

Function overview

Starts instances of Amazon EC2.

Properties

= Remarks =

For details on use of variables, refer to Variables.

Basic settings

Item name	Required/Optional	Use of variables	Description	Remarks
Name	Required	Not available	Enter a name that is used on the script canvas.

Required settings

Item name	Required/Optional	Use of variables	Description	Remarks
Destination	Required	Not available	Select a connection resource. Add A new connection resource can be added. Edit list Connection resource settings can be edited in > HULFT INTEGRATE > Connections.
Instance list	Required	Available	Specify Elastic IP addresses and instance IDs of instances to be started. Each instance can be operated with the following buttons: Up Move the selected instance upwards by one row. Down Move the selected instance downwards by one row. Add Add an instance. Delete Delete the instance.
Instance list/Instance ID (Name)	Required	Available	Specify an instance ID of instance to be started.	It's displayed as "Instance ID (Name tag value)" in the list. When there's no Name tag, it's displayed as "Instance ID". You can enter only the instance ID directly.
Instance list/Elastic IP address	Optional	Available	Specify an Elastic IP address to associate after starting the instance. If (Not specified) is selected, association of Elastic IP address won't be performed.	Enabled when Wait for start completion is selected. When omitted, association of Elastic IP address won't be performed. For details, refer to Association of Elastic IP address.
Wait for start completion	Required	Available	Selected (Default) Wait for the instance to complete starting. Not selected Proceed to the subsequent operation without waiting after a start request is sent to the instance.	When this is selected, checking the instance status will be continued from the start of process till the value entered in Timeout of the connection resource specified in Destination. After confirming that the instance has started, proceed to the subsequent process. If completion of starting the instance can't be confirmed within the milliseconds given in Timeout, it will be an error.

Property actions

Item name	Description	Remarks
Get instance list	Get instance IDs and Elastic IP addresses created in Destination so that you can select them in Instance list/Instance ID (Name) and Instance list/Elastic IP address.	Note IDs of the following instances won't be gotten: Spot instance Instance whose root device type is "instance-store" Instance whose state is "shutting-down" or "terminated"

Comment

Item name	Required/Optional	Use of variables	Description	Remarks
Comment	Optional	Not available	You can write a short description of this connector.

Schemas

Input schema

None.

Output schema

<?xml version="1.0"?>
<instances>
  <instance currentInstanceState="" instanceId="" previousInstanceState="" />
</instances>

Element name	Attribute name	Description
instances
instance		Appears once for each started instance.
	currentInstanceState	Outputs the current instance state. running The instance is running. pending The instance is starting up. stopping The instance is stopping. stopped The instance is stopped. shutting-down The instance is shutting down. terminated The instance is terminated.
	instanceId	Outputs the instance ID.
	previousInstanceState	Outputs the previous instance state. running The instance is running. pending The instance is starting up. stopping The instance is stopping. stopped The instance is stopped. shutting-down The instance is shutting down. terminated The instance is terminated.

Mass data processing

Mass data processing isn't supported.

Transaction

Transaction isn't supported.

Parallel Stream Processing

PSP isn't supported.

Available component variables

Component variable name	Description	Remarks
error_code	When an error (AmazonServiceException) occurs, the error code of Amazon Web Services corresponding to the error is stored.	The default value is null.
status_code	When an error (AmazonServiceException) occurs, the HTTP status code is stored.	The default value is null.
message_category	When an error occurs, the category of the message code corresponding to the error is stored.	The default value is null.
message_code	When an error occurs, the code of the message code corresponding to the error is stored.	The default value is null.
message_level	When an error occurs, the severity of the message code corresponding to the error is stored.	The default value is null.
error_type	When an error occurs, the error type is stored.	The default value is null. The format of the error type is as follows. Example: java.io.FileNotFoundException
error_message	When an error occurs, the error message is stored.	The default value is null.
error_trace	When an error occurs, the trace information for the error is stored.	The default value is null.

Association of Elastic IP address

Association of Elastic IP address is performed after waiting for an instance to complete starting.
When the specified instance has already been started, the starting process won't be performed, but if Elastic IP address is specified, association of Elastic IP address will be performed.
When the instance is in VPC
- If an IP address with the scope "standard" is specified, an error occurs in association of Elastic IP address.
- If an Elastic IP address associated to another instance is specified, an error occurs in association of Elastic IP address.
- If a different Elastic IP address is specified for the instance where one has already been associated, an error occurs in association of Elastic IP address.
When the instance isn't in VPC
- If an IP address with scope "vpc" is specified, an error occurs in association of Elastic IP address.
- If an Elastic IP address associated with another instance is specified, it will be removed from the instance and associated to the specified instance.

Message codes, exception messages, and limitations

Connector	Message code	Exception message	Limitations
Messages and limitations of the Amazon EC2 connector