API | Operation | Description |
Setting a static website | Sets static website configuration on an existing bucket | |
Querying a static website | Queries the static website configuration on a bucket | |
Deleting a static website | Deletes the static website configuration on a bucket |
cos.putBucketWebsite({Bucket: 'examplebucket-1250000000', /* Required */Region: 'ap-beijing', /* Required */WebsiteConfiguration: {IndexDocument: {Suffix: "index.html"},ErrorDocument: {Key: "error.html"},RedirectAllRequestsTo: {Protocol: "https"},}}, function(err, data) {console.log(err || data);});
Parameter Name | Description | Type | Required |
Bucket | Name of the bucket with a static website configuration in the format: BucketName-APPID | String | Yes |
Region | String | Yes | |
WebsiteConfiguration | Static website configuration, including index documents, error documents, protocol conversion, and redirect rules | Object | Yes |
- IndexDocument | Index document | Object | Yes |
- - Suffix | Specifies an index document | String | Yes |
- ErrorDocument | Error document | Object | No |
- - Key | Specifies general error response | String | No |
- RedirectAllRequestsTo | Redirects all requests | Object | No |
- - Protocol | Specifies the site-wide redirect protocol, only HTTPS is supported | String | No |
- RoutingRules | Sets up to 100 redirect rules | ObjectArray | No |
- - Condition | Specifies the condition that must be met for a redirect to apply; redirects can either be applied based on prefix-matching or error codes. | Object | No |
- - - HttpErrorCodeReturnedEquals | Specifies the redirect error code. Only 4XX status codes are supported. This has a higher priority than ErrorDocument . | String | No |
- - - KeyPrefixEquals | Specifies the prefix of the paths to be redirected | String | No |
- - Redirect | Specifies the replacement rule for redirects that meet the condition | Object | No |
- - - ReplaceKeyWith | Specifies the content that is used to replace the entire key | String | No |
- - - ReplaceKeyPrefixWith | Specifies the content that is used to replace the key prefix. This is allowed only when the condition is KeyPrefixEquals . | String | No |
function(err, data) { ... }
Parameter Name | Description | Type |
err | Object returned when an error (network error or service error) occurs. If the request is successful, this is null. For more information, see Error Codes. | Object |
- statusCode | HTTP status code returned by the request, such as 200 , 403 , and 404 | Number |
- headers | Headers returned by the request | Object |
data | Data returned when the request is successful. If the request fails, this is null. | Object |
- statusCode | HTTP status code returned by the request, such as 200 , 403 , and 404 | Number |
- headers | Headers returned by the request | Object |
cos.getBucketWebsite({Bucket: 'examplebucket-1250000000', /* Required */Region: 'ap-beijing', /* Required */}, function(err, data) {console.log(err || data);});
{"WebsiteConfiguration": {"IndexDocument": {"Suffix": "index.html"},"ErrorDocument": {"Key": "error.html"},"RedirectAllRequestsTo": {"Protocol": "https"},},"statusCode": 200,"headers": {}}
Parameter Name | Description | Type | Required |
Bucket | Name of the bucket with a static website configuration in the format: BucketName-APPID | String | Yes |
Region | Bucket region. For the enumerated values, see Regions and Access Domain Names | String | Yes |
function(err, data) { ... }
Parameter Name | Description | Type |
err | Object returned when an error (network error or service error) occurs). If the request is successful, this is null. For more information, see Error Codes. | Object |
- statusCode | HTTP status code returned by the request, such as 200 , 403 , and 404 | Number |
- headers | Headers returned by the request | Object |
data | Data returned when the request is successful. If the request fails, this is null. | Object |
- statusCode | HTTP status code returned by the request, such as 200 , 403 , and 404 | Number |
- headers | Headers returned by the request | Object |
- WebsiteConfiguration | Static website configuration, including index documents, error documents, protocol conversion, and redirect rules | Object |
- - IndexDocument | Index document | Object |
- - - Suffix | Specifies an index document | String |
- - ErrorDocument | Error document | Object |
- - - Key | Specifies general error response | String |
- - RedirectAllRequestsTo | Redirects all requests | Object |
- - - Protocol | Specifies the site-wide redirect protocol, only HTTPS is supported. | String |
- - RoutingRules | Sets up to 100 redirect rules | ObjectArray |
- - - Condition | Specifies the condition that must be met for a redirect to apply; redirects can either be applied based on prefix-matching or error codes. | Object |
- - - - HttpErrorCodeReturnedEquals | Specifies the redirect error code. Only 4XX status codes are supported. This has a higher priority than ErrorDocument . | String |
- - - - KeyPrefixEquals | Specifies the prefix of the paths to be redirected | String |
- - - Redirect | Specifies the replacement rule for redirects that meet the condition | Object |
- - - - ReplaceKeyWith | Specifies the content that is used to replace the entire key | String |
- - - - ReplaceKeyPrefixWith | Specifies the content that is used to replace the key prefix. This is allowed only when the condition is KeyPrefixEquals . | String |
cos.deleteBucketWebsite({Bucket: 'examplebucket-1250000000', /* Required */Region: 'ap-beijing', /* Required */}, function(err, data) {console.log(err || data);});
Parameter Name | Description | Type | Required |
Bucket | Name of the bucket whose static website configuration is deleted in the format: BucketName-APPID | String | Yes |
Region | Bucket region. For the enumerated values, see Regions and Access Domain Names | String | Yes |
function(err, data) { ... }
Parameter Name | Description | Type |
err | Object returned when an error (network error or service error) occurs. If the request is successful, this is null. For more information, see Error Codes. | Object |
- statusCode | HTTP status code returned by the request, such as 200 , 403 , and 404 | Number |
- headers | Headers returned by the request | Object |
data | Data returned when the request is successful. If the request fails, this is null. | Object |
- statusCode | HTTP status code returned by the request, such as 200 , 403 , and 404 | Number |
- headers | Headers returned by the request | Object |
Was this page helpful?