tencentcloud-sdk-teo 3.0.1116 → 3.0.1119

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 65128d59bc59028f618b0cedaa26655b906822b2
-  data.tar.gz: 8bfeb705ce03eb4c1f3997c29d1540883d74b6fc
+  metadata.gz: 808095214a0935070c56df2dfab4d4a5ee52b6f9
+  data.tar.gz: 51323d3891116928fe5b50edbc41f8df74581d2f
 SHA512:
-  metadata.gz: 817ec358d68cda9e4a3e0199d9e989d930e2ab27afd8a7f6fe93584cac23e6e50d96e29cc72f86df7ce67995e3cf19fbaf1e3d2313b8a7029efaa46ddc73576d
-  data.tar.gz: 68584cf681ffdffd85bbb701c936182f1e12326cca33fc9cae40b60a6fdc46ce268bf8e2a8d50078d1c304b435d9b05a69fbe4497a3ec26da3aaeeab0075ad19
+  metadata.gz: b390a32eb4f875931c1a8a00fcc16beb88feefbf372a6cef60cf6b799463315837c713e2dd47d8c552c102279014d85c3e30c3498db609d232932e9eb7458b13
+  data.tar.gz: 6cdc72f6d1ecd1e585bb0fe3c203f7b628775355c7fa00a46c0afcb70583365e509405876617fbbfeb7444e800d5af02f4d7267d8ea1d79cfed4210f257337af

data/lib/VERSION

@@ -1 +1 @@
-3.0.1116
+3.0.1119

data/lib/v20220901/client.rb

@@ -3009,7 +3009,10 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 本接口查询七层域名业务的时序数据。请注意本接口查询数据有 10 分钟左右延迟，建议拉取当前时间 10 分钟以前的数据。
+        # 本接口用于查询七层域名业务的时序数据。
+        # 注意：
+        # 1. 本接口查询数据有 10 分钟左右延迟，建议拉取当前时间 10 分钟以前的数据。
+        # 2. 本接口默认返回防护后的流量请求数据，用户可在 `Filters.mitigatedByWebSecurity` 中自定义查询已防护缓释的数据。
 
         # @param request: Request instance for DescribeTimingL7AnalysisData.
         # @type request: :class:`Tencentcloud::teo::V20220901::DescribeTimingL7AnalysisDataRequest`
@@ -3057,7 +3060,10 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 本接口用于查询七层域名业务按照指定维度的 topN 数据。请注意本接口查询数据有 10 分钟左右延迟，建议拉取当前时间 10 分钟以前的数据。
+        # 本接口用于查询七层域名业务按照指定维度的 topN 数据。
+        # 注意：
+        # 1. 本接口查询数据有 10 分钟左右延迟，建议拉取当前时间 10 分钟以前的数据。
+        # 2. 本接口默认返回防护后的流量请求数据，用户可在 `Filters.mitigatedByWebSecurity` 中自定义查询已防护缓释的数据。
 
         # @param request: Request instance for DescribeTopL7AnalysisData.
         # @type request: :class:`Tencentcloud::teo::V20220901::DescribeTopL7AnalysisDataRequest`

data/lib/v20220901/models.rb

@@ -10272,27 +10272,10 @@ module TencentCloud
         # <li>hour: 1小时；</li>
         # <li>day: 1天。</li>不填将根据开始时间跟结束时间的间距自动推算粒度，具体为：2 小时范围内以 min 粒度查询，2 天范围内以 5min 粒度查询，7 天范围内以 hour 粒度查询，超过 7 天以 day 粒度查询。
         # @type Interval: String
