API | Operation | Description |
Setting bucket referer configuration | Sets a bucket referer allowlist or blocklist | |
Querying bucket referer configuration | Queries a bucket referer allowlist or blocklist |
func (s *BucketService) PutReferer(ctx context.Context, opt *BucketPutRefererOptions) (*Response, error)
package mainimport ("context""github.com/tencentyun/cos-go-sdk-v5""net/http""net/url""os")func main(){// Bucket name in the format of `BucketName-APPID` (`APPID` is required), which can be viewed in the COS console at https://console.tencentcloud.com/cos5/bucket.// Replace it with your region, which can be viewed in the COS console at https://console.tencentcloud.com/. For more information about regions, visit https://www.tencentcloud.com/document/product/436/6224.u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")b := &cos.BaseURL{BucketURL: u}client := cos.NewClient(b, &http.Client{Transport: &cos.AuthorizationTransport{// Get the key from environment variables// Environment variable `SECRETID` refers to the user's `SecretId`, which can be viewed in the CAM console at https://console.tencentcloud.com/cam/capi.SecretID: os.Getenv("SECRETID"), // User `SecretId`. We recommend you use a sub-account key and follow the principle of least privilege to reduce risks. For information about how to obtain a sub-account key, visit https://www.tencentcloud.com/document/product/598/32675.// Environment variable `SECRETKEY` refers to the user's `SecretKey`, which can be viewed in the CAM console at https://console.tencentcloud.com/cam/capi.SecretKey: os.Getenv("SECRETKEY"), // User `SecretKey`. We recommend you use a sub-account key and follow the principle of least privilege to reduce risks. For information about how to obtain a sub-account key, visit https://www.tencentcloud.com/document/product/598/32675.},})opt := &cos.BucketPutRefererOptions{Status: "Enabled",RefererType: "White-List",DomainList: []string{"*.qq.com","*.qcloud.com",},EmptyReferConfiguration: "Allow",}_, err := client.Bucket.PutReferer(context.Background(), opt)}
type BucketPutRefererOptions struct {Status stringRefererType stringDomainList []stringEmptyReferConfiguration string}
Parameter | Description | Type |
Status | Whether hotlink protection is enabled. Enumerated values: Enabled, Disabled` | String |
RefererType | Hotlink protection type. Enumerated values: Black-List , White-List | String |
DomainList | A list of domains, which can include ports, IPs, or asterisks (*). You can set multiple domains. | Array |
EmptyReferConfiguration | Whether to allow access with an empty referer. Enumerated values: Allow , Deny | String |
func (s *BucketService) GetReferer(ctx context.Context) (*BucketGetRefererResult, *Response, error)
package mainimport ("context""fmt""github.com/tencentyun/cos-go-sdk-v5""net/http""net/url""os")func main(){// Bucket name in the format of `BucketName-APPID` (`APPID` is required), which can be viewed in the COS console at https://console.tencentcloud.com/cos5/bucket.// Replace it with your region, which can be viewed in the COS console at https://console.tencentcloud.com/. For more information about regions, visit https://www.tencentcloud.com/document/product/436/6224.u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")b := &cos.BaseURL{BucketURL: u}client := cos.NewClient(b, &http.Client{Transport: &cos.AuthorizationTransport{// Get the key from environment variables// Environment variable `SECRETID` refers to the user's `SecretId`, which can be viewed in the CAM console at https://console.tencentcloud.com/cam/capi.SecretID: os.Getenv("SECRETID"), // User `SecretId`. We recommend you use a sub-account key and follow the principle of least privilege to reduce risks. For information about how to obtain a sub-account key, visit https://www.tencentcloud.com/document/product/598/32675.// Environment variable `SECRETKEY` refers to the user's `SecretKey`, which can be viewed in the CAM console at https://console.tencentcloud.com/cam/capi.SecretKey: os.Getenv("SECRETKEY"), // User `SecretKey`. We recommend you use a sub-account key and follow the principle of least privilege to reduce risks. For information about how to obtain a sub-account key, visit https://www.tencentcloud.com/document/product/598/32675.},})res, _, err := client.Bucket.GetReferer(context.Background())if err != nil{fmt.Println(err)}fmt.Println(res)}
type BucketGetRefererResult struct {Status stringRefererType stringDomainList []stringEmptyReferConfiguration string}
Parameter | Description | Type |
Status | Whether hotlink protection is enabled. Enumerated values: Enabled, Disabled` | String |
RefererType | Hotlink protection type. Enumerated values: Black-List , White-List | String |
DomainList | A list of domains, which can include ports, IPs, or asterisks (*). You can set multiple domains. | Array |
EmptyReferConfiguration | Whether to allow access with an empty referer. Enumerated values: Allow , Deny | String |
Was this page helpful?