tencentcloud-sdk-teo 3.0.1188 → 3.0.1201

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 98e4a639cddbe7c17c7389b0428370d422f18286
-  data.tar.gz: af3b51de158bbbf68679157345706f2df613ff1e
+  metadata.gz: af85f3c4af40ce3c3a55e4e33c434e03a235577e
+  data.tar.gz: 0e2f64b26864e20e43e1607e0c91c67eb3285da7
 SHA512:
-  metadata.gz: 5f38059eb8647f2f8c7acfa89ae475da3c090fa12aeb45e0fba76dc56affe53d1a9353f809d92e2168f10cb04fa5c09f8c9f2cd6129d3ee3c08568bec877ca36
-  data.tar.gz: c723431d05515a501c7afcb4edba873ca4e60f1f3b9a7c5dc51fb726114ed44b1b691762270d6a76a4148ce2b8035480afb0c94ffd5f8a83c6c65d15fc055177
+  metadata.gz: 98535b7843e3dceef9bd25c7bdd23d4b933fce5d79113f22879ec6dd4ac0fcaa5d31242bca1360919d00e43fc5d8640a7cd7bd66d43b4b9786cac7fc176cb724
+  data.tar.gz: ec0206d6a699e1ca26325ebcd658e363e69d4e63480998e9cc45b836cd1847385615fbd870971f963c52950764744e2196c62a53ccdecac911a2273b005e0d07

data/lib/VERSION

@@ -1 +1 @@
-3.0.1188
+3.0.1201

data/lib/v20220901/client.rb

@@ -3192,7 +3192,66 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 本接口用以查询七层域名业务的回源时序数据。
+        # 本接口用以查询七层域名业务的回源时序数据，可以通过指定查询维度 <code>DimensionName</code> 进行分组查询，返回多组时序数据。
+
+        # <p>单次请求最多返回 <strong>50,000</strong> 个数据项<code> TimingDataItem </code>。数据项总数的计算规则如下：</p>
+        # <pre>
+        #    指标个数 * 时间点个数 * 维度值个数 = 数据项总数
+        # </pre>
+        # <ul>
+        #   <li>
+        #     <strong>指标个数</strong>：<code>MetricNames</code> 的列表长度。
+        #   </li>
+        #   <li>
+        #     <strong>时间点个数</strong>：<code>(EndTime - StartTime) / Interval</code>。
+        #   </li>
+        #   <li>
+        #     <strong>维度值个数</strong>：
+        #     <ul>
+        #       <li>当未指定 <code>DimensionName</code> 时，默认按账号维度汇总数据，维度值个数为 1。</li>
+        #       <li>当 <code>DimensionName = domain</code> 时，维度值个数为 <code>Filters</code> 中 <code>domain</code> 过滤条件指定的域名列表长度。</li>
+        #       <li>当 <code>DimensionName = origin-status-code-category</code> 时，维度值个数默认为 <code>6</code>。</li>
+        #       <li>当 <code>DimensionName = origin-status-code</code> 时，维度值个数默认为 <code>600</code>。</li>
+        #     </ul>
+        #   </li>
+        # </ul>
+
+        # <p><code>DimensionName</code> 可以与 <code>Filters</code> 组合使用，通过在 <code>Filters</code> 中指定 <code>DimensionName</code> 对应的过滤条件以限制维度值个数。</p>
+
+        # <h3>示例</h3>
+        # <p>以查询某一小时的具体状态码维度的时序数据为例，假设查询条件如下：</p>
+        # <ul>
+        #   <li><code>MetricNames = ["l7Flow_request_hy"]</code>（指标个数 = 1）</li>
+        #   <li><code>StartTime = 2025-10-01T06:00:00+08:00</code>，<code>EndTime = 2025-10-01T06:59:59+08:00</code>，<code>Interval = "min"</code>（时间点个数 = 60）</li>
+        #   <li><code>DimensionName = origin-status-code</code>，<code>Filters = [{"originStatusCode": ["0", "4xx", "5xx"]}]</code>（维度值个数 = 201）</li>
+        # </ul>
+        # <p>则数据项总数为：</p>
+        # <pre>1 × 60 × 201 = 12060 </pre>
+        # <p>未超过限制。</p>
+
+        # <p><strong>注意</strong>：若查询的数据项总数超过 <strong>50,000</strong>，系统会返回错误 <strong>LimitExceeded.TimingDataItemLimitExceeded</strong>。</p>
+        # <p>此时，请通过调整入参减少单次查询的数据项至 50,000 以内，可采取的做法有：</p>
+        # <ol>
+        #   <li>
+        #     <strong>减少时间点个数</strong>：
+        #     <ul>
+        #       <li>缩短查询时间范围（<code>StartTime</code> 到 <code>EndTime</code> 之间的时间跨度）。</li>
+        #       <li>选择更大的时间间隔（<code>Interval</code>）。</li>
+        #     </ul>
+        #   </li>
+        #   <li>
+        #     <strong>减少维度值个数</strong>：
+        #     <ul>
+        #       <li>调整 <code>Filters</code>，指定更少的 <code>domain</code> 或 <code>originStatusCode</code> 列表。</li>
+        #     </ul>
+        #   </li>
+        #   <li>
+        #     <strong>减少指标值个数</strong>：
+        #     <ul>
+        #       <li>调整 <code>MetricNames</code>，指定更少的查询指标。</li>
+        #     </ul>
+        #   </li>
+        # </ol>
 
         # @param request: Request instance for DescribeTimingL7OriginPullData.
         # @type request: :class:`Tencentcloud::teo::V20220901::DescribeTimingL7OriginPullDataRequest`

