开发者社区 问答 正文

如何设置过滤参数?



SetIgnoreQueryStringConfig



描述


设置过滤参数功能

请求参数

参数类型必须?描述
ActionString操作接口名,系统规定参数,取值:SetIgnoreQueryStringConfig
DomaiNameString您的加速域名
EnableString配置过滤参数功能的开启或关闭 取值:On、Off
HashKeyArgsString保留参数,多个用逗号(英文、半角)分隔,最多配置10个保留参数


返回参数

名称类型描述
RequestIDString该条任务请求ID


特殊错误码

错误代码描述Http 状态码语义
InvalidEnable.ValueNotSupportedThe specified value of parameter Enable is not supported.400指定的 Enable 不合法(超出可选范围)
InvalidHashKeyArgs.ValueNotSupportedAt most 10 HashKeyArgs are supported.400最多配置10个保留参数


示例


请求示例: http://cdn.aliyuncs.com/?Action=SetIgnoreQueryStringConfig
&Enable=on
&DomainName=www.macaron.org.cn
&<公共请求参数>


返回示例
JSON格式: {
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}


XML格式: <SetIgnoreQueryStringConfigResponse>
    <RequestId>AED00EC1-32A8-4D48-BEB9-BD782AF3C6BD</RequestId>
</SetIgnoreQueryStringConfigResponse>

展开
收起
青衫无名 2017-10-24 10:32:56 2619 分享 版权
阿里云 AI 助理回答

您提到的是阿里云CDN(内容分发网络)服务中的一项配置功能——SetIgnoreQueryStringConfig,该功能用于设置是否忽略URL中的查询字符串参数来缓存资源。当用户访问带有不同查询字符串的相同URL时,开启此功能可以决定CDN是否将这些请求视为同一资源并使用相同的缓存版本,或者根据不同的查询字符串提供不同的缓存内容。下面是关于这个接口更详细的说明和使用指导:

功能描述

  • 开启或关闭过滤参数功能:通过修改Enable参数为OnOff,您可以控制CDN是否忽略URL中的查询字符串来缓存内容。如果开启(On),则除了在HashKeyArgs中指定的保留参数外,其他查询字符串参数将被忽略,这有助于减少缓存变体,提高缓存命中率。
  • 保留参数配置:通过HashKeyArgs参数,您可以指定哪些查询字符串参数不应被忽略,即使开启了忽略查询字符串的功能,这些参数依然会被考虑进缓存的键值中,确保具有这些特定参数的请求能够正确地命中或生成独立的缓存副本。

请求示例

http://cdn.aliyuncs.com/
?Action=SetIgnoreQueryStringConfig
&DomaiName=your.cdn.domain.com
&Enable=On
&HashKeyArgs=query1,query2

在这个示例中: - Action=SetIgnoreQueryStringConfig 指定要执行的操作。 - DomaiName=your.cdn.domain.com 是您需要配置的加速域名。 - Enable=On 表示开启忽略查询字符串参数的缓存策略。 - HashKeyArgs=query1,query2 指定了两个保留的查询字符串参数,这两个参数在缓存时会被考虑。

注意事项

  • 确保您的请求符合API调用的格式要求,包括签名等安全措施。
  • 当配置HashKeyArgs时,注意最多只能配置10个保留参数,超出限制会返回错误。
  • 如果遇到InvalidEnable.ValueNotSupportedInvalidHashKeyArgs.ValueNotSupportedAtMost10HashKeyArgsAreSupported错误码,应检查Enable参数值是否合法(仅接受OnOff),以及确认HashKeyArgs数量不超过限制。

通过上述接口调用,您可以灵活管理CDN缓存策略,优化内容分发效率和用户体验。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答