-        # @param Filters: 过滤条件，详细的过滤条件 Key 值如下：
-        # <li>country：按照国家/地区进行过滤，国家/地区遵循 <a href="https://baike.baidu.com/item/ISO%203166-1/5269555">ISO 3166-1 alpha-2</a> 规范。示例值：CN。</li>
-        # <li>province：按照省份进行过滤，此参数只支持服务区域为中国大陆。省份代码参考<a href="https://cloud.tencent.com/document/product/228/6316#.E5.8C.BA.E5.9F.9F-.2F-.E8.BF.90.E8.90.A5.E5.95.86.E6.98.A0.E5.B0.84.E8.A1.A8">境内省份映射表</a>，示例值：22。</li>
-        # <li>isp：按照运营商进行过滤，此参数只支持服务区域为中国大陆。对应的 Value 可选项如下：<br>   2：中国电信；<br>   26：中国联通；<br>   1046：中国移动；<br>   3947：中国铁通；<br>   38：教育网；<br>   43：长城宽带；<br>   0：其他运营商。</li>
-        # <li>domain：按照子域名进行过滤，示例值： www.example.com。</li>
-        # <li>url：按照 URL Path 进行过滤，示例值：/content 或 /content/test.jpg。若填写 url 参数，则最多可查询近 30 天的数据。</li>
-        # <li>referer：按照 Referer 请求头部进行过滤，示例值：http://www.example.com/。若填写 referer 参数，则最多可查询近 30 天的数据；</li>
-        # <li>resourceType：按照资源类型进行过滤，资源类型一般是文件后缀，示例值：.jpg。若填写 resourceType 参数，则最多可查询近 30 天的数据；</li>
-        # <li>protocol：按照 HTTP 协议版本进行过滤。对应的 Value 可选项如下：<br>   HTTP/1.0；<br>   HTTP/1.1；<br>   HTTP/2.0；<br>   HTTP/3；<br>   WebSocket。</li>
-        # <li>socket：按照 HTTP协议类型进行过滤。对应的 Value 可选项如下：<br>   HTTP：HTTP 协议；<br>   HTTPS：HTTPS 协议；<br>   QUIC：QUIC 协议。</li>
-        # <li>statusCode：按照边缘状态码进行过滤。若填写 statusCode 参数，则最多可查询近 30 天的数据。对应的 Value 可选项如下：<br>   1XX：1xx类型的状态码；<br>   2XX：2xx类型的状态码；<br>   3XX：3xx类型的状态码；<br>   4XX：4xx类型的状态码；<br>   5XX：5xx类型的状态码；<br>   在 [0,600) 范围内的整数。</li>
-        # <li>browserType：按照浏览器类型进行过滤。若填写 browserType 参数，则最多可查询近 30 天的数据。对应 Value 的可选项如下：<br>   Firefox：Firefox浏览器；<br>   Chrome：Chrome浏览器；<br>   Safari：Safari浏览器；<br>   Other：其他浏览器类型；<br>   Empty：浏览器类型为空；<br>   Bot：搜索引擎爬虫；<br>   MicrosoftEdge：MicrosoftEdge浏览器；<br>   IE：IE浏览器；<br>   Opera：Opera浏览器；<br>   QQBrowser：QQ浏览器；<br>   LBBrowser：LB浏览器；<br>   MaxthonBrowser：Maxthon浏览器；<br>   SouGouBrowser：搜狗浏览器；<br>   BIDUBrowser：百度浏览器；<br>   TaoBrowser：淘浏览器；<br>   UBrowser：UC浏览器。</li>
-        # <li>deviceType：按照设备类型进行过滤。若填写 deviceType 参数，则最多可查询近 30 天的数据。对应 Value 的可选项如下：<br>   TV：TV设备；<br>   Tablet：Tablet设备；<br>   Mobile：Mobile设备；<br>   Desktop：Desktop设备；<br>   Other：其他设备类型；<br>   Empty：设备类型为空。</li>
-        # <li>operatingSystemType：按照操作系统类型进行过滤。若填写 operatingSystemType 参数，则最多可查询近 30 天的数据。对应 Value 的可选项如下：<br>   Linux：Linux操作系统；<br>   MacOS：MacOs操作系统；<br>   Android：Android操作系统；<br>   IOS：IOS操作系统；<br>   Windows：Windows操作系统；<br>   NetBSD：NetBSD；<br>   ChromiumOS：ChromiumOS；<br>   Bot：搜索引擎爬虫；<br>   Other：其他类型的操作系统；<br>   Empty：操作系统为空。</li>
-        # <li>tlsVersion：按照 TLS 版本进行过滤。若填写 tlsVersion 参数，则最多可查询近 30 天的数据。对应 Value 的可选项如下：<br>   TLS1.0；<br>   TLS1.1；<br>   TLS1.2；<br>   TLS1.3。</li>
-        # <li>ipVersion：按照 IP 版本进行过滤。对应 Value 的可选项如下：<br>   4：IPv4；<br>   6：IPv6。</li>
-        # <li>cacheType：按照缓存状态进行过滤。对应 Value 的可选项如下：<br>   hit：请求命中 EdgeOne 节点缓存，资源由节点缓存提供。资源部分命中缓存也会记录为 hit。<br>   miss：请求未命中 EdgeOne 节点缓存，资源由源站提供。<br>   dynamic：请求的资源无法缓存/未配置被节点缓存，资源由源站提供。<br>   other：无法被识别的缓存状态。边缘函数响应的请求会记录为 other。</li>
-        # <li>clientIp：按照客户端 IP 进行过滤。若填写 clientIp 参数，则最多可查询近 30 天的数据。</li>
-        # <li>userAgent：按照 User-Agent 请求头部进行过滤。若填写 userAgent 参数，则最多可查询近 30 天的数据。</li>
+        # @param Filters: 筛选数据时使用的过滤条件，取值参考 [指标分析筛选条件说明](https://cloud.tencent.com/document/product/1552/98219#1aaf1150-55a4-4b4d-b103-3a8317ac7945) 中针对 L7 访问流量、带宽、请求数的可用筛选项。
+        # 如需限定站点或内容标识符，请在 `ZoneIds.N` 参数中另行传入对应的值。
         # @type Filters: Array
