简介
本文档提供关于如何使用非默认域名请求 COS 服务。
相关参数说明
通过初始化参数，来控制请求域名，相关的参数说明如下，更多初始化参数说明请查看 配置项。
| 参数名 | 参数描述 | 类型 | 是否必填 |
|---|---|---|---|
| Domain | 调用操作存储桶和对象的 API 时自定义请求域名。可以使用模版，如"{Bucket}.cos.{Region}.myqcloud.com"，即在调用 API 时会使用参数中传入的 Bucket 和 Region 进行替换。 |
String | 否 |
| Protocol | 发请求时用的协议，可选项https:、http:，默认判断当前页面是http: 时使用http:，否则使用https: |
String | 否 |
默认 CDN 加速域名
关于如何开启默认加速域名请参考 开启默认 CDN 加速域名。
以下代码展示了如何使用默认加速域名访问 COS 服务。
var cos = new COS({
Domain: '{Bucket}.file.myqcloud.com', // 自定义加速域名，Domain 参数支持模板，这个例子里 {Bucket} 会在请求时按传入的 Bucket 自动替换
Protocol: 'https:', // 请求协议： 'https:' 或 'http:'
});自定义 CDN 加速域名
关于如何开启 CDN 自定义加速域名请参考 开启自定义 CDN 加速域名。
以下代码展示了如何使用自定义加速域名访问 COS 服务。
var cos = new COS({
Domain: 'example-cdn-domain.com', // 自定义加速域名
Protocol: 'https:', // 请求协议： 'https:' 或 'http:'
});自定义源站域名
关于如何设置自定义源站域名请参考 自定义源站域名。
以下代码展示了如何使用自定义源站域名访问 COS 服务。
var cos = new COS({
Domain: 'example-cos-domain.com', // 自定义源站域名
Protocol: 'https:', // 请求协议： 'https:' 或 'http:'
});全球加速域名
关于全球加速功能请参考 全球加速功能概述。
以下代码展示了如何使用全球加速域名访问 COS 服务。
var cos = new COS({
UseAccelerate: true, // 指定 true，使用全球加速域名请求
Protocol: 'https:', // 请求协议： 'https:' 或 'http:'
});