「デバイス側Path設定」 を利用する¶
本チュートリアルでは、 IoT Connect Gateway の 「デバイス側Path設定」 を利用する場合の設定・操作方法をご説明いたします。
「デバイス側Path設定」 機能の設定方法 (IoT Connect Gateway 側)¶
ストレージ新規作成ページ内で デバイス側Path設定 をONにします。自動でファイルパス欄がグレーアウトします。
- エントリーポイント
- Path
デバイス側で指定する IoT Connect Gateway への宛先となります。
＊を含めたPathを入力してください。
/test/*
詳細については、こちらの 「Path」設定 を参照ください。
- 宛先設定
- ファイルパス
デバイス側から指定するため IoT Connect Gateway では設定できません。
その他の項目の設定内容については、 こちら を参照ください。
また、プレースホルダの機能が利用できます。詳細については、 こちら を参照ください。
「デバイス側Path設定」 機能の操作方法 (デバイス側)¶
デバイス毎に操作方法は異なります。下記はあくまで一例として参考にしてください。
ファイルのアップロード
コマンド構成
curl \ -X PUT \ --data-binary \ "<ファイル名>" "http://<エントリーポイント>/<ファイルパス>/<ファイル名>"
コマンド例
- IoT Connect Gateway に以下の設定を行い、下記のコマンドを実行しています。
- バケット：sc-test
- ファイルパス：（設定なし）
curl -X PUT --data-binary "@test2.txt" "http://an1.icgw.ntt.com:8081/test/test2.txt"
レスポンス例
{ "statusCode":200, "body":{ "result":"ok", "detail": { "ETag":"\"da4b3de6fafcfc74412c6fa0ee55cc79\"", "Location":"https://sc-test.s3.ap-northeast-1-ntt.wasabisys.com/test/test2.txt", "key":"test/test2.txt", "Key":"test/test2.txt", "Bucket":"sc-test" } }
ファイルのダウンロード
コマンド構成
curl \ -X GET \ "http://<エントリーポイント>/<PATH>/<ファイル名>"
コマンド例
curl -X GET "http://an1.icgw.ntt.com:8081/test/test2.txt"
ファイル一覧の取得
コマンド構成
curl \ -X GET \ -H "icgw-storage-bucket: <バケット名>" \ #icgw-storage-bucket に任意のバケットを指定可能 -H "icgw-storage-method: listObject" \ #一覧取得時に必須のヘッダーオプション "http://<エントリーポイント>/<PATH>"
コマンド例
curl -X GET -H "icgw-storage-method: listObject" "an1.icgw.ntt.com:8081/"
レスポンス例
{ "statusCode":200, "body":{ "result":"ok", "detail": { "IsTruncated":false, "Marker":"", "Contents": { "Key":"test/test2.txt", "LastModified":"2022-08-10T06:40:02.000Z", "ETag":"\"d32944c6eafbf733b9e0688b980eb383\"", "ChecksumAlgorithm":[], "Size":16,"StorageClass":"STANDARD", }, "Name":"sc-test", "Prefix":"", "MaxKeys":1000, "CommonPrefixes":[] } } }