共有 - Square Cloud

共有は 1 つのオブジェクトへのリンクで、有効期限を設定でき、取り消しが可能で、ダウンロード回数を制限でき、Pro と Enterprise ではパスワードを要求できます。リンクの動作についてはリンクと共有を参照してください。

共有か `downloadUrl()` か

	`downloadUrl()`	`shares.create()`
公開オブジェクト	恒久的な CDN URL (`expires_at: null`)	恒久的な公開 URL にリダイレクト (下の警告を参照)
プライベートオブジェクト	一時リンク、最大 24 時間	共有リンク、最大 30 日
取り消し	不可	可能、`shares.revoke()` で
ダウンロード回数の制限	なし	あり、`max_downloads`
パスワード	なし	あり、Pro と Enterprise

自分で配布する短期間のリンクには downloadUrl() を、リンクを取り消す必要がある場合やダウンロードする人を制御したい場合には共有を使います。

共有の作成

const share = await blob.shares.create(id, {
    expires_in: 86400,     // seconds, 60 to 2592000 (default 86400)
    max_downloads: 10,     // 1 to 10000
    password: "secret123", // 8 to 128 characters, Pro and Enterprise
});

console.log(share.url);

オプション	型	説明
`expires_in`	`number`	リンクの有効期間 (秒)。60〜2592000 (30 日)。デフォルトは 86400。
`max_downloads`	`number`	1〜10000。
`password`	`string`	8〜128 文字。Pro と Enterprise のみで、その他のプランでは `UPGRADE_REQUIRED` になります。

結果には id、url、expires_at、max_downloads、password (設定されているかどうか)、object、object_is_public があります。

object_is_public が true の場合、共有リンクはオブジェクトの恒久的な公開 URL にリダイレクトされます。ファイルはその URL から引き続きアクセスできるため、パスワード、ダウンロード回数の制限、有効期限は何も保護しません。先にオブジェクトをプライベートにしてから共有してください:

const [result] = await blob.update(id, { private: true });
if (result.ok) {
    id = result.id; // the id changes
    const share = await blob.shares.create(id, { max_downloads: 1 });
}

共有の一覧

const shares = await blob.shares.list();

共有の配列を返します。各共有には id、url、object、expires_at、remaining_downloads、password、created_at があります。

共有の取り消し

await blob.shares.revoke(share.id);

リンクは機能しなくなります。revoke() は何も返さずに解決され、存在しない共有を取り消そうとすると SHARE_NOT_FOUND で失敗します。

オブジェクトの削除、移動、名前変更、または公開範囲の変更を行うと、その共有リンクも壊れます。リンクは古い ID を指しているためです。新しい ID に対して新しい共有を作成してください。

shares.create() と shares.revoke() は 1 回のみ試行されます。リトライされるのは、読み取りである shares.list() だけです。

API リファレンス: Blob 共有の作成、Blob 共有の一覧、Blob 共有の削除。

サービス

Runtimes

プラットフォーム

トラブルシューティング

CLI

SDKs

Changelog

共有

共有か `downloadUrl()` か

共有の作成

共有の一覧

共有の取り消し

​共有か downloadUrl() か

​共有の作成

​共有の一覧

​共有の取り消し

共有か `downloadUrl()` か

共有の作成

共有の一覧

共有の取り消し