简介
本文档提供关于存储桶 Referer 白名单或者黑名单的 API 概览以及 SDK 示例代码。
API | 操作名 | 操作描述 |
PUT Bucket referer | 设置存储桶 Referer | 设置存储桶 Referer 白名单或者黑名单 |
GET Bucket referer | 查询存储桶 Referer | 查询存储桶 Referer 白名单或者黑名单 |
SDK API 参考
SDK 所有接口的具体参数与方法说明,请参考 SDK API。
设置存储桶 Referer
功能说明
设置指定存储桶的 Referer 白名单或者黑名单(PUT Bucket referer)。注意COS iOS SDK 版本需要大于等于 v5.9.6。
请求示例
Objective-C
QCloudPutBucketRefererRequest* request = [QCloudPutBucketRefererRequest new];
// 防盗链类型,枚举值:Black-List、White-Listrequest.refererType = QCloudBucketRefererTypeBlackList;
// 是否开启防盗链,枚举值:Enabled、Disabledrequest.status = QCloudBucketRefererStatusEnabled;
// 是否允许空 Referer 访问,枚举值:Allow、Deny,默认值为 Denyrequest.configuration = QCloudBucketRefererConfigurationDeny;
// 生效域名列表, 支持多个域名且为前缀匹配, 支持带端口的域名和 IP, 支持通配符*,做二级域名或多级域名的通配request.domainList = @[@"*.com",@"*.qq.com"];
// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = @"examplebucket-1250000000";
[request setFinishBlock:^(id outputObject, NSError *error) { if (error){ // 添加防盗链失败 }else{ // 添加防盗链失败 }
}];[[QCloudCOSXMLService defaultCOSXML] PutBucketReferer:request];
说明更多完整示例,请前往 GitHub 查看。Swift
let request = QCloudPutBucketRefererRequest.init();
// 防盗链类型,枚举值:Black-List、White-Listrequest.refererType = QCloudBucketRefererType.blackList;
// 是否开启防盗链,枚举值:Enabled、Disabledrequest.status = QCloudBucketRefererStatus.enabled;
// 是否允许空 Referer 访问,枚举值:Allow、Deny,默认值为 Denyrequest.configuration = QCloudBucketRefererConfiguration.allow;
// 生效域名列表, 支持多个域名且为前缀匹配, 支持带端口的域名和 IP, 支持通配符*,做二级域名或多级域名的通配request.domainList = ["*.com","*.qq.com"];
// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = "examplebucket-1250000000";
request.finishBlock = {(result,error) in if (error != nil){ // 添加防盗链失败 }else{ // 添加防盗链失败 }}QCloudCOSXMLService.defaultCOSXML().putBucketReferer(request);
说明更多完整示例,请前往 GitHub 查看。
查询存储桶 Referer
功能说明
查询指定存储桶 Referer 白名单或者黑名单(GET Bucket referer)。注意COS iOS SDK 版本需要大于等于 v5.9.6。
请求示例
Objective-C
QCloudGetBucketRefererRequest* request = [QCloudGetBucketRefererRequest new];
// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = @"examplebucket-1250000000";
[request setFinishBlock:^(QCloudBucketRefererInfo * outputObject, NSError *error) { // outputObject 请求到的防盗链,详细字段请查看api文档或者SDK源码 // QCloudBucketRefererInfo 类;}];[[QCloudCOSXMLService defaultCOSXML] GetBucketReferer:request];
说明更多完整示例,请前往 GitHub 查看。Swift
let request = QCloudGetBucketRefererRequest.init();
// 存储桶名称,格式为 BucketName-APPIDrequest.bucket = "examplebucket-1250000000";
request.finishBlock = {(result,error) in // outputObject 请求到的防盗链,详细字段请查看api文档或者SDK源码 // QCloudBucketRefererInfo 类;}QCloudCOSXMLService.defaultCOSXML().getBucketReferer(request);
说明更多完整示例,请前往 GitHub 查看。
对象存储官网1折活动,限时活动,即将结束,速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折,更有现金返利。同意关联立享优惠
转转请注明出处:https://www.yunxiaoer.com/145674.html