data/lib/v20220901/models.rb

@@ -2323,8 +2323,8 @@ module TencentCloud
 
         attr_accessor :Switch, :CacheTime, :IgnoreCacheControl
         extend Gem::Deprecate
-        deprecate :IgnoreCacheControl, :none, 2025, 12
-        deprecate :IgnoreCacheControl=, :none, 2025, 12
+        deprecate :IgnoreCacheControl, :none, 2026, 1
+        deprecate :IgnoreCacheControl=, :none, 2026, 1
 
         def initialize(switch=nil, cachetime=nil, ignorecachecontrol=nil)
           @Switch = switch
@@ -4355,7 +4355,6 @@ module TencentCloud
         # @param Ipv6: 是否开启 IPv6 访问，不填写时默认为 off。该配置仅在部分加速区域和安全防护配置下支持开启，详情请参考 [新建四层代理实例](https://cloud.tencent.com/document/product/1552/90025) 。取值为：
         # <li>on：开启；</li>
         # <li>off：关闭。</li>
-
         # @type Ipv6: String
         # @param StaticIp: 是否开启固定 IP，不填写时默认为 off。该配置仅在部分加速区域和安全防护配置下支持开启，详情请参考 [新建四层代理实例](https://cloud.tencent.com/document/product/1552/90025) 。取值为：
         # <li>on：开启；</li>
@@ -4366,9 +4365,13 @@ module TencentCloud
         # <li>off：关闭。</li>
         # @type AccelerateMainland: String
         # @param DDosProtectionConfig: L3/L4 DDoS 防护配置，不填写时默认使用平台默认防护选项。详情参考 [独立 DDoS 防护](https://cloud.tencent.com/document/product/1552/95994)。
+        # 本字段已废弃，请使用 DDosProtectionId 字段指定关联的DDoS防护配置。
         # @type DDosProtectionConfig: :class:`Tencentcloud::Teo.v20220901.models.DDosProtectionConfig`
 
         attr_accessor :ZoneId, :ProxyName, :Area, :Ipv6, :StaticIp, :AccelerateMainland, :DDosProtectionConfig
