文档中心 CDN API文档 域名详细配置 设置UA黑白名单

设置UA黑白名单

最近更新时间:2026-06-12 15:30:38

SetUaProtectionConfig

描述

设置加速域名的UA黑白名单功能,加速域名创建后,默认不开启UA黑白名单功能。

请求语法

本接口请求需要包含指定目录/2016-09-01/SetUaProtectionConfig、公共请求header和该接口所特有的请求参数,具体请求语句参照下文请求示例。

请求参数

参数名

必选

类型及范围

说明

DomainId

String

域名ID

Enable

String

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

UaType

String

Ua 黑白名单类型,取值:block:黑名单;allow:白名单,开启后必填

UaList

String

支持多个值,以 | 分隔,实际访问的 UA 匹配其中任何一个值都生效。例子:curl|IE|chrome|firefox(以 | 分隔),开启后必填

示例

请求示例

POST方式

POST /2016-09-01/SetUaProtectionConfig
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: SetUaProtection
Configx-version: 2016-09-01
Content-Type: application/json

{
  "DomainId":"2D08M8V",
  "Enable":"on",
  "UaType":"block",
  "UaList":"curl|IE|chrome|firefox"
}

返回示例

  • 说明:本接口调用成功只会返回200的状态码,无返回值,若调用失败,则会返回403/400状态码,400的具体错误原因详见【使用须知】中错误代码表说明

上一篇:设置IP黑白名单
下一篇:设置视频拖拽
以上内容是否对您有帮助?
有帮助
没帮助