tencent cloud

云开发 CloudBase

产品简介
产品概述
功能和优势
应用场景
系统限制
购买指南
价格文档
计费能力项说明
包年包月套餐说明
告警与通知
欠费说明
开发指南
云储存
数据库
身份认证
云函数
静态网站托管
SDK 文档
客户端 SDK
服务端 SDK
管理端 SDK
产品协议
Cloud Development Service Level Agreement

获取临时链接

PDF
聚焦模式
字号
最后更新时间: 2025-12-31 11:53:08
您可以使用 fileID 换取云存储空间指定文件的 HTTPS 链接(云存储提供免费的 CDN 域名)。
说明:
公有读的文件获取的 HTTPS 链接不会过期,例如默认情况下的权限就是公有读,获取的链接永久有效。
私有读的文件获取的 HTTPS 链接为临时链接,例如您可以结合用户身份认证和安全规则设置文件的权限为仅文件的上传创建者或管理员可读,此时只有通过了云开发身份验证的用户才有权限换取临时链接。
有效期可以动态设置,超过有效期再请求临时链接时会被拒绝,保证了文件的安全。
一次最多可以取50个,更多需分批处理。
CDN 会默认为后缀 .js、.html、.css、.xml、.json、.shtml、.htm,大小为256Byte - 2MB范围内的资源开启 Gzip 压缩。
使用 SDK 调用 getTempFileURL 方法传入文件的 fileID,就可以换取云存储空间指定文件的 HTTPS 链接。
Web
微信小程序
Node.js
//第一步,引入 Web SDK,
import tcb from "@cloudbase/js-sdk";

//第二步,初始化
const app = tcb.init({
env: "your-env-id"
});

//第三步,登录认证,下面非完整代码,需选择登录方式,具体可以参见 快速开始 > 登录与用户案例
const auth = app.auth({
persistence: "local" //用户显示退出或更改密码之前的30天一直有效
});

app
.getTempFileURL({
fileList: ["cloud://a/b/c", "cloud://d/e/f"]
})
.then((res) => {
// fileList 是一个有如下结构的对象数组
// [{
// fileID: 'cloud://webtestjimmy-5328c3.7765-webtestjimmy-5328c3-1251059088/腾讯云.png', // 文件 ID
// tempFileURL: '', // 临时文件网络链接
// maxAge: 120 * 60 * 1000, // 有效期
// }]
console.log(res.fileList);
});

//需先使用 wx.cloud.init 初始化,小程序端无需再引入 SDK ,且免鉴权
wx.cloud
.getTempFileURL({
fileList: ["cloud://a/b/c", "cloud://d/e/f"]
})
.then((res) => {
// fileList 是一个有如下结构的对象数组
// [{
// fileID: 'cloud://webtestjimmy-5328c3.7765-webtestjimmy-5328c3-1251059088/腾讯云.png', // 文件 ID
// tempFileURL: '', // 临时文件网络链接
// maxAge: 120 * 60 * 1000, // 有效期
// }]
console.log(res.fileList);
});

const tcb = require("@cloudbase/node-sdk");
const app = tcb.init();

app
.getTempFileURL({
fileList: ["cloud://a/b/c", "cloud://d/e/f"]
})
.then((res) => {
// fileList 是一个有如下结构的对象数组
// [{
// fileID: 'cloud://webtestjimmy-5328c3.7765-webtestjimmy-5328c3-1251059088/腾讯云.png', // 文件 ID
// tempFileURL: '', // 临时文件网络链接
// maxAge: 120 * 60 * 1000, // 有效期
// }]
console.log(res.fileList);
});



帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