履歴データのエクスポート
履歴エクスポートはバックグラウンドでファイルを生成します。生データ明細の保存や他のツールでの分析に適しており、照会が終わるまでブラウザーで待ち続ける必要はありません。
エクスポート手順
Section titled “エクスポート手順”- ポイントと時間範囲を選択します。共有ポイントには送信元デバイスを指定します。
- ディスク容量の見積もりを確認し、エクスポートタスクを作成します。
- タスク一覧で待機中、実行中、完了、失敗の状態を確認します。不要になったらキャンセルできます。
- 完了後、短期ダウンロード認証情報を取得し、CSV または ZIP をダウンロードします。
タスクには時間範囲、ファイルサイズ、同時実行数、ディスク空き容量の制限があります。空き容量が不足するとエクスポートを拒否または停止します。具体的な制限はデバイス設定に従います。
ファイルとデータ
Section titled “ファイルとデータ”- 収集、集約、共有の履歴値に対応します。同じデバイスの同じポイントを重複選択しないでください。
- CSV は空値の識別子を保持し、「データなし」と空文字列を区別します。
- ダウンロード認証情報には有効期限があります。失効後は再取得してください。認証情報を公開しないでください。
- 指定範囲で現在保持されているデータをエクスポートします。保持ポリシーで削除済みの履歴は復元できません。
統合 API
Section titled “統合 API”| 操作 | API |
|---|---|
| 容量見積もり | GET /ems-data/export/disk-space |
| タスク作成／一覧照会 | POST /ems-data/export/tasks / GET /ems-data/export/tasks |
| 個別タスクの照会／キャンセル | GET /ems-data/export/tasks/:taskId / DELETE /ems-data/export/tasks/:taskId |
| ダウンロード認証情報の取得 | POST /ems-data/export/tasks/:taskId/download-ticket |
タスク作成時に format（CSV または CSV_ZIP）、dataKeys、startTime、endTime を渡します。タスクが成功した後にのみダウンロードできます。受理された時点では、ファイルの生成は完了していません。
一時的な分析には 履歴照会、継続保存には 定期アーカイブ、設定移行には バックアップと復元 を使用してください。Agent からの呼び出しは エクスポート Skill を参照してください。