Concepts
A static website is a website that contains static content (such as HTML) or client scripts. You can configure static websites for buckets with a custom domain name through the console. A dynamic website contains server scripts such as PHP, JSP, or ASP.NET, and needs to be processed on a server. You can host static websites on Tencent Cloud COS, but cannot write server scripts. For deployment of a dynamic website, we recommend you use a CVM for server code deployment.
Samples
A user created a bucket named examplebucket-1250000000 and uploaded the following files:
index.html
404.html
403.html
test.html
docs/a.html
images/
Static website
Before enabled: Access the bucket via the following default domain name. When a download prompt pops up, save the index.html
file to the local.
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/index.html
After enabled: Access the bucket via the following access node, and then you can view the content of index.html
directly in the browser.
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/index.html
Forced HTTPS
Before enabled: When the request source is HTTP, the access node URL keeps the HTTP unencrypted transport protocol:
http://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com
After enabled: The access node always maintains the HTTPS encrypted transport protocol regardless of whether the request source is HTTP or HTTPS:
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com
Index document
An index file, the homepage of the static website, is a page returned when the root directory or any subdirectory of a website is requested, and is usually named index.html
.
When you access a static website via a bucket access domain name, such as https://examplebucketbucket-1250000000.cos-website.ap-guangzhou.myqcloud.com
, and no specific page is requested, the web server will return the homepage.
When your user accesses any directory (including the root directory) in a bucket using a URL ending with /
, the index document in that directory will be matched preferentially. /
is not mandatory in the root URL, so the index document is returned in response to either of the following URLs.
http://www.examplebucket.com/
http://www.examplebucket.com
Note:
If a folder is created in the bucket, the index file needs to be added at each level of the folder.
Error document
Assume that when you visit the following page before configuring the error document, a 404 status code is returned, and the default error information is displayed on the page.
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/webpage.html
When you visit the following page after configuring the error document, a 404 status code is also returned, but the specific error information is displayed on the page.
https://examplebucket-1250000000.cos-website.ap-guangzhou.myqcloud.com/webpage.html
Redirection rules
Note:
To configure redirection rules for a hosted static website, the path of the replacement file must be an object path in your bucket.
If the webpage.html document is set to Private Read/Write, when a user tries to access it, a 403 error is returned.
After the 403 error code is redirected to 403.html, the browser will return the content of 403.html.
If you do not configure a 403.html document, the browser will return an error document or default error message.
Note:
Prefix match does not support wildcards. If you want to redirect two folders prefixed with index1/
and index2/
, you cannot use index*/
as the match rule; instead, you should create corresponding match rules separately.
1. When you rename a folder from docs/
to documents/
, the user will get an error when accessing the docs/
folder. So, you can redirect the request with the prefix docs/
to documents/
.
2. When you delete the images/
folder (i.e., deleting all objects with the prefix images/
), you can add a redirection rule to redirect requests for any object with the prefix images/
to test.html
.
Was this page helpful?