AWS S3Download - AWS S3からファイル・フォルダーをダウンロード
Amazon Web ServicesのS3からファイル・フォルダーをダウンロードします
ダウンロードするファイルと同じ名前のファイルがすでに存在していた場合は上書きされます。
■ストリーム情報
| 入力 | フォーマット | すべて |
|---|---|---|
| 接続数 | 1 | |
| 説明 | 入力ストリームは使用せず、すべて無視します。 | |
| 出力 | フォーマット | すべて |
| 説明 | 入力ストリームをそのまま出力します。 |
■コンポーネントプロパティ
| 名前 | プロパティ型 | マッピング | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| コネクションを使用 | boolean | - |
接続情報に以下のコネクション名を使用するかどうか選択します。
|
||||||
| コネクション名 | connection | - | コネクションを使用が「はい」の場合に接続先のAWSを指定します。 コネクションペインまたは管理コンソールにて作成されたAWS接続名を選択します。 | ||||||
| コネクション情報 | group | - | コネクションを使用が「いいえ」の場合に使用されるプロパティ群です。 | ||||||
| アクセスキー | string | - |
アクセスキーを指定します。
コネクションを使用が「いいえ」の場合、この設定を参照します。 |
||||||
| シークレットキー | password | - |
シークレットキーを指定します。
コネクションを使用が「いいえ」の場合、この設定を参照します。 |
||||||
| プロトコル | choice | - |
通信にHTTPまたはHTTPSであるかを指定します。
コネクションを使用が「いいえ」の場合、この設定を参照します。
|
||||||
| リージョン | choice | - |
利用するAWSのリージョンを選択します。
選択肢にない場合はリージョンを表す文字列を入力することもできます。 例えば東京リージョンであれば ap-northeast-1を指定します。 コネクションを使用が「いいえ」の場合、この設定を参照します。 |
||||||
| タイムアウト(秒) | int | - |
リクエスト時およびコネクション接続時のタイムアウトまでの時間を秒単位で指定します。
コネクションを使用が「いいえ」の場合、この設定を参照します。 |
||||||
| プロキシ設定を使用 | boolean | - |
管理コンソールで設定したプロキシ設定を使用するかどうかを指定します。
コネクションを使用が「いいえ」の場合、この設定を参照します。
|
||||||
| バケット名 | string | 入力＆出力 | ダウンロード元のバケット名を指定します。 | ||||||
| オブジェクト名 | string | 入力＆出力 |
ダウンロード元のオブジェクト名を指定します。 指定しなかった場合はバケット名で指定したバケット内のすべてのファイル・フォルダーをダウンロードします。 オブジェクト名としてフォルダーが指定された場合は、そのフォルダーの中のすべてのファイル、フォルダーをダウンロードします。 |
||||||
| 保存先ファイルパス | remoteFile | 入力＆出力 |
ダウンロードしたファイルを保存するファイル、フォルダーのパスを指定します。 UNIXシステムの場合は、パス名は接頭辞が "/" の場合に絶対パスとみなします。Windowsシステムの場合は、パス名は接頭辞がドライブ指示子のあとに "\\" が続く場合、または接頭辞が "\\" の場合に絶対パスとみなします。 相対パスで指定した場合は、相対パスの起点で指定したホームからの相対になります。 |
||||||
| ファイルパスの詳細設定 | group | - | ファイルパスの詳細設定を行うプロパティ群です。 | ||||||
| 相対パスの起点 | pathResolver | - |
相対パス指定の場合にベースフォルダーを指定します。
|
||||||
| 絶対パスを許可 | boolean | - | 絶対パスを許可するかどうか選択します。 | ||||||
| 「..」を許可 | boolean | - | 上のフォルダへ移動する記述に「..」を許可するかどうか選択します。 |
■ループ処理
なし。
■トランザクション処理
| コミット | 何もしません。 |
|---|---|
| ロールバック | 何もしません。 |
■エラー処理
| タイプ | パラ メータ | エラー処理フロー へのストリーム | エラー コード | 説明 |
|---|---|---|---|---|
| 汎用 | なし | コンポーネントの入力ストリーム | 1 | コネクションの定義項目に不正な値があった場合 |
| 3 | ファイルのダウンロードに失敗した場合 | |||
| 1001 | APIクライアントの初期化に失敗した場合 | |||
| APIエラー | 「APIエラーの パラメーター」を 参照してください。 | コンポーネントの入力ストリーム | 201 | APIの実行でエラーコードを受け取った場合。 |
| 接続エラー | なし | コンポーネントの入力ストリーム | 301 | 接続に失敗した場合。 com.amazonaws.AmazonClientExceptionが発生した場合が該当します。 |
| ダウンロード先が既に存在する | なし | コンポーネントの入力ストリーム | 2 | オブジェクト名がフォルダーでダウンロード先に既に同名のファイルが存在していた場合 |
■APIエラーのパラメーター
APIエラーが発生したときに設定されるエラーのパラメーターです。
| No. | 名前 | 説明 |
|---|---|---|
| 1 | Code | AWSから取得したエラーコード。エラーの詳細につきましては、AWSのサイトを参照ください。 |
| 2 | Message | AWSから取得したエラーの内容。エラーの詳細につきましては、AWSのサイトを参照ください。 |
■フローの強制終了
フローを強制終了すると、通常は実行中のコンポーネントの処理が終了してから次のコンポーネントに制御が遷移する時点でフローがアボートしますが、本コンポーネントでは実行中の処理を強制的に終了してフローがアボートします。
■バケット名とオブジェクト名の設定画面
コンポーネントをダブルクリックするか、右クリックメニューの「StorageBrowser」を実行することで、コンポーネントに設定されている接続情報を使用して画面が開きます。
この画面ではバケット名とオブジェクト名の設定とバケットの新規作成、そしてバケットとオブジェクトの削除を行うことができます。
「バケット」ツリーリスト
バケットとオブジェクトのツリーリストが表示されます。
このリストの中からコンポーネント設定するバケットとオブジェクトを選択します。
＊接続に使用した情報とバケットに設定されているリージョンの情報が一致しないとオブジェクトが見えないことがあります。
＊バケットに「.」が使用されている場合に、接続に使用した情報が「HTTPS」で接続するように指定されているとオブジェクトが見えないことがあります。
バケット名
選択したバケットの値が表示されます。
オブジェクト名
選択したオブジェクトの値が表示されます。
「バケットを作成」ボタン
バケットを作成するためのダイアログが表示されます。
「バケットを削除」ボタン
一覧で選択されているバケットをS３から削除します。
「オブジェクトを削除」ボタン
一覧で選択されているオブジェクトをS３から削除します。
属性情報
選択されているバケットまたはオブジェクトの属性情報が表示されます。
「OK」ボタン
リストで選択されたバケットとオブジェクトの情報をコンポーネントのバケット名とオブジェクト名プロパティに設定します。
「キャンセル」ボタン
このダイアログを閉じます。
コンポーネントのバケット名とオブジェクト名プロパティに変更はありません。