buildCosUnsignedObjectUrl

生成未签名的腾讯云 COS 对象访问 URL（桶需公有读或接 CDN）。

函数签名

interface BuildCosUnsignedObjectUrlParams {
  bucket: string
  region: string
  key: string
  publicBaseUrl?: string
}

function buildCosUnsignedObjectUrl(
  params: BuildCosUnsignedObjectUrlParams,
): string

参数

参数名	类型	必填	说明
bucket	string	是	COS 存储桶全名
region	string	是	地域，如 ap-guangzhou
key	string	是	对象键
publicBaseUrl	string	否	自定义公有基址；默认 https://{bucket}.cos.{region}.myqcloud.com

返回值

类型	说明
string	未签名 URL，路径段经 encodeURIComponent

工作原理

1. 确定 base URL（自定义或默认 COS 域名）。
2. 将 key 按 / 分段编码后拼接。

使用场景

• API OssService 返回 publicUrl
• 私有桶请使用服务端签名 URL，勿直接用本函数