防盗链

最近更新时间:2023-11-10 15:32:02

我的收藏

简介

本文档提供关于防盗链接口的 API 概览以及 SDK 示例代码。
API
操作描述
对存储桶添加防盗链
查询 Bucket 中防盗链详情

设置防盗链

功能说明

用于对存储桶添加防盗链(设置黑白名单)。

示例代码

function setRefer() {
var config = {
// 需要替换成您自己的存储桶信息
Bucket: 'examplebucket-1250000000', /* 存储桶,必须 */
Region: 'COS_REGION', /* 存储桶所在地域,必须字段 */
};
var host = config.Bucket + '.pic.' + config.Region + '.myqcloud.com/?hotlink';
var url = 'https://' + host;
var body = COS.util.json2xml({
Hotlink: {
Url: 'https://www.example.com', // 必须,域名地址
Type: 'white', // 必须,防盗链类型,white 为白名单,black 为黑名单,off 为关闭。
}
});
cos.request({
Method: 'PUT',
Url: url,
Body: body,
ContentType: 'application/xml',
},
function(err, data){
logger.log(err || data);
});
}
setRefer();

参数说明

Container 类型 Hotlink 的具体数据描述如下:
节点名称
父节点
描述
类型
是否必选
Url
Hotlink
域名地址。
String
Type
Hotlink
防盗链类型,white 为白名单,black 为黑名单,off 为关闭。
String

返回结果说明

详情请参见 设置防盗链


查询防盗链

功能说明

用于查询 Bucket 中防盗链详情(黑白名单)。

示例代码

function describeRefer() {
var config = {
// 需要替换成您自己的存储桶信息
Bucket: 'examplebucket-1250000000', /* 存储桶,必须 */
Region: 'COS_REGION', /* 存储桶所在地域,必须字段 */
};
var host = config.Bucket + '.pic.' + config.Region + '.myqcloud.com/?hotlink';
var url = 'https://' + host;
cos.request({
Method: 'GET',
Url: url,
},
function(err, data){
logger.log(err || data);
});
}
describeRefer();

参数说明

返回结果说明

详情请参见 查询防盗链