【公式】[Amazon EC2]インスタンス起動

オペレーション名

インスタンス起動

機能概要

Amazon EC2のインスタンスを起動します。

プロパティ

= 備考 =

変数の使用については、「変数」を参照してください。

基本設定

項目名	必須/省略可	変数の使用	説明	備考
名前	必須	使用不可	スクリプトキャンバス上での名前を入力します。

必須設定

項目名	必須/省略可	変数の使用	説明	備考
接続先	必須	使用不可	コネクションリソースを選択します。 [追加] 新規にコネクションリソースを追加します。 [一覧の編集] > HULFT INTEGRATE > コネクションで、コネクションリソースの設定を編集することができます。
インスタンス一覧	必須	使用可	起動するインスタンスのインスタンスIDとElastic IP アドレスを複数指定します。各インスタンスは以下のボタンで操作することができます。 [上へ] 選択しているインスタンスの順序を一つ上に上げます。 [下へ] 選択しているインスタンスの順序を一つ下に下げます。 [追加] インスタンスを追加します。 [削除] インスタンスを削除します。
インスタンス一覧/インスタンスID (名前)	必須	使用可	起動するインスタンスのインスタンスIDを指定します。	一覧には「インスタンスID (Nameタグの値)」と表示されます。 Nameタグがない場合は「インスタンスID」と表示されます。インスタンスIDのみを直接入力で指定することも可能です。
インスタンス一覧/Elastic IP アドレス	省略可	使用可	インスタンスを起動したあとに割り当てるElastic IP アドレスを指定します。 [(指定しない)]を選択した場合、Elastic IP アドレスの割り当て処理は行いません。	[起動完了を待機]にチェックを入れた場合、有効になります。省略した場合、Elastic IP アドレスの割り当て処理は行いません。詳細については、「Elastic IP アドレスの割り当て処理について」を参照してください。
起動完了を待機	必須	使用可	[チェックあり] (デフォルト) インスタンスが起動完了するまで処理を待機します。 [チェックなし] インスタンスに起動要求を送信すると待機せず後続の処理に進みます。	[チェックあり]の場合、処理開始から[接続先]で指定したコネクションリソースの[タイムアウト]に入力した値までインスタンスの状態を確認し続けます。インスタンスの起動完了を確認すると、後続の処理に進みます。 [タイムアウト]に入力したミリ秒までにインスタンスの起動完了を確認できない場合、エラーになります。

プロパティアクション

項目名	説明	補足
インスタンス一覧を取得	[接続先]に作成しているインスタンスIDとElastic IP アドレスを取得し、[インスタンス一覧/インスタンスID (名前)]と[インスタンス一覧/Elastic IP アドレス]から選択できるようにします。	注意以下のインスタンスのインスタンスIDは取得されません。スポットインスタンスルートデバイスタイプが「instance-store」のインスタンス状態が「shutting-down」または「terminated」のインスタンス

項目名	必須/省略可	変数の使用	説明	備考
コメント	省略可	使用不可	このコネクターの簡単な説明を記述することができます。

スキーマ

入力スキーマ

ありません。

出力スキーマ

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

要素名	属性名	説明
instances
instance		起動したインスタンスごとに出現します。
	currentInstanceState	現在のインスタンスの状態を出力します。 [running] インスタンスが起動している状態です。 [pending] インスタンスが起動処理を行っている状態です。 [stopping] インスタンスが停止処理を行っている状態です。 [stopped] インスタンスが停止している状態です。 [shutting-down] インスタンスが終了処理を行っている状態です。 [terminated] インスタンスが終了している状態です。
	instanceId	インスタンスIDを出力します。
	previousInstanceState	直前のインスタンスの状態を出力します。 [running] インスタンスが起動している状態です。 [pending] インスタンスが起動処理を行っている状態です。 [stopping] インスタンスが停止処理を行っている状態です。 [stopped] インスタンスが停止している状態です。 [shutting-down] インスタンスが終了処理を行っている状態です。 [terminated] インスタンスが終了している状態です。

大容量データ処理

大容量データ処理に対応していません。

トランザクション

トランザクションはサポートしていません。

PSPでの使用について

PSPでは使用できません。

使用できるコンポーネント変数

コンポーネント変数名	説明	備考
error_code	エラー(AmazonServiceException)発生時、発生したエラーに対応する Amazon Web Servicesのエラーコードが格納されます。	デフォルト値はnullです。
status_code	エラー(AmazonServiceException)発生時、通信時のHTTPステータスコードが格納されます。	デフォルト値はnullです。
message_category	エラー発生時、発生したエラーに対応するメッセージコードのカテゴリが格納されます。	デフォルト値はnullです。
message_code	エラー発生時、発生したエラーに対応するメッセージコードのコードが格納されます。	デフォルト値はnullです。
message_level	エラー発生時、発生したエラーに対応するメッセージコードの重要度が格納されます。	デフォルト値はnullです。
error_type	エラー発生時、発生したエラーの種類が格納されます。	デフォルト値はnullです。エラーの種類は、以下のような形式となります。例:「java.io.FileNotFoundException」
error_message	エラー発生時、発生したエラーのメッセージが格納されます。	デフォルト値はnullです。
error_trace	エラー発生時、発生したエラーのトレース情報が格納されます。	デフォルト値はnullです。

Elastic IP アドレスの割り当て処理について

Elastic IP アドレスの割り当て処理は、インスタンスの起動完了を待機後に行います。
指定したインスタンスがすでに起動している場合、起動処理は行われませんが、Elastic IP アドレスを指定していればElastic IP アドレスの割り当て処理は行います。
VPCにあるインスタンスの場合
- スコープが「standard」のIP アドレスを指定すると、Elastic IP アドレスの割り当て処理でエラーが発生します。
- ほかのインスタンスに割り当てられているElastic IP アドレスを指定すると、Elastic IP アドレスの割り当て処理でエラーが発生します。
- すでにElastic IP アドレスが割り当てられているインスタンスに対して異なるElastic IP アドレスを指定すると、Elastic IP アドレスの割り当て処理でエラーが発生します。
VPCにはないインスタンスの場合
- スコープが「vpc」のIP アドレスを指定すると、Elastic IP アドレスの割り当て処理でエラーが発生します。
- ほかのインスタンスに割り当てられているElastic IP アドレスを指定すると、ほかのインスタンスに割り当てられているElastic IP アドレスは解除され、指定したインスタンスに割り当てられます。

メッセージコード、例外メッセージ、制限事項

コネクター	メッセージコード	例外メッセージ	制限事項
Amazon EC2 コネクターのメッセージおよび制限事項

インスタンス起動処理