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的具体错误原因详见【使用须知】中错误代码表说明