+        extend Gem::Deprecate
+        deprecate :DDosProtectionConfig, :none, 2026, 1
+        deprecate :DDosProtectionConfig=, :none, 2026, 1
 
         def initialize(zoneid=nil, proxyname=nil, area=nil, ipv6=nil, staticip=nil, acceleratemainland=nil, ddosprotectionconfig=nil)
           @ZoneId = zoneid
@@ -4949,8 +4952,8 @@ module TencentCloud
 
         attr_accessor :ZoneId, :Targets, :Mode, :EncodeUrl, :Headers, :PrefetchMediaSegments
         extend Gem::Deprecate
-        deprecate :EncodeUrl, :none, 2025, 12
-        deprecate :EncodeUrl=, :none, 2025, 12
+        deprecate :EncodeUrl, :none, 2026, 1
+        deprecate :EncodeUrl=, :none, 2026, 1
 
         def initialize(zoneid=nil, targets=nil, mode=nil, encodeurl=nil, headers=nil, prefetchmediasegments=nil)
           @ZoneId = zoneid
@@ -5034,8 +5037,8 @@ module TencentCloud
 
         attr_accessor :ZoneId, :Type, :Method, :Targets, :EncodeUrl, :CacheTag
         extend Gem::Deprecate
-        deprecate :EncodeUrl, :none, 2025, 12
-        deprecate :EncodeUrl=, :none, 2025, 12
+        deprecate :EncodeUrl, :none, 2026, 1
+        deprecate :EncodeUrl=, :none, 2026, 1
 
         def initialize(zoneid=nil, type=nil, method=nil, targets=nil, encodeurl=nil, cachetag=nil)
           @ZoneId = zoneid
@@ -5645,10 +5648,10 @@ module TencentCloud
 
         attr_accessor :Type, :ZoneName, :Area, :PlanId, :AliasZoneName, :Tags, :AllowDuplicates, :JumpStart
         extend Gem::Deprecate
-        deprecate :AllowDuplicates, :none, 2025, 12
-        deprecate :AllowDuplicates=, :none, 2025, 12
-        deprecate :JumpStart, :none, 2025, 12
-        deprecate :JumpStart=, :none, 2025, 12
+        deprecate :AllowDuplicates, :none, 2026, 1
+        deprecate :AllowDuplicates=, :none, 2026, 1
+        deprecate :JumpStart, :none, 2026, 1
+        deprecate :JumpStart=, :none, 2026, 1
 
         def initialize(type=nil, zonename=nil, area=nil, planid=nil, aliaszonename=nil, tags=nil, allowduplicates=nil, jumpstart=nil)
           @Type = type
@@ -11205,45 +11208,47 @@ module TencentCloud
 
       # DescribeTimingL7OriginPullData请求参数结构体
       class DescribeTimingL7OriginPullDataRequest < TencentCloud::Common::AbstractModel
-        # @param StartTime: 开始时间。
-        # @type StartTime: String
-        # @param EndTime: 结束时间。查询时间范围（`EndTime` - `StartTime`）需小于等于 31 天。
-        # @type EndTime: String
+        # @param ZoneIds: 站点 ID 集合，此参数必填。最多传入 100 个站点 ID。若需查询腾讯云主账号下所有站点数据，请用 `*` 代替，查询账号级别数据需具备本接口全部站点资源权限。
+        # @type ZoneIds: Array
         # @param MetricNames: 指标列表，取值有:
-        # <li>l7Flow_outFlux_hy: EdgeOne 节点至源站方向的请求流量，单位：Byte；</li>
+        # <ul><li>l7Flow_outFlux_hy: EdgeOne 节点至源站方向的请求流量，单位：Byte；</li>
         # <li>l7Flow_outBandwidth_hy: EdgeOne 节点至源站方向的请求带宽，单位：bps；</li>
         # <li>l7Flow_request_hy: EdgeOne 节点至源站方向的请求数，单位：次。</li>
         # <li>l7Flow_inFlux_hy: 源站至 EdgeOne 节点方向的响应流量，单位：Byte；</li>
