Storage API
Avgidea Storage に対して API 経由でファイルの操作(アップロードやダウンロードなど)を実行できます。
共通パラメータ
% curl -X POST -H 'content-type: application/json' -d '{"accesskey":"<accesskey>", "secret":"secretkey", "component":"storage", "action":"<action>" ... }' https://<endpoint url>
パラメータ
accesskey : アクセスキー
secet:シークレットキー
component : storage
action : 実行するアクション
endpoint url : API リクエスト送信先 URL
ファイルのアップロード
ファイルのアップロードには、下記の2つのステップを実行が必要です。
アップロード用のリファレンスを生成
ローカル環境上のファイルをアップロード
1. アップロード用のリファレンスを生成
% curl -X POST -H 'content-type: application/json' -d '{"accesskey":"<accesskey>", "secret":"secretkey", "component":"storage", "action":"putref", "datasource":"ds1", "obj":"data.csv"}' https://<endpoint url>
{"data":"https://<upload url>","status":"success"}
パラメータ
action : putref
datasource : Avgidea Storage のデータソース名
obj : アップロードするオブジェクト名
戻り値
data : オブジェクトのアップロード先 URL
2. ローカル環境上のファイルをアップロード
% curl -X PUT --upload-file ./data.csv https://<upload url>
パラメータ
upload-file : ローカル環境上のファイル名
upload url : オブジェクトのアップロード先 URL
ファイルのダウンロード
ファイルのダウンロードには、下記の2つのステップを実行が必要です。
ダウンロード用のリファレンスを生成
ローカル環境にファイルをダウンロード
1. ダウンロード用のリファレンスを生成
% curl -X POST -H 'content-type: application/json' -d '{"accesskey":"<accesskey>", "secret":"secretkey", "component":"storage", "action":"getref", "datasource":"ds1", "obj":"data.csv"}' https://<endpoint url>
{"data":"https://<download url>","status":"success"}
パラメータ
action : getref
datasource : Avgidea Storage のデータソース名
obj : ダウンロードするオブジェクト名
戻り値
data : オブジェクトのダウンロード元 URL
2. ローカル環境にファイルをダウンロード
% curl -X GET -o ./data.csv https://<download url>
パラメータ
download url : オブジェクトのダウンロード元 URL