全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

设置时间戳+共享密钥防盗链

最近更新时间:2024-03-27 15:08:35

设置时间戳+共享密钥防盗链(SetLiveRequestAuthConfig)

接口描述

  • 用于设置时间戳+共享密钥防盗链

  • 创建域名时默认不开启时间戳+共享密钥防盗链功能

  • 调用方式:HTTP POST

  • 签名机制

    • Service取值:cdn

  • 接入地址:cdn.api.ksyun.com︎

请求参数

参数名

类型

是否必须

描述

DomainName

String

Y

域名名称

Enable

String

Y

配置是否开启或关闭取值:on、off,默认值为off关闭。开启时,下述必须项为必填项;关闭时,只更改此标识,忽略后面的项目

TimeName

String

Y

时间戳参数名

MD5Name

String

Y

MD5参数名

Key

Array

Y

第一个为主密钥,按照密钥顺序进行匹配,必须由大小写字母(a-Z)或者数字(0-9)组成,长度在6-128个字符之间 (注:key不能超过5个)

TimestampFormat

String

Y

UNIX: 十进制
HEX:十六进制

ExpirationTime

Long

N

过期时间,单位为“秒”,输入大于等于0的正整数,最大不要超过31536000;不输入则按参考时间戳;输入则按时间戳+自定义过期时间
参考时间戳默认当前时间,即当前时刻之后的流, 都可以鉴权通过;
时间戳+自定义过期时间,如设置 ExpirationTime = 600,当前时间14:00,则从13:50之后的流,都可以鉴权通过

MD5Hash

String

Y

MD5鉴权因子,取值范围为:
SecretKey,秘钥
ExpirationTime,过期时间
URI,例如:/aaa/test.com
URI2,不带开头和结尾的斜杠,如:aaa/test
QueryHost,请求头中的Host
URL,完整的URL,不包含参数,例如:http://cdn.com/aaa/test.flv
如,按 秘钥+过期时间+URI,MD5Hash=SecretKey|ExpirationTime|URI

MD5SumRangeStart

Int

N

MD5取值范围,最小值。最小值和最大值必须同时设置,如果都不设置则全部截取

MD5SumRangeEnd

Int

N

MD5取值范围,最大值。最小值和最大值必须同时设置,如果都不设置则全部截取

请求示例

POST /?Action=SetLiveRequestAuthConfig&Version=2016-09-01 HTTP/1.1
Content-Type: application/json
X-Amz-Date: YOURDATE
Authorization: authorization string
Host: cdn.api.ksyun.com

{
      "DomainName": "zjp3.ksyun.com",
      "Enable": "on",
      "TimeName": "mytime",
      "MD5Name": "mymd5",
      "Key": [
                 "aa223311dd",
                 "bb223322cc"
       ],
      "TimestampFormat": "HEX",
      "ExpirationTime": 700,
      "MD5Hash": "SecretKey|ExpirationTime|URI",
      "MD5SumRangeStart": 2,
      "MD5SumRangeEnd": 19
}

返回示例

{
        "RequestId": "96cb2935d1084b9cb0da1e5201bdd7e4"
}

错误码

此接口为CDN接口,请到使用须知查看错误码详情。

文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