Skip to content

buildCosUnsignedObjectUrl

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

函数签名

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

function buildCosUnsignedObjectUrl(
  params: BuildCosUnsignedObjectUrlParams,
): string

参数

参数名类型必填说明
bucketstringCOS 存储桶全名
regionstring地域,如 ap-guangzhou
keystring对象键
publicBaseUrlstring自定义公有基址;默认 https://{bucket}.cos.{region}.myqcloud.com

返回值

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

工作原理

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

使用场景

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