Skip to main content
Blob Storage には、ファイルを誰かに渡す方法が 3 つあります。リンクの有効期間の長さと、後から取り消す必要があるかどうかで選んでください。

​
公開 URL

公開ファイルには CDN 上の恒久的な URL があります。
埋め込むアセットに使用します: サイト上の画像、ボットの添付ファイル、他のサービスが取得するファイルなどです。2026年9月のアップデート以前に保存されたレガシーファイルは、https://public-blob.squarecloud.dev/<user_id>/<path> 上の URL を 30 日間（2026年10月25日まで）保持します。Object Copy（move: true）で移動すると、blob.squarecloud.dev 上の URL を取得できます。
security_hash=true (プライベートファイルと、名前を指定しないアップロードトークンのデフォルト) の場合、パスにランダムな接尾辞が付くため、名前から 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 を返します。これはパスワードページより前に判定され、ダウンロード回数も消費しません。次にアクセスがあった時点で、リンクは共有の一覧から削除されます。
公開ファイルへの共有リンクは、最終的にファイルの恒久的な公開 URL へリダイレクトします。リンクを開いた人はその URL を取得でき、リンクを経由せずに再びファイルをダウンロードできます。そのため、パスワード、ダウンロード回数の上限、有効期限が本当に保護できるのはプライベートファイルだけです。保護が重要な場合は、プライベートファイルを共有してください。

​
ファイルをプライベートまたは公開にする

公開範囲はオブジェクトの更新 (private: true または false) で変更するか、オブジェクトのコピーでコピーする際に変更します。
  • オブジェクトの id が変わります: pub/... は prv/... になり、その逆も同様です。レスポンスの新しい id を保存してください。
  • ファイルをプライベートにすると、リクエストが応答する前に公開コピーが削除されます。公開 URL は機能しなくなり、CDN キャッシュからは約 60 秒で削除されます。公開コピーを削除できなかった場合、オブジェクトは VISIBILITY_CHANGE_FAILED を返して公開されたままになるため、再試行できます。
  • ファイルを公開するには有料プランが必要です。プライベートにすることは、プランがなくても常に可能です。
  • ファイルへの共有リンクと一時リンクは古い id を指しているため、機能しなくなります。新しい id に対して新しいリンクを作成してください。
公開されていたファイルは、プライベートにする前に他者にダウンロードまたはキャッシュされている可能性があります。機密性の高いファイルは最初からプライベートでアップロードしてください (private=true)。