# 上传文件

  • 接口名称: uploadFile
  • 接口功能:上传文件至云开发存储服务。

# 请求参数

字段 类型 必填 说明
cloudPath string 文件的绝对路径,包含文件名。例如 foo/bar.jpg、foo/bar/baz.jpg 等。查看详情 (opens new window)
fileContent fs.ReadStream buffer 或要上传的文件 可读流 (opens new window)

# 响应参数

字段 类型 必填 说明
code string 状态码,操作成功则不返回。
message string 错误描述。
fileID fileID 文件唯一 ID,用来访问文件,建议存储起来。
requestId string 请求序列号,用于错误排查。

# 示例代码

const app = require("tcb-admin-node");
const fs = require("fs");

let result = await app.uploadFile({
  cloudPath: "test-admin.jpeg",
  fileContent: fs.createReadStream(`${__dirname}/cos.jpeg`)
});

# 获取文件下载链接

  • 接口名称:getTempFileURL
  • 接口功能:获取已上传至云开发的文件的访问链接。

# 请求参数

字段 类型 必填 说明
fileList <Array>.string 要下载的文件 ID 组成的数组。

fileList

字段 类型 必填 说明
fileID string 文件 ID。
maxAge Integer 文件链接有效期。

# 响应参数

字段 类型 必填 说明
code string 状态码,操作成功则为 SUCCESS。
message string 错误描述。
fileList <Array>.object 存储下载链接的数组。
requestId string 请求序列号,用于错误排查。

fileList

字段 类型 必填 说明
code string 删除结果,成功为 SUCCESS。
fileID string 文件 ID。
tempFileURL string 文件访问链接。

# 示例代码

let result = await app.getTempFileURL({
  fileList: ["cloud://test-28farb/a.png"]
});

# 删除文件

接口名称:deleteFile 接口功能:删除已上传至云开发的文件。

# 请求参数

字段 类型 必填 说明
fileList <Array>.string 要删除的文件 ID 组成的数组。

# 响应参数

字段 类型 必填 说明
code string 状态码,操作成功则不返回。
message string 错误描述
fileList <Array>.object 删除结果组成的数组。
requestId string 请求序列号,用于错误排查。

fileList

字段 类型 必填 说明
code string 删除结果,成功为 SUCCESS。
fileID string 文件 ID。

# 示例代码

let result = await app.deleteFile({
  fileList: ["cloud://test-28farb/a.png"]
});

# 下载文件

  • 接口名称:downloadFile
  • 接口功能:下载已上传至云开发的文件至本地(默认本地根目录/root)。

# 请求参数

字段 类型 必填 说明
fileID string 要下载的文件的 ID。
tempFilePath string 下载的文件要存储的位置。

# 响应参数

字段 类型 必填 说明
code string 状态码,操作成功则不返回。
message string 错误描述。
fileContent Buffer 下载的文件的内容。如果传入 tempFilePath 则不返回该字段。
requestId string 请求序列号,用于错误排查。

# 示例代码

let result = await tcb.downloadFile({
  fileID: "cloud://aa-99j9f/my-photo.png"
  // tempFilePath: '/tmp/test/storage/my-photo.png'
});