公開 URL
公開ファイルには CDN 上の恒久的な URL があります。https://public-blob.squarecloud.dev/<user_id>/<path> 上の URL を 30 日間（2026年10月25日まで）保持します。Object Copy（move: true）で移動すると、blob.squarecloud.dev 上の URL を取得できます。
一時リンク
オブジェクトのダウンロードは、1 つのファイルへのリンクに署名します。有効期間は 60 秒から 24 時間 (デフォルトは 1 時間) です。プライベートファイルを今すぐ届けるときに使用します: ダウンロードボタン、メールの添付、バックエンドが別のサービスに渡すファイルなどです。- リンクに認証情報は不要で、取り消すことはできません。リンクが機能しなくなるのは、期限切れになったとき、またはファイルが削除、移動されたり公開範囲が変わったりしたときだけです。有効期間は短くしてください。
Range(再開可能なダウンロードや動画のシーク) と条件付きリクエスト (If-None-Match、If-Modified-Since) に対応しています。- ダウンロードを強制し、ブラウザが保存するファイル名を指定できます (
dispositionとfilename)。 - これらの上書き指定がない公開ファイルの場合、オブジェクトのダウンロードは公開 URL そのものを返します。
- 1 つのリンクは IP あたり 1 分間に 60 リクエストを受け付けます。これに加えて、アカウントのすべてのリンクに全体の制限があります。超えるとプレーンテキストで
429を返します。1 つのファイルを多くの人に渡すには、ファイルを公開してください: 公開ファイルは CDN から配信され、この制限はありません。期限切れまたは無効なリンクは404を返します。
共有リンク
共有の作成は、独自のページを持つリンクを作成します。プログラムではなく人向けのリンクです: クライアントへのファイル送付、チームへのレポート、テスターへのビルドなどに使います。- 有効期間は 60 秒から 30 日 (デフォルトは 24 時間) です。
- 共有の削除でいつでも取り消すことができ、共有の一覧に表示されます。
max_downloadsはファイルをダウンロードできる回数を制限します。同時ダウンロードがあってもカウントは正確です。上限に達すると、リンクは410を返します。- Pro と Enterprise では、
passwordを指定するとダウンロード前にページがパスワードを要求します。誤った試行は IP ごと、リンクごとに制限されます。ダウングレード前に作成されたパスワード付きリンクは、パスワードを保持します。 - ページは訪問者のブラウザの言語 (英語、ポルトガル語、スペイン語、フランス語、ドイツ語、イタリア語、日本語、中国語) に従います。
- アカウントは最大 1000 件の有効な共有リンクを持てます。
- プライベートファイルのダウンロードは一時リンクを経由するため、同じ制限が適用されます: IP あたり 1 分間に 60 リクエスト、およびアカウント全体の制限。
404 を返します。これはパスワードページより前に判定され、ダウンロード回数も消費しません。次にアクセスがあった時点で、リンクは共有の一覧から削除されます。
ファイルをプライベートまたは公開にする
公開範囲はオブジェクトの更新 (private: true または false) で変更するか、オブジェクトのコピーでコピーする際に変更します。
- オブジェクトの id が変わります:
pub/...はprv/...になり、その逆も同様です。レスポンスの新しいidを保存してください。 - ファイルをプライベートにすると、リクエストが応答する前に公開コピーが削除されます。公開 URL は機能しなくなり、CDN キャッシュからは約 60 秒で削除されます。公開コピーを削除できなかった場合、オブジェクトは
VISIBILITY_CHANGE_FAILEDを返して公開されたままになるため、再試行できます。 - ファイルを公開するには有効なプランが必要です。プライベートにすることは、プランがなくても常に可能です。
- ファイルへの共有リンクと一時リンクは古い id を指しているため、機能しなくなります。新しい id に対して新しいリンクを作成してください。