文件存储

最近更新时间:2019-05-16 11:36:42

上传文件

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

请求参数

字段 类型 必填 说明
cloudPath string 文件的绝对路径,包含文件名。例如 foo/bar.jpg、foo/bar/baz.jpg 等。查看详情
filePath HTML upload file 要上传的文件对象。
onUploadProgress function 上传进度回调。

响应参数

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

示例代码

//promise
tcb.uploadFile({
    cloudPath: "test-admin.jpeg",
    filePath: document.getElementById('file').files[0],
    onUploadProgress:function (progressEvent) {
      console.log(progressEvent) 
      var percentCompleted = Math.round( (progressEvent.loaded * 100) / progressEvent.total );
    }
}).then(fucntion(res) {

});

//callback
tcb.uploadFile({
    cloudPath: "test-admin.jpeg",
    filePath: document.getElementById('file').files[0],
    onUploadProgress:function (progressEvent) {
      console.log(progressEvent) 
      var percentCompleted = Math.round( (progressEvent.loaded * 100) / progressEvent.total );
    }
}, function(err, res) {

});

获取文件下载链接

  • 接口名称: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 文件访问链接。

示例代码

//promise
tcb.getTempFileURL({
    fileList: ['cloud://test-28farb/a.png']
}).then((res) => {

});

//callback
tcb.getTempFileURL({
    fileList: ['cloud://test-28farb/a.png']
}, function(err, res) {

})

删除文件

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

请求参数

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

响应参数

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

fileList

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

示例代码

//promise
tcb.deleteFile({
    fileList: [
        "cloud://jimmytest-088bef/1534576354877.jpg"
    ]
}).then((res) => {

});

//callback
tcb.deleteFile({
    fileList: [
        "cloud://jimmytest-088bef/1534576354877.jpg"
    ]
}, function(res) {

})