-        # @param Area: 数据归属地区。该参数已废弃。请在 Filters.country 中按客户端地域过滤数据。
+        # @param Area: 数据归属地区。该参数已废弃。请在 `Filters.country` 中按客户端地域过滤数据。
         # @type Area: String
 
         attr_accessor :StartTime, :EndTime, :MetricNames, :ZoneIds, :Interval, :Filters, :Area
@@ -10484,39 +10467,17 @@ module TencentCloud
         # <li> l7Flow_request_ua_browser：按浏览器类型维度统计 L7 访问请求数指标；</li>
         # <li> l7Flow_request_ua_os：按操作系统类型维度统计 L7 访问请求数指标；</li>
         # <li> l7Flow_request_ua：按 User-Agent 维度统计 L7 访问请求数指标。</li>
-
         # @type MetricName: String
         # @param ZoneIds: 站点 ID 集合，此参数必填。最多传入 100 个站点 ID。若需查询腾讯云主账号下所有站点数据，请用 `*` 代替，查询账号级别数据需具备本接口全部站点资源权限。
         # @type ZoneIds: Array
         # @param Limit: 查询前多少个 top 数据，最大值为1000。不填默认为10，表示查询 top10 的数据。
         # @type Limit: Integer
-        # @param Filters: 过滤条件，详细的过滤条件 Key 值如下：
-        # <li>country：按照国家/地区进行过滤，国家/地区遵循 <a href="https://baike.baidu.com/item/ISO%203166-1/5269555">ISO 3166-1 alpha-2</a> 规范。示例值：CN。</li>
-        # <li>province：按照省份进行过滤，此参数只支持服务区域为中国大陆。省份代码参考<a href="https://cloud.tencent.com/document/product/228/6316#.E5.8C.BA.E5.9F.9F-.2F-.E8.BF.90.E8.90.A5.E5.95.86.E6.98.A0.E5.B0.84.E8.A1.A8">境内省份映射表</a>，示例值：22。</li>
-        # <li>isp：按照运营商进行过滤，此参数只支持服务区域为中国大陆。对应的 Value 可选项如下：<br>   2：中国电信；<br>   26：中国联通；<br>   1046：中国移动；<br>   3947：中国铁通；<br>   38：教育网；<br>   43：长城宽带；<br>   0：其他运营商。</li>
-        # <li>domain：按照子域名进行过滤，示例值： www.example.com。</li>
-        # <li>url：按照 URL Path 进行过滤，示例值：/content 或 /content/test.jpg。若填写 url 参数，则最多可查询近 30 天的数据。</li>
-        # <li>referer：按照 Referer 请求头部进行过滤，示例值：http://www.example.com/。若填写 referer 参数，则最多可查询近 30 天的数据；</li>
-        # <li>resourceType：按照资源类型进行过滤，资源类型一般是文件后缀，示例值：.jpg。若填写 resourceType 参数，则最多可查询近 30 天的数据；</li>
-        # <li>protocol：按照 HTTP 协议版本进行过滤。对应的 Value 可选项如下：<br>   HTTP/1.0；<br>   HTTP/1.1；<br>   HTTP/2.0；<br>   HTTP/3；<br>   WebSocket。</li>
-        # <li>socket：按照 HTTP协议类型进行过滤。对应的 Value 可选项如下：<br>   HTTP：HTTP 协议；<br>   HTTPS：HTTPS 协议；<br>   QUIC：QUIC 协议。</li>
-        # <li>statusCode：按照边缘状态码进行过滤。若填写 statusCode 参数，则最多可查询近 30 天的数据。对应的 Value 可选项如下：<br>   1XX：1xx类型的状态码；<br>   2XX：2xx类型的状态码；<br>   3XX：3xx类型的状态码；<br>   4XX：4xx类型的状态码；<br>   5XX：5xx类型的状态码；<br>   在 [0,600) 范围内的整数。</li>
-        # <li>browserType：按照浏览器类型进行过滤。若填写 browserType 参数，则最多可查询近 30 天的数据。对应 Value 的可选项如下：<br>   Firefox：Firefox浏览器；<br>   Chrome：Chrome浏览器；<br>   Safari：Safari浏览器；<br>   Other：其他浏览器类型；<br>   Empty：浏览器类型为空；<br>   Bot：搜索引擎爬虫；<br>   MicrosoftEdge：MicrosoftEdge浏览器；<br>   IE：IE浏览器；<br>   Opera：Opera浏览器；<br>   QQBrowser：QQ浏览器；<br>   LBBrowser：LB浏览器；<br>   MaxthonBrowser：Maxthon浏览器；<br>   SouGouBrowser：搜狗浏览器；<br>   BIDUBrowser：百度浏览器；<br>   TaoBrowser：淘浏览器；<br>   UBrowser：UC浏览器。</li>
-        # <li>deviceType：按照设备类型进行过滤。若填写 deviceType 参数，则最多可查询近 30 天的数据。对应 Value 的可选项如下：<br>   TV：TV设备；<br>   Tablet：Tablet设备；<br>   Mobile：Mobile设备；<br>   Desktop：Desktop设备；<br>   Other：其他设备类型；<br>   Empty：设备类型为空。</li>
-        # <li>operatingSystemType：按照操作系统类型进行过滤。若填写 operatingSystemType 参数，则最多可查询近 30 天的数据。对应 Value 的可选项如下：<br>   Linux：Linux操作系统；<br>   MacOS：MacOs操作系统；<br>   Android：Android操作系统；<br>   IOS：IOS操作系统；<br>   Windows：Windows操作系统；<br>   NetBSD：NetBSD；<br>   ChromiumOS：ChromiumOS；<br>   Bot：搜索引擎爬虫；<br>   Other：其他类型的操作系统；<br>   Empty：操作系统为空。</li>
-        # <li>tlsVersion：按照 TLS 版本进行过滤。若填写 tlsVersion 参数，则最多可查询近 30 天的数据。对应 Value 的可选项如下：<br>   TLS1.0；<br>   TLS1.1；<br>   TLS1.2；<br>   TLS1.3。</li>
-        # <li>ipVersion：按照 IP 版本进行过滤。对应 Value 的可选项如下：<br>   4：IPv4；<br>   6：IPv6。</li>
-        # <li>cacheType：按照缓存状态进行过滤。对应 Value 的可选项如下：<br>   hit：请求命中 EdgeOne 节点缓存，资源由节点缓存提供。资源部分命中缓存也会记录为 hit。<br>   miss：请求未命中 EdgeOne 节点缓存，资源由源站提供。<br>   dynamic：请求的资源无法缓存/未配置被节点缓存，资源由源站提供。<br>   other：无法被识别的缓存状态。边缘函数响应的请求会记录为 other。</li>
-        # <li>clientIp：按照客户端 IP 进行过滤。若填写 clientIp 参数，则最多可查询近 30 天的数据。</li>
-        # <li>userAgent：按照 User-Agent 请求头部进行过滤。若填写 userAgent 参数，则最多可查询近 30 天的数据。</li>
+        # @param Filters: 筛选数据时使用的过滤条件，取值参考 [指标分析筛选条件说明](https://cloud.tencent.com/document/product/1552/98219#1aaf1150-55a4-4b4d-b103-3a8317ac7945) 中针对 L7 访问流量、带宽、请求数的可用筛选项。
+        # 如需限定站点或内容标识符，请在 `ZoneIds.N` 参数中另行传入对应的值。
         # @type Filters: Array
-        # @param Interval: 查询时间粒度，取值有：
-        # <li>min: 1分钟；</li>
-        # <li>5min: 5分钟；</li>
-        # <li>hour: 1小时；</li>
-        # <li>day: 1天。</li>不填将根据开始时间跟结束时间的间距自动推算粒度，具体为：2 小时范围内以 min 粒度查询，2 天范围内以 5min 粒度查询，7 天范围内以 hour 粒度查询，超过 7 天以 day 粒度查询。
+        # @param Interval: 查询时间粒度，该参数无效，待废弃。
         # @type Interval: String
-        # @param Area: 数据归属地区。该参数已废弃。请在 Filters.country 中按客户端地域过滤数据。
+        # @param Area: 数据归属地区。该参数已废弃。请在 `Filters.country` 中按客户端地域过滤数据。
         # @type Area: String
 
         attr_accessor :StartTime, :EndTime, :MetricName, :ZoneIds, :Limit, :Filters, :Interval, :Area
@@ -12346,6 +12307,45 @@ module TencentCloud
         end
       end
 
+      # 高频扫描防护配置选项，当某一访客的请求频繁命中「配置为拦截」的托管规则时，在一段时间内封禁该访客所有请求。
+      class FrequentScanningProtection < TencentCloud::Common::AbstractModel
+        # @param Enabled: 高频扫描防护规则是否开启。取值有：<li>on：开启，高频扫描防护规则生效；</li><li>off：关闭，高频扫描防护规则不生效。</li>
+        # @type Enabled: String
+        # @param Action: 高频扫描防护的处置动作。 当 Enabled 为 on 时，此字段必填。SecurityAction 的 Name 取值支持：<li>Deny：拦截，响应拦截页面；</li><li>Monitor：观察，不处理请求记录安全事件到日志中；</li><li>JSChallenge：JavaScript 挑战，响应 JavaScript 挑战页面。</li>
+        # @type Action: :class:`Tencentcloud::Teo.v20220901.models.SecurityAction`
+        # @param CountBy: 请求统计的匹配方式，当 Enabled 为 on 时，此字段必填。取值有：<li>http.request.xff_header_ip：客户端 IP（优先匹配 XFF 头部）；</li><li>http.request.ip：客户端 IP。</li>
+        # @type CountBy: String
+        # @param BlockThreshold: 此参数指定高频扫描防护的阈值，即在 CountingPeriod 所设置时间范围内命中「配置为拦截」的托管规则时的累计拦截次数，取值范围 1 ~ 4294967294，例如 100，当超过此统计值时，后续请求将触发 Action 所设置的处置动作。当 Enabled 为 on 时，此字段必填。
+        # @type BlockThreshold: Integer
+        # @param CountingPeriod: 此参数指定高频扫描防护所统计的时间窗口，即命中「配置为拦截」的托管规则的请求的统计时间窗口，取值 5 ~ 1800，单位仅支持秒（s），例如 5s。 当 Enabled 为 on 时，此字段必填。
+        # @type CountingPeriod: String
+        # @param ActionDuration: 此参数指定高频扫描防护 Action 参数所设置处置动作的持续时长，取值范围 60 ~ 86400，单位仅支持秒（s），例如 60s。当 Enabled 为 on 时，此字段必填。
+        # @type ActionDuration: String
+
+        attr_accessor :Enabled, :Action, :CountBy, :BlockThreshold, :CountingPeriod, :ActionDuration
+
+        def initialize(enabled=nil, action=nil, countby=nil, blockthreshold=nil, countingperiod=nil, actionduration=nil)
+          @Enabled = enabled
+          @Action = action
+          @CountBy = countby
+          @BlockThreshold = blockthreshold
+          @CountingPeriod = countingperiod
+          @ActionDuration = actionduration
+        end
+
+        def deserialize(params)
+          @Enabled = params['Enabled']
+          unless params['Action'].nil?
+            @Action = SecurityAction.new
+            @Action.deserialize(params['Action'])
+          end
+          @CountBy = params['CountBy']
+          @BlockThreshold = params['BlockThreshold']
+          @CountingPeriod = params['CountingPeriod']
+          @ActionDuration = params['ActionDuration']
+        end
+      end
+
       # 边缘函数详情
       class Function < TencentCloud::Common::AbstractModel
         # @param FunctionId: 函数 ID。