-        # <li>l7Flow_inBandwidth_hy: 源站至 EdgeOne 节点方向的响应带宽，单位：bps；</li>
+        # <li>l7Flow_inBandwidth_hy: 源站至 EdgeOne 节点方向的响应带宽，单位：bps。</li></ul>
         # @type MetricNames: Array
-        # @param ZoneIds: 站点 ID 集合，此参数必填。最多传入 100 个站点 ID。若需查询腾讯云主账号下所有站点数据，请用 `*` 代替，查询账号级别数据需具备本接口全部站点资源权限。
-        # @type ZoneIds: Array
+        # @param StartTime: 开始时间。
+        # @type StartTime: String
+        # @param EndTime: 结束时间。查询时间范围（`EndTime` - `StartTime`）需小于等于 31 天。
+        # @type EndTime: String
         # @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 粒度查询。
+        # <ul><li>min: 1分钟；</li><li>5min: 5分钟；</li><li>hour: 1小时；</li><li>day: 1天。</li></ul>不填将根据开始时间跟结束时间的间距自动推算粒度，具体为：2 小时范围内以 min 粒度查询，2 天范围内以 5min 粒度查询，7 天范围内以 hour 粒度查询，超过 7 天以 day 粒度查询。
         # @type Interval: String
         # @param Filters: 过滤条件，详细的过滤条件如下：
-        # <li>domain：客户端请求的域名。若按泛域名接入 EdgeOne，则数据中记录为泛域名，而不是具体域名。</li>
+        # <ul><li><strong>domain</strong>：客户端请求的域名。若按泛域名接入 EdgeOne，则数据中记录为泛域名，而不是具体域名。</li><li><strong>originStatusCode</strong>：回源状态码，仅当 <code>MetricNames = ["l7Flow_request_hy"]</code> 时支持本过滤项。<br>对应的 Value 可选项如下：<ul><li><code>1xx</code>：1xx 类型的状态码；</li><li><code>2xx</code>：2xx 类型的状态码；</li><li><code>3xx</code>：3xx 类型的状态码；</li><li><code>4xx</code>：4xx 类型的状态码；</li><li><code>5xx</code>：5xx 类型的状态码；</li><li>在 <code>[0, 600)</code> 范围内的整数（不包括 600）。</li></ul></li></ul>
+        # **注意**：当 <code>DimensionName</code>  不为空时，仅支持 <code>equals</code> 运算符。
         # @type Filters: Array
+        # @param DimensionName: <p>查询维度名称，取值有：</p><ul><li><strong>domain</strong>：客户端请求的域名。若按泛域名接入 EdgeOne，则数据中记录为泛域名。<br>使用 domain 维度时必须在 <code>Filters</code> 中包含 <code>domain</code> 过滤项，指定总数不超过 100 个需要查询的域名列表；</li><li><strong>origin-status-code</strong>：回源状态码，如 200、404，<br>仅当 <code>MetricNames = ["l7Flow_request_hy"]</code> 时支持本维度；</li><li><strong>origin-status-code-category</strong>：回源状态码类别，如 2xx、4xx，<br>仅当 <code>MetricNames =["l7Flow_request_hy"]</code> 时支持本维度。</li></ul><p>若 <code>DimensionName</code> 入参为空，默认按 <code>AppId</code> 维度汇总，只返回一组数据。</p><p>若 <code>DimensionName</code> 入参不为空，则按照传入的查询维度分组返回对应的时序数据。例如：</p><ul>当 <code>DimensionName = origin-status-code</code> 时：<ul><li>返回数据中 <code>TimingDataRecords.TypeKey</code> 为具体回源状态码，例如 200。</li><li>返回数据中 <code>TimingDataRecords.TypeValue</code> 是该状态码对应的时序数据。</li></ul></ul>
+        # <strong>注意</strong>：当指定 DimensionName 查询时，禁止并发调用。若超出查询频率限制，会返回错误 <code><strong>InvalidParameter.ActionInProgress</strong></code> 。
+        # @type DimensionName: String
 
