全部文档
当前文档

暂无内容

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

文档中心

设置过滤参数

最近更新时间:2026-01-07 20:09:20

SetIgnoreQueryStringConfig

描述

本接口用于设置过滤参数功能。
过滤参数:指忽略URL请求中?之后的参数,提高CDN缓存的命中率

注意:

加速域名创建后,默认开启过滤参数功能。

请求语法

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

请求参数

参数名

必选

类型及范围

说明

DomainId

String

域名ID

Enable

String

配置过滤参数的开启或关闭 取值:on、off ,默认为on 。

HashKeyArgs

String

保留参数,多个用逗号(英文、半角)分隔。

Type

String

过滤参数类型
取值:block:删除部分参数;allow:保留部分参数;
当type参数填写是,hashkeyargs必填,否则报错

示例

请求示例

GET方式:

GET /V3/SetIgnoreQueryStringConfig?DomainId=2D08M8V&Enable=on&HashKeyArgs=tklink
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: SetIgnoreQueryStringConfig
x-version: V3

POST方式:

POST /V3/SetIgnoreQueryStringConfig
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: SetIgnoreQueryStringConfig
x-version: V3
Content-Type: application/x-www-form-urlencoded

{
    "DomainId": "2D08M8V",
    "Enable": "on",
    "HashKeyArgs":"tklink"
}

返回示例

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

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

纯净模式

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