ダウンロード
Assembly は、含まれる処理結果の一時ダウンロード URL を返せます。これらの URL は Assembly Status JSON の結果に含まれます。デフォルトでは、ほかの Step が使用していない Step の結果が含まれます。中間の Step の結果も含めるには、"result": true を設定します。
一時的な結果は、Assembly の完了後すぐに、遅くとも 24 時間以内に自分のストレージにダウンロードしてください。一時ファイルの有効期限が切れると、結果の URL は機能しなくなります。処理結果が保存されるかどうかは、Template または Workspace の一時ファイル保持ポリシーにも依存します。Assembly Status JSON の保持は別の設定であり、一時ファイルの保存期間は延長しません。
本番ワークフローでは、クラウドバケットやサーバーに結果を保存するエクスポート用の
Robot を推奨します。エクスポートに失敗すると再試行されます。デフォルトでは、再試行後も失敗する場合、エクスポートの成功を報告するのではなく、Assembly が失敗します。自分のストレージ内のファイルへのアクセスは、そのプロバイダーと設定によって制御されます。エクスポート用 Robot の acl のデフォルト値を確認してください。エクスポートによっては、非公開アクセスを設定しない限りファイルが公開されます。非公開にする設定は、Google Cloud Storage ガイドと
DigitalOcean Spaces ガイドで説明しています。
一時 URL(tmp-*.transloadit.net)は、自分のストレージにファイルを一度ダウンロードする目的にのみ使用できます。
- ✅ 許可される用途:ファイルを一度ダウンロードし、自分のインフラストラクチャに保存する
- ❌ 禁止される用途:エンドユーザーと一時 URL を共有する(利用規約 (English)違反)
- ❌ 禁止される用途:アプリケーションやウェブサイトに一時 URL を埋め込む
- ❌ 禁止される用途:CDN として使用する、または繰り返しダウンロードする
これらの制限への違反は当社の利用規約違反にあたり、直ちにアカウントが停止される場合があります。ファイルへの 10 回を超えるアクセスや、過剰な帯域幅の消費は禁止されています。本番環境では、必ずエクスポート用の Robot を使用して、自分のストレージにファイルを保存してください。
🤖/file/filter は、受け入れたファイルを後続の Step に渡し、拒否したファイルは結果として出力しません。一時保存用のコピーを別途作成するのではなく、入力ファイルの URL 情報を再利用します。デフォルトでは、アップロードされたファイルは一時ストレージに保存されます。アップロードされたファイルをフィルタリングすると、既存のコピーが再利用されますが、保存期間は延長されません。フィルターに入力を渡す処理 Step の出力は、デフォルトでは一時ストレージに保持されません。そのため、URL が機能するだけでは、その出力がいつまで利用できるかは判断できません。一時保存を指定するには、出力元の Step に "result": true を設定します。この設定により、その Step のフィルタリング前の結果も Assembly Status JSON に含まれますが、引き続き保持ポリシーが適用されます。受け入れたファイルだけを自分のストレージに保存するには、代わりにフィルターの Step にエクスポート用の Step を接続します。
Smart CDN で配信するには、Smart CDN 設定ガイドに従ってください。一時ダウンロード URL は、Smart CDN や独自のホスティングの代わりにはなりません。