-        attr_accessor :StartTime, :EndTime, :MetricNames, :ZoneIds, :Interval, :Filters
+        attr_accessor :ZoneIds, :MetricNames, :StartTime, :EndTime, :Interval, :Filters, :DimensionName
 
-        def initialize(starttime=nil, endtime=nil, metricnames=nil, zoneids=nil, interval=nil, filters=nil)
+        def initialize(zoneids=nil, metricnames=nil, starttime=nil, endtime=nil, interval=nil, filters=nil, dimensionname=nil)
+          @ZoneIds = zoneids
+          @MetricNames = metricnames
           @StartTime = starttime
           @EndTime = endtime
-          @MetricNames = metricnames
-          @ZoneIds = zoneids
           @Interval = interval
           @Filters = filters
+          @DimensionName = dimensionname
         end
 
         def deserialize(params)
+          @ZoneIds = params['ZoneIds']
+          @MetricNames = params['MetricNames']
           @StartTime = params['StartTime']
           @EndTime = params['EndTime']
-          @MetricNames = params['MetricNames']
-          @ZoneIds = params['ZoneIds']
           @Interval = params['Interval']
           unless params['Filters'].nil?
             @Filters = []
@@ -11253,6 +11258,7 @@ module TencentCloud
               @Filters << querycondition_tmp
             end
           end
+          @DimensionName = params['DimensionName']
         end
       end
 
@@ -14695,6 +14701,7 @@ module TencentCloud
         #  <li>on：开启</li> <li>off：关闭</li>
         # @type AccelerateMainland: String
         # @param DDosProtectionConfig: 安全防护配置。
+        # 本字段已废弃。
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type DDosProtectionConfig: :class:`Tencentcloud::Teo.v20220901.models.DDosProtectionConfig`
         # @param L4ProxyRuleCount: 四层代理实例下的转发规则数量。
@@ -14703,6 +14710,9 @@ module TencentCloud
         # @type UpdateTime: String
 
         attr_accessor :ZoneId, :ProxyId, :ProxyName, :Area, :Cname, :Ips, :Status, :Ipv6, :StaticIp, :AccelerateMainland, :DDosProtectionConfig, :L4ProxyRuleCount, :UpdateTime
+        extend Gem::Deprecate
+        deprecate :DDosProtectionConfig, :none, 2026, 1
+        deprecate :DDosProtectionConfig=, :none, 2026, 1
 
         def initialize(zoneid=nil, proxyid=nil, proxyname=nil, area=nil, cname=nil, ips=nil, status=nil, ipv6=nil, staticip=nil, acceleratemainland=nil, ddosprotectionconfig=nil, l4proxyrulecount=nil, updatetime=nil)
           @ZoneId = zoneid
@@ -16196,8 +16206,8 @@ module TencentCloud
 
         attr_accessor :ZoneId, :Hosts, :Mode, :ServerCertInfo, :ApplyType, :ClientCertInfo, :UpstreamCertInfo
         extend Gem::Deprecate
-        deprecate :ApplyType, :none, 2025, 12
-        deprecate :ApplyType=, :none, 2025, 12
+        deprecate :ApplyType, :none, 2026, 1
+        deprecate :ApplyType=, :none, 2026, 1
 
         def initialize(zoneid=nil, hosts=nil, mode=nil, servercertinfo=nil, applytype=nil, clientcertinfo=nil, upstreamcertinfo=nil)
           @ZoneId = zoneid
@@ -18614,12 +18624,12 @@ module TencentCloud
 
         attr_accessor :OriginType, :Origin, :BackupOrigin, :OriginGroupName, :BackOriginGroupName, :PrivateAccess, :PrivateParameters, :HostHeader, :VodeoSubAppId, :VodeoDistributionRange, :VodeoBucketId, :VodOriginScope, :VodBucketId
         extend Gem::Deprecate
