tencentcloud-sdk-teo 3.0.1199 → 3.0.1201

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 39d9b155be29f27a091c5c82189699562a33aece
-  data.tar.gz: 91f6a21d9dcbb666dd5d381332302b7dc9743849
+  metadata.gz: af85f3c4af40ce3c3a55e4e33c434e03a235577e
+  data.tar.gz: 0e2f64b26864e20e43e1607e0c91c67eb3285da7
 SHA512:
-  metadata.gz: 7e553c9a06ea9fcab0f625866d152ba8a9724f1660534443cc4be1392345aea16e562b35a0b23840eb778d421e40d820ad88ce4ae894393de550df9af489e280
-  data.tar.gz: 9b33b059576e33169a17c5c0f0b974da8ed3a372d8073dcb13112bd4c320d409c5b9deb291833ec41aa84412950d48e1b5523904e7e5382eb2a260ab2a6d07d8
+  metadata.gz: 98535b7843e3dceef9bd25c7bdd23d4b933fce5d79113f22879ec6dd4ac0fcaa5d31242bca1360919d00e43fc5d8640a7cd7bd66d43b4b9786cac7fc176cb724
+  data.tar.gz: ec0206d6a699e1ca26325ebcd658e363e69d4e63480998e9cc45b836cd1847385615fbd870971f963c52950764744e2196c62a53ccdecac911a2273b005e0d07

data/lib/VERSION

@@ -1 +1 @@
-3.0.1199
+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

@@ -11208,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 = []
@@ -11256,6 +11258,7 @@ module TencentCloud
               @Filters << querycondition_tmp
             end
           end
+          @DimensionName = params['DimensionName']
         end
       end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-teo
 version: !ruby/object:Gem::Version
-  version: 3.0.1199
+  version: 3.0.1201
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-08 00:00:00.000000000 Z
+date: 2026-01-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,11 +33,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/tencentcloud-sdk-teo.rb
 - lib/v20220106/client.rb
 - lib/v20220106/models.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: