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

调试

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

请求参数

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

操作接口名,系统规定参数。取值:SetRefererConfig

DomainName String www.yourdomain.com

您的加速域名。

ReferType String block

refer类型。取值:

  • block:黑名单。
  • allow:白名单。
DisableAst String off

是否精确匹配域名。取值:

  • on:精确匹配,不自动匹配子域名。
  • off:模糊匹配,自动匹配子域名。
  • 默认值:off
AllowEmpty String on

是否允许空refer访问。取值:

  • on:允许。
  • off:不允许。

默认值:on

ReferList String a.com,b.com

逗号(,)隔开的域名列表。

返回数据

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

请求ID

示例

请求示例

http://cdn.aliyuncs.com/?Action=SetRefererConfig
&DomainName=example.com
&ReferList=example.com%2Cexample1.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。

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