@@ -14194,15 +14194,18 @@ module TencentCloud
         # @type AutoUpdate: :class:`Tencentcloud::Teo.v20220901.models.ManagedRuleAutoUpdate`
         # @param ManagedRuleGroups: 托管规则组的配置。如果此结构传空数组或 GroupId 未包含在列表内将按照默认方式处理。
         # @type ManagedRuleGroups: Array
+        # @param FrequentScanningProtection: 高频扫描防护配置选项，当某一访客的请求频繁命中「配置为拦截」的托管规则时，在一段时间内封禁该访客所有请求。
+        # @type FrequentScanningProtection: :class:`Tencentcloud::Teo.v20220901.models.FrequentScanningProtection`
 
-        attr_accessor :Enabled, :DetectionOnly, :SemanticAnalysis, :AutoUpdate, :ManagedRuleGroups
+        attr_accessor :Enabled, :DetectionOnly, :SemanticAnalysis, :AutoUpdate, :ManagedRuleGroups, :FrequentScanningProtection
 
-        def initialize(enabled=nil, detectiononly=nil, semanticanalysis=nil, autoupdate=nil, managedrulegroups=nil)
+        def initialize(enabled=nil, detectiononly=nil, semanticanalysis=nil, autoupdate=nil, managedrulegroups=nil, frequentscanningprotection=nil)
           @Enabled = enabled
           @DetectionOnly = detectiononly
           @SemanticAnalysis = semanticanalysis
           @AutoUpdate = autoupdate
           @ManagedRuleGroups = managedrulegroups
+          @FrequentScanningProtection = frequentscanningprotection
         end
 
         def deserialize(params)
@@ -14221,6 +14224,10 @@ module TencentCloud
               @ManagedRuleGroups << managedrulegroup_tmp
             end
           end
+          unless params['FrequentScanningProtection'].nil?
+            @FrequentScanningProtection = FrequentScanningProtection.new
+            @FrequentScanningProtection.deserialize(params['FrequentScanningProtection'])
+          end
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-teo
 version: !ruby/object:Gem::Version
-  version: 3.0.1116
+  version: 3.0.1119
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-08-03 00:00:00.000000000 Z
+date: 2025-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common