调用SetRefererConfig设置加速域名的Referer防盗链功能。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SetRefererConfig

操作接口名，系统规定参数。取值：SetRefererConfig。

DomainName String 是 example.com

您的加速域名，多个用逗号（,）隔开。
ReferType String 是 block

Referer类型。

  • block：黑名单。
  • allow：白名单。
DisableAst String 否 off

是否精确匹配域名。

  • on：精确匹配，不自动匹配子域名。
  • off（默认值）：模糊匹配，自动匹配子域名。
AllowEmpty String 否 on

是否允许空Referer访问。

  • on（默认值）：允许。
  • off：不允许。
ReferList String 否 example.aliyundoc.com,demo.aliyundoc.com

要设置的黑白名单域名列表，多个用逗号（,）隔开。

返回数据

名称 类型 示例值 描述
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

http://cdn.aliyuncs.com/?Action=SetRefererConfig
&DomainName=example.com
&ReferList=example.aliyundoc.com,demo.aliyundoc.com
&ReferType=allow
&AllowEmpty=on
&<公共请求参数>

正常返回示例

XML格式 

<SetRefererConfigResponse>
      <RequestId>AED00EC1-32A8-4D48-BEB9-BD782AF3C6BD</RequestId>
</SetRefererConfigResponse>

JSON格式 

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidReferType.ValueNotSupported The specified value of parameter ReferType is not supported. 指定的ReferType类型不合法，超出可选范围。取值：block：黑名单；allow：白名单。
400 InvalidAllowEmpty.ValueNotSupported The specified value of parameter AllowEmpty is not supported. 指定的refer是否允许为空不合法，超出可选范围。
400 InvalidReferList.Malformed The specified value of parameter ReferList is malformed. 指定的域名列表ReferList不合法，格式错误。
400 InvalidDisableAst.ValueNotSupported The specified value of parameter DisableAst is not supported. 不支持参数DisableAst。

访问错误中心查看更多错误码。