Amazon S3
Amazon S3アクションでは、ファイルのアップロードとダウンロードを行なえます。
Amazon S3のデータソースに接続する
1. 右上のメニューから「データソース」を選択する
2. 「データソースの追加」をクリックする
3. データソースの種類の中から「Amazon S3」を選択する
4. データソースへの接続に必要な情報を入力して保存する
IAMユーザーの作成
上記の 4
のステップでは、Amazon S3の操作に必要な認証情報を登録します。
AWSのコンソール上でIAMユーザーを作成しアクセスキーを発行したうえで、そのアクセスキーとシークレットキーを登録してください。
アクセスキー発行の詳しい方法については、IAM ユーザーのアクセスキーの管理 (opens in a new tab)をご参照ください。
必要なポリシーの割り当て
IAMユーザーには、アクションで行ないたい操作によって、下記の権限を持ったIAMポリシーを割り当てる必要があります。
- 書き込み(PutObject): アップロードを行なう場合
- 読み込み(GetObject): ダウンロードを行なう場合
IAMポリシーの詳しい作成方法に関しては、IAM でのポリシーとアクセス許可 (opens in a new tab)をご参照ください。
Amazon S3をアクションで利用する
1. 右上のメニューから「アクション」を選択する
2. 「アクションの追加」をクリックする
3. アクション名やパラメーターを設定する
アップロード
- アクションパラメーターを設定します
- ファイルパラメーターを 必須 にします
- またアップロードするファイル名を指定するためにファイル名を入力するためのテキストパラメーターも必須にします
- バケット名を
test-bucket
のように設定します - 実行メソッドを「アップロード」に設定します
- オブジェクト名(オブジェクトキー)を
images/{{ ファイル名 }}
のように設定します- アップロードされるファイルのオブジェクト名となります
- ファイル内容に使うパラメーターを1で作成したファイルパラメーターに設定します
アクション実行画面でパラメーターとしてファイル名を test.png
と設定し実行した場合は下記にアップロードされます。
s3://test-bucket/images/test.png
ダウンロード
- アクションパラメーターを設定します
- ダウンロードするファイル名を指定するためのテキストパラメーターを必須にします
- バケット名を
test-bucket
のように設定します - 実行メソッドを「ダウンロード」に設定します
- オブジェクト名(オブジェクトキー)を
images/{{ ファイル名 }}
のように設定します- ダウンロードされるファイルのオブジェクト名となります
アクション実行画面でパラメーターとしてファイル名を test.png
と設定し実行した場合は下記のファイルがダウンロードされます。
s3://test-bucket/images/test.png
オブジェクトの一覧
- バケット名を入力します。
- 実行メソッドで「オブジェクトの一覧」を選択します。
- 必要に応じてオブジェクト名(オブジェクトキー)を入力します。
- 保存します。
設定したアクションを実行すると、オブジェクトの一覧を取得できます。
指定したオブジェクト名(オブジェクトキー)は、一覧取得時の接頭辞による絞り込みに使われます。
実行結果の形式
下記の形式のオブジェクトを含んだ配列を返します。
キー名 | 説明 |
---|---|
objectKey | オブジェクト名(オブジェクトキー) |
lastModified | ファイルの更新日時のUnixTimestamp (秒) |
size | ファイルのバイトサイズ |
署名付きURLの発行
- バケット名を入力します。
- 実行メソッドで「署名付きURLの発行」を選択します。
- オブジェクト名(オブジェクトキー)を入力します。
- HTTPメソッドを「GET」または「PUT」から選択します。
- 保存します。
設定したアクションを実行すると、署名付きURLが発行されます。
実行結果の形式
下記の形式のオブジェクトを返します。
キー名 | 説明 |
---|---|
signedUrl | 発行した署名付きURL |
便利な使い方
「バケット名」と「オブジェクト名(オブジェクトキー)」では、アクションのパラメーターのほかに、変数・シークレットと事前定義パラメーターをご利用いただくことができます。環境に応じて値を変更したい場合などにご利用ください。
書式については変数・シークレットの使用方法をご覧ください。