配置忽略参数
所有文档

          内容分发网络 CDN

          配置忽略参数

          概述

          HTTP请求参数是指URL中“?”后面的部分,您可以使用忽略参数缓存灵活的控制请求参数是否参与资源的缓存与查找,提高CDN的缓存命中率。

          注意事项

          开启此功能可忽略URL参数参与缓存,提高文件缓存命中率,也有可能略过Key的重要信息,请根据业务需要合理设置。

          配置忽略参数

          1. 登录CDN管理控制台,进入“内容分发网络CDN”页面。
          2. 在左侧导航栏,点击域名管理
          3. 进入域名管理页面,点击目标域名操作列的管理
          4. 进入“CDN域名详情”页,在页面上方导航栏选择缓存配置页签。
          5. 忽略参数模块中点击编辑,按照下表说明设置忽略URL参数。
          忽略URL参数状态说明
          全部忽略在CDN生成和查找资源的缓存时,会去除URL中 ? 之后的部分。即PATH相同但请求参数不同的请求,会被CDN视为同一资源。
          • 如果分发的内容为静态资源,且URL中的HTTP请求参数不会影响响应内容,开启该功能可以有效提高文件缓存命中率,提升分发效率。
          • 若参数有重要含义,例如包含文件版本信息等,推荐设置“保留参数”。您也可以设置多个保留参数。如请求中包含任一“保留参数”,会携保留参数回源,未指定的参数将不会被保留。
          不忽略所有HTTP请求参数会参与缓存的存储和查找,带有不同请求参数的URL,即便PATH部分相同也会被视为不同资源。
          保留指定参数指定的部分参数参与缓存的存储和查找。
          忽略指定参数除了指定的部分参数外的其他参数参与缓存的存储和查找。
          1. 您可以在开启中设置保留参数,配置完点击保存即可完成忽略参数的配置。

          注:保留/忽略指定参数最多输入10个,多个参数逗号隔开,未指定的参数将不会被保留。

          配置举例

          例如我们设定 http://www.bcecdn.com/1.jpg?test=1 请求URL到CDN节点:

          • 配置全部忽略

            • 用户第一次访问http://www.bccdn.com/1.jpg,CDN没有缓存,直接回源访问数据;第二次访问http://www.bccdn.com/1.jpg?test=1,由于开启了过滤参数,所以“?”后的参数无需匹配,即可命中CDN缓存http://www.bccdn.com/1.jpg
          • 配置保留参数test

            • 带有不同test参数的请求,即便PATH部分相同,也会被视为不同资源。例如:请求http://www.bccdn.com/1.jpg?test=1http://www.bccdn.com/1.jpg?test=2 会被CDN视为不同的资源。
            • 其他未指定的保留参数则会被忽略,例如:请求http://www.bccdn.com/1.jpg?class=1http://www.bccdn.com/1.jpg?class=2会被CDN视为同一资源。
          • 配置忽略指定参数test

            • 如果两个请求只是test参数不同,仍然会被CDN视为同一资源。例如:http://www.bccdn.com/1.jpg?test=1http://www.bccdn.com/1.jpg?test=2 会被CDN视为同一资源。
            • 除了test外的其他参数不同的请求,都会被视为不同资源。例如:请求http://www.bccdn.com/1.jpg?class=1http://www.bccdn.com/1.jpg?class=2会被CDN视为不同的资源。
          • 如果选择不忽略,则HTTP请求参数不同的请求都会CDN被视为不同资源。
          上一篇
          配置缓存过期时间
          下一篇
          设置错误码页面自定义