SetRequestAuthConfig
描述
本接口用于设置加速域名的时间戳+共享密钥防盗链功能。
注意:
加速域名创建后,默认不开启时间戳+共享密钥防盗链功能。
请求语法
本接口请求需要包含指定目录/2016-09-01/domain/SetRequestAuthConfig、公共请求header和该接口所特有的请求参数,具体请求语句参照下文请求示例。
请求头
参数名
必选
类型及范围
说明
X-Version
是
String
版本号,取值:2016-09-01
X-Action
是
String
操作接口名,取值:SetRequestAuthConfig
请求参数
参数名
必选
类型及范围
说明
DomainId
是
String
域名ID
Enable
是
String
配置是否开启或关闭取值:on、off,默认值为off关闭。开启时,下述必须项为必填项;关闭时,只更改此标识,忽略后面的项目。
AuthType
是
String
防盗链类型,取值:typeA 、typeB;默认为typeA,开启后必填(两种类型说明见下)
Key1
是
String
主享密钥,必须由大小写字母(a-Z)或者数字(0-9)组成,长度在6-128个字符之间。
Key2
否
String
备享密钥,必须由大小写字母(a-Z)或者数字(0-9)组成,长度在6-128个字符之间。
ExpirationTime
是
Long
过期时间,单位为“秒”,输入大于等于0的正整数,最大不要超过31536000。
两种防盗链类型说明如下:
typeB(加密字符串 md5hash 和 时间戳 timestamp 都在URL的路径中,md5hash 在前时间戳在后):http://DomainName/md5hash/timestamp/FileName
标准配置说明如下:
对于标准配置来说,防盗链的 timestamp 为十进制unix时间戳,单位是秒,如:1566299655;计算 md5hash 值的方法都为:md5(秘钥+URI+时间戳)
以 URL http://selftest.com/main2.css 为例
若配置 typeA的防盗链,key是 aaaaaaaaaaa ,timestamp 是 1566299655,其 URI是 /main2.css
那么 md5hash = md5(aaaaaaaaaaa/main2.css1566299655)= 2f24a0858b44959f095c7c7eb41c114d
示例
请求示例
GET方式:
GET /2016-09-01/domain/SetRequestAuthConfig?DomainId=2D09XC0&Enable=on& AuthType=typeA& Key1=qwerqyt& ExpirationTime=3600
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: SetRequestAuthConfig
x-version: 2016-09-01
POST方式:
POST /2016-09-01/domain/SetRequestAuthConfig
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: SetRequestAuthConfig
x-version: 2016-09-01
Content-Type: application/json
{
"DomainId":"2D08M8V",
"Enable":"on",
"AuthType":"typeA",
"Key1":"qwerqyt",
"ExpirationTime":"3600"
}
返回示例
说明:本接口调用成功只会返回200的状态码,无返回值,若调用失败,则会返回403/400状态码,400的具体错误原因详见【使用须知】中错误代码表说明