AWS EC2TerminateInstance - EC2のインスタンスを終了します
Amazon Web ServicesのElastic Compute Cloudのインスタンスを終了します。
■ストリーム情報
| 入力 | フォーマット | すべて |
|---|---|---|
| 接続数 | 1 | |
| 説明 |
ストリームのフォーマットがRecordで「InstanceId」というフィールド名を設定した場合には、そのフィールドの値のインスタンスをまとめて終了することができます。 プロパティインスタンスID も確認してください。 それ以外の入力ストリームは無視します。 |
|
| 出力 | フォーマット | すべて |
| 説明 | 入力ストリームをそのまま出力します。 |
■コンポーネントプロパティ
| 名前 | プロパティ型 | マッピング | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| コネクションを使用 | boolean | - |
接続情報に以下のコネクション名 を使用するかどうか選択します。
|
||||||
| コネクション名 | connection | - | コネクションを使用 が「はい」の場合に接続先のAWSを指定します。 コネクションペインまたは管理コンソールにて作成されたAWS接続名を選択します。 | ||||||
| コネクション情報 | group | - | コネクションを使用 が「いいえ」の場合に使用されるプロパティ群です。 | ||||||
| アクセスキー | string | 入力＆出力 |
アクセスキーを指定します。
サーバーがEC2インスタンス上にあり、アクセスキーを指定しない場合は、EC2インスタンスに設定されたIAMロールを使用します。 コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| シークレットキー | password | 入力＆出力 |
シークレットキーを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| プロトコル | choice | 入力＆出力 |
通信にHTTPまたはHTTPSであるかを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
|
||||||
| タイムアウト(秒) | int | 入力＆出力 |
リクエスト時およびコネクション接続時のソケットタイムアウト時間を秒単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| リクエストタイムアウト(分) | int | 入力＆出力 |
1回のリクエスト実行のタイムアウトまでの時間を分単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| リージョン | choice | 入力＆出力 |
利用するAWSのリージョンを選択します。
選択肢にない場合はリージョンを表す文字列を入力することもできます。 例えば東京リージョンであれば ap-northeast-1を指定します。 コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| AssumeRole ARN | string | 入力＆出力 |
一時的な認証情報を使用するためにAssumeRoleのARNを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| 一時的認証情報の有効期限(秒) | int | 入力＆出力 |
AssumeRole ARNで設定する一時的な認証情報の有効期限を秒単位で指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。 |
||||||
| プロキシ設定を使用 | boolean | 入力＆出力 |
管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。
コネクションを使用 が「いいえ」の場合、この設定を参照します。
|
||||||
| インスタンスID | string | 入力＆出力 |
終了したいEC2インスタンスのインスタンスIDを指定します。 ストリームでインスタンスIDを指定する場合はプロパティで指定する必要はありません。 両方で指定されていた場合は、ストリームとプロパティの両方の値が使用されます。 |
■トランザクション処理
| コミット | 何もしません。 |
|---|---|
| ロールバック | 何もしません。 |
■エラー処理
| タイプ | パラメーター | エラー処理フロー へのストリーム | エラー コード | 説明 |
|---|---|---|---|---|
| 汎用 | なし | コンポーネントの入力ストリーム | 1 | コネクションの定義項目に不正な値があった場合 |
| 2 | 入力ストリーム、もしくはインスタンスID にインスタンスIDが1個も指定されていなかった場合 | |||
| 1001 | APIクライアントの初期化に失敗した場合 | |||
| 2001 | ストリーム情報の取得に失敗した場合 | |||
| APIエラー | 「APIエラーの パラメーター」を 参照してください。 | コンポーネントの入力ストリーム | 202 | 認証に失敗した場合。 APIの実行でエラーコードAuthFailureを受け取った場合が該当します。 |
| 203 | APIを実行する権限がない場合。 APIの実行でエラーコードUnauthorizedOperationを受け取った場合が該当します。 |
|||
| 213 | 指定したインスタンスIDが不正な値だった場合。 APIの実行でエラーコードInvalidInstanceID.Malformedを受け取った場合が該当します。 |
|||
| 214 | 指定したインスタンスIDのインスタンスが存在しなかった場合。 APIの実行でエラーコードInvalidInstanceID.NotFoundを受け取った場合が該当します。 |
|||
| 215 | 指定したインスタンスが終了できる状態ではなかった場合。 APIの実行でエラーコードIncorrectInstanceStateを受け取った場合が該当します。 |
|||
| 216 | 指定したインスタンスの"Termination Protection"が"enabled"だった場合。 APIの実行でエラーコードOperationNotPermittedを受け取った場合が該当します。 |
|||
| 201 | APIの実行で上記以外のエラーコードを受け取った場合。 | |||
| 接続エラー | なし | コンポーネントの入力ストリーム | 301 | 接続に失敗した場合。 |
■APIエラーのパラメーター
APIエラーが発生したときに設定されるエラーのパラメーターです。
| No. | 名前 | 説明 |
|---|---|---|
| 1 | Code | AWSから取得したエラーコード。エラーの詳細につきましては、AWSのサイトを参照ください。 |
| 2 | Message | AWSから取得したエラーの内容。エラーの詳細につきましては、AWSのサイトを参照ください。 |