-        deprecate :VodeoSubAppId, :none, 2025, 12
-        deprecate :VodeoSubAppId=, :none, 2025, 12
-        deprecate :VodeoDistributionRange, :none, 2025, 12
-        deprecate :VodeoDistributionRange=, :none, 2025, 12
-        deprecate :VodeoBucketId, :none, 2025, 12
-        deprecate :VodeoBucketId=, :none, 2025, 12
+        deprecate :VodeoSubAppId, :none, 2026, 1
+        deprecate :VodeoSubAppId=, :none, 2026, 1
+        deprecate :VodeoDistributionRange, :none, 2026, 1
+        deprecate :VodeoDistributionRange=, :none, 2026, 1
+        deprecate :VodeoBucketId, :none, 2026, 1
+        deprecate :VodeoBucketId=, :none, 2026, 1
 
         def initialize(origintype=nil, origin=nil, backuporigin=nil, origingroupname=nil, backorigingroupname=nil, privateaccess=nil, privateparameters=nil, hostheader=nil, vodeosubappid=nil, vodeodistributionrange=nil, vodeobucketid=nil, vodoriginscope=nil, vodbucketid=nil)
           @OriginType = origintype
@@ -18936,12 +18946,12 @@ module TencentCloud
 
         attr_accessor :OriginType, :Origin, :BackupOrigin, :PrivateAccess, :PrivateParameters, :HostHeader, :VodeoSubAppId, :VodeoDistributionRange, :VodeoBucketId, :VodOriginScope, :VodBucketId
         extend Gem::Deprecate
-        deprecate :VodeoSubAppId, :none, 2025, 12
-        deprecate :VodeoSubAppId=, :none, 2025, 12
-        deprecate :VodeoDistributionRange, :none, 2025, 12
-        deprecate :VodeoDistributionRange=, :none, 2025, 12
-        deprecate :VodeoBucketId, :none, 2025, 12
-        deprecate :VodeoBucketId=, :none, 2025, 12
+        deprecate :VodeoSubAppId, :none, 2026, 1
+        deprecate :VodeoSubAppId=, :none, 2026, 1
+        deprecate :VodeoDistributionRange, :none, 2026, 1
+        deprecate :VodeoDistributionRange=, :none, 2026, 1
+        deprecate :VodeoBucketId, :none, 2026, 1
+        deprecate :VodeoBucketId=, :none, 2026, 1
 
         def initialize(origintype=nil, origin=nil, backuporigin=nil, privateaccess=nil, privateparameters=nil, hostheader=nil, vodeosubappid=nil, vodeodistributionrange=nil, vodeobucketid=nil, vodoriginscope=nil, vodbucketid=nil)
           @OriginType = origintype
@@ -20670,8 +20680,8 @@ module TencentCloud
 
         attr_accessor :Operator, :Target, :Values, :IgnoreCase, :Name, :IgnoreNameCase
         extend Gem::Deprecate
-        deprecate :IgnoreNameCase, :none, 2025, 12
-        deprecate :IgnoreNameCase=, :none, 2025, 12
+        deprecate :IgnoreNameCase, :none, 2026, 1
+        deprecate :IgnoreNameCase=, :none, 2026, 1
 
         def initialize(operator=nil, target=nil, values=nil, ignorecase=nil, name=nil, ignorenamecase=nil)
           @Operator = operator

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-teo
 version: !ruby/object:Gem::Version
-  version: 3.0.1188
+  version: 3.0.1201
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-12-23 00:00:00.000000000 Z
+date: 2026-01-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -35,9 +35,9 @@ extra_rdoc_files: []
 files:
 - lib/v20220106/client.rb
 - lib/v20220106/models.rb
-- lib/tencentcloud-sdk-teo.rb
 - lib/v20220901/client.rb
 - lib/v20220901/models.rb
+- lib/tencentcloud-sdk-teo.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: