Start Instances

Operation Name

Start Instances

Function Overview

Start instances of Amazon EC2.

Properties

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 the name to show on the script canvas.

Required settings

Item name	Required/Optional	Use of variables	Description	Remarks
Destination	Required	Not available	Select a global resource. [Add]: Add a new global resource. [Edit list]: Global resource settings can be edited in “Edit resource list” screen.
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. [Add]: Add an instance. [Up]: Move the selected instance upwards by one row. [Down]: Move the selected instance downwards by one row. [Delete]: Delete the instance.
Instance list/Instance ID (Name)	Required	Available	Specify an instance ID of instance to be started.	It is displayed as “Instance ID (Name tag value)” in the list. When there is no Name tag, it is displayed as “Instance ID”. You can enter just 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 will not be performed.	Enabled when [Wait for start completion] is checked. When omitted, association of Elastic IP address will not be performed. For more details, refer to "Association of Elastic IP Address”.
Wait for start completion	Required	Available	[Checked]: (default) Wait for completion of starting the instance. [Not checked]: Proceed to the subsequent operation without waiting after a start request is sent to the instance.	When [Checked], checking the instance status will be continued from the start of process till the value entered in [Timeout] of the global resource specified in [Destination]. After confirming that the instance has started, proceed to the subsequent process. If completion of starting the instance could not 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].	ID of the following instances will not be got. Spot instance Instance of which the root device type is ”instance-store” Instance of which the 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 adapter. The description will be reflected in the specifications.

Schema

Input schema

None.

Output schema

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

Element name	Attribute name	Description
instances
instance		Appears for each started instance.
	currentInstanceState	Outputs the current instance state. [running]: State in which the instance is running. [pending]: State in which the instance is starting up. [stopping]: State in which the instance is stopping. [stopped]: State in which the instance is stopped. [shutting-down]: State in which the instance is shutting down. [terminated]: State in which the instance is terminated.
	instanceId	Outputs the instance ID.
	previousInstanceState	Outputs the previous instance state. [running]: State in which the instance is running. [pending]: State in which the instance is starting up. [stopping]: State in which the instance is stopping. [stopped]: State in which the instance is stopped. [shutting-down]: State in which the instance is shutting down. [terminated]: State in which the instance is terminated.

Mass Data Processing

Mass data processing is not supported.

Transaction

Transaction is not supported.

PSP Usage

PSP is not supported.

Available Component Variables

Component variable name	Description	Remarks
error_code	When an error (AmazonServiceException) occurs, the corresponding error code of Amazon Web Services is stored.	Default value is null.
status_code	When an error (AmazonServiceException) occurs, the HTTP status code is stored.	Default value is null.
message_category	When an error occurs, category of the corresponding message code is stored.	Default value is null.
message_code	When an error occurs, code of the corresponding message code is stored.	Default value is null.
message_level	When an error occurs, severity of the corresponding message code is stored.	Default value is null.
error_type	When an error occurs, the error type is stored.	Default value is null. The error type would be in the following format. Example: “java.io.FileNotFoundException” The contents that will be stored may vary depending on DataSpider Servista versions.
error_message	When an error occurs, the error message is stored.	Default value is null. The contents that will be stored may vary depending on DataSpider Servista versions.
error_trace	When an error occurs, trace information of the error is stored.	Default value is null. The contents that will be stored may vary depending on DataSpider Servista versions and client applications.

Association of Elastic IP Address

Association of Elastic IP address is performed after waiting for completion of starting an instance.

When the specified instance has been started already, while the starting process will not be performed, if Elastic IP address is specified, association of Elastic IP address will be performed.

When the instance is in VPC
- If an IP address of which the scope is "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 been associated already, an error occurs in association of Elastic IP address.
When the instance is not in VPC
- If an IP address of which scope is "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.

Specification Limits

When starting multiple instances, if failed to start any single instance failed and an error occurred, start requests will not be performed for other instances.

When “AmazonEC2OperationTimeoutException” occurred, the instance start request has been completed. Although it is a runtime error, the instance start operation will be performed.

Major Exceptions

Notes

HTTPS is used in communication between Amazon EC2 and this adapter.

Starts only instances of which state is “stopped”.

Starts only for instances of which the root device type is “ebs”.

Cannot start spot instances.

Exception name	Cause	Solution
ResourceNotFoundException Resource definition is not found. Name: []	[Destination] is not specified.	Specify [Destination].
ResourceNotFoundException Resource definition is not found. Name: [<global resource name>]	The resource definition selected in [Destination] is not found.	Check the global resource specified in [Destination].
InvalidPropertyConfigurationException <property name> is not specified.	[<property name>] is not specified.	Specify [<property name>].
AmazonEC2OperationTimeoutException Instance status has not been changed within <timeout> milliseconds.	After sending a start request, the starting instance is not completed within [Timeout] of the global resource specified in [Destination].	Check [Timeout] of the global resource specified in [Destination].
Status Code: 400, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: IncorrectInstanceState, AWS Error Message: The instance '<instance ID>' is not in a state from which it can be started.	The specified instance is not in a state from which it can be started.	Check the state of the specified instance.
Status Code: 400, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: InvalidInstanceID.Malformed, AWS Error Message: Invalid id: “<instance ID>”	The instance ID specified in [Instance list/Instance ID (Name)] is invalid.	Check the instance ID specified in [Instance list/Instance ID (Name)].
Status Code: 400, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: InvalidInstanceID.NotFound, AWS Error Message: The instance ID '<instance ID>' does not exist	The instance with the instance ID specified in [Instance list/Instance ID (Name)] does not exist.	Check the instance ID specified in [Instance list/Instance ID (Name)].
Status Code: 400, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: InvalidParameterValue, AWS Error Message: Invalid value '<IP address>' for PublicIp. Not a valid IPv4 address.	The IP address specified in [Instance list/Elastic IP address] is invalid.	Check the IP address specified in [Instance list/Elastic IP address].
Status Code: 400, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: AuthFailure, AWS Error Message: The address '<IP address>' does not belong to you.	The IP address specified in [Instance list/Elastic IP address] does not exist.	Check the IP address specified in [Instance list/Elastic IP address].
Status Code: 400, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: Resource.AlreadyAssociated, AWS Error Message: resource <Allocation ID> is already associated with associate-id <Association ID>	The IP address specified in [Instance list/Elastic IP address] is already associated to the instance in another VPC.	Check the IP address specified in [Instance list/Elastic IP address].
Status Code: 400, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: Resource.AlreadyAssociated, AWS Error Message: resource <instance ID> is already associated with public address <IP address>	The instance of the instance ID specified in [Instance list/Instance ID (Name)] is one in VPC and another IP address is already associated with that.	When associating another IP address to an instance in VPC, cancel it temporarily.
Status Code: 400, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: InvalidParameterCombination, AWS Error Message: You must specify an IP address when mapping to a non-VPC instance	The IP address specified in [Instance list/Elastic IP address] cannot be associated with an instance not in VPC.	Check the IP address specified in [Instance list/Elastic IP address].
Status Code: 400, AWS Request ID: XXXXXXXXXXXXXXXX, AWS Error Code: InvalidParameterCombination, AWS Error Message: You must specify an allocation id when mapping an address to a VPC instance	The IP address specified in [Instance list/Elastic IP address] cannot be associated with an instance in VPC.	Check the IP address specified in [Instance list/Elastic IP address].
com.amazonaws.AmazonClientException Unable to execute HTTP request: Connect to ec2.amazonaws.com/ec2.amazonaws.com/xxx.xxx.xxx.xxx timed out	Could not send a request to Amazon EC2, as the millisecond specified in [Timeout] has been elapsed.	Increase the millisecond of [Timeout], or check the connection status of the destination Amazon EC2.
com.amazonaws.AmazonClientException Unable to execute HTTP request: <endpoint>	There is something wrong with [Endpoint] of the global resource specified in [Destination].	Check the settings of the global resource specified in [Destination].