跳到主要内容

云存储

云存储是云开发为用户提供的文件存储能力,用户可以通过云开发提供的 CLI 工具、SDK 对存储进行操作,如上传、下载文件。存储在云存储中的文件默认提供 CDN 加速访问,用户可以快速访问云存储中的文件。

路径说明

  • localPath 为本地文件或文件夹的路径,为 目录/文件名 的形式,如 ./index.jsstatic/css/index.css 等。
  • cloudPath 为云存储文件或文件夹的相对根目录的路径,为 目录/文件名 的形式,如 index.jsstatic/css/index.js 等。
⚠️ 注意事项

Windows 系统中 localPath 为本地路径形式,是系统可以识别的路径,通常使用 \ 分隔符。cloudPath 是云端文件路径,均需要使用 / 分隔符。

上传文件

您可以使用下面的命令上传文件/文件夹,当 CLI 检测到 localPath 为文件夹时,会自动上传文件内的所有文件。

tcb storage upload localPath cloudPath

下载文件

您可以使用下面的命令下载文件/文件夹,需要下载文件夹时,需要指定 --dir 参数。

# 下载文件
tcb storage download cloudPath localPath

# 下载文件夹
tcb storage download cloudPath localPath --dir

下载全部文件

当指定 cloudPath 为 / 时,即代表下载云存储中的全部文件

# 下载文件夹
tcb storage download / localPath --dir

删除文件

您可以使用下面的命令删除云端文件/文件夹,需要删除文件夹时,需要指定 --dir 参数。

# 删除文件
tcb storage delete cloudPath

# 删除文件夹
tcb storage delete cloudPath --dir

删除全部文件

云端路径为空时,即代表删除云存储中的全部文件

tcb storage delete

列出文件列表

您可以使用下面的命令列出文件夹下的文件

tcb storage list cloudPath

获取文件访问链接

您可以使用下面的命令获取文件的临时访问链接

tcb storage url cloudPath

获取文件简单信息

您可以使用下面的命令获取文件的简单信息

tcb storage detail cloudPath

获取文件访问权限

您可以使用下面的命令获取文件的访问权限设置信息

tcb storage get-acl

设置文件访问权限

您可以使用下面的命令设置文件的访问权限

tcb storage set-acl