tencent cloud

Cloud Object Storage

DocumentationCloud Object StorageSDK DocumentationHarmony SDKConfigure Access Domain (CDN/Global Accelerator)

Configure Access Domain (CDN/Global Accelerator)

Download
Focus Mode
Font Size
Last updated: 2026-02-05 10:49:06

Introduction

This document describes how to request COS services using non-default domain names.

CDN Default Acceleration Domain

For information on how to enable the default acceleration domain, see Enable the Default CDN Acceleration Domain.
The following code demonstrates how to access COS services using the default acceleration domain.

Example Code

// The bucket region can be viewed on the bucket overview page in the COS console at https://console.tencentcloud.com/cos5/bucket/. For details about regions, see https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1 let region = "ap-guangzhou"; // Your bucket region // Default acceleration domain for the bucket let cdnDomain = "examplebucket-1250000000.file.myqcloud.com"; // COS service configuration let cosXmlServiceConfig = new CosXmlServiceConfig(region); // Modify the request domain cosXmlServiceConfig.host = cdnDomain; // Modify the Host field in the header cosXmlServiceConfig.headers = new Map(); cosXmlServiceConfig.headers.set("Host", cdnDomain); // Instantiate the COS service cosXmlBaseService
// Without providing a key, you can support CDN permission verification by adding params parameters to the url during download. let cosXmlBaseService = new CosXmlBaseService(context, cosXmlServiceConfig); // Use cosXmlBaseService to perform COS operations.
...

CDN Custom Acceleration Domain

For information on how to enable CDN custom acceleration domain, see Enable Custom CDN Acceleration Domain.
The following code demonstrates how to access COS services using a custom acceleration domain.

Example Code

// The bucket region can be viewed on the bucket overview page in the COS console at https://console.tencentcloud.com/cos5/bucket/. For details about regions, see https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1 let region = "ap-guangzhou"; // Your bucket region // Custom acceleration domain let cdnDomain = "exampledomain.com"; // COS service configuration let cosXmlServiceConfig = new CosXmlServiceConfig(region); // Modify the request domain cosXmlServiceConfig.host = cdnDomain; // Modify the Host field in the header cosXmlServiceConfig.headers = new Map(); cosXmlServiceConfig.headers.set("Host", cdnDomain); // Instantiate the COS service cosXmlBaseService
// Without providing a key, you can support CDN permission verification by adding params parameters to the url during download. let cosXmlBaseService = new CosXmlBaseService(context, cosXmlServiceConfig); // Use cosXmlBaseService to perform COS operations.
...

Custom Origin Domain

For information on how to set a custom origin domain, see Custom Origin Domain.
The following code demonstrates how to access COS services using a custom origin domain.

Example Code

// The bucket region can be viewed on the bucket overview page in the COS console at https://console.tencentcloud.com/cos5/bucket/. For details about regions, see https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1 let region = "ap-guangzhou"; // Your bucket region // Custom domain let cdnDomain = "exampledomain.com"; // COS service configuration let cosXmlServiceConfig = new CosXmlServiceConfig(region); // Modify the request domain cosXmlServiceConfig.host = cdnDomain; // Instantiate the COS service cosXmlBaseService let cosXmlBaseService = new CosXmlBaseService(context, cosXmlServiceConfig, credential); // Use cosXmlBaseService to perform COS operations
...

Global Acceleration Domain

For information about the Global Acceleration feature, see Global Acceleration Feature Overview.
The following code demonstrates how to access COS services using a global acceleration domain.

Example Code

// The bucket region can be viewed on the bucket overview page in the COS console at https://console.tencentcloud.com/cos5/bucket/. For details about regions, see https://www.tencentcloud.com/document/product/436/6224?from_cn_redirect=1 let region = "ap-guangzhou"; // Your bucket region // Global acceleration domain template (the SDK will automatically replace ${bucket}) let cdnDomain = "${bucket}.cos.accelerate.myqcloud.com"; // COS service configuration let cosXmlServiceConfig = new CosXmlServiceConfig(region); // Modify the request domain cosXmlServiceConfig.host = cdnDomain; // Instantiate the COS service cosXmlBaseService let cosXmlBaseService = new CosXmlBaseService(context, cosXmlServiceConfig, credential); // Use cosXmlBaseService to perform COS operations
...


Help and Support

Was this page helpful?

Help us improve! Rate your documentation experience in 5 mins.

Feedback