tencentcloud-sdk-python-teo 3.1.29__tar.gz → 3.1.31__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (22) hide show
  1. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/PKG-INFO +2 -2
  2. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/setup.py +1 -1
  3. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/__init__.py +1 -1
  4. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/v20220901/errorcodes.py +6 -0
  5. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/v20220901/models.py +62 -51
  6. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/v20220901/teo_client.py +60 -1
  7. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/v20220901/teo_client_async.py +60 -1
  8. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud_sdk_python_teo.egg-info/PKG-INFO +2 -2
  9. tencentcloud_sdk_python_teo-3.1.31/tencentcloud_sdk_python_teo.egg-info/requires.txt +1 -0
  10. tencentcloud_sdk_python_teo-3.1.29/tencentcloud_sdk_python_teo.egg-info/requires.txt +0 -1
  11. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/README.rst +0 -0
  12. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/setup.cfg +0 -0
  13. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/__init__.py +0 -0
  14. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/v20220106/__init__.py +0 -0
  15. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/v20220106/errorcodes.py +0 -0
  16. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/v20220106/models.py +0 -0
  17. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/v20220106/teo_client.py +0 -0
  18. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/v20220106/teo_client_async.py +0 -0
  19. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud/teo/v20220901/__init__.py +0 -0
  20. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud_sdk_python_teo.egg-info/SOURCES.txt +0 -0
  21. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud_sdk_python_teo.egg-info/dependency_links.txt +0 -0
  22. {tencentcloud_sdk_python_teo-3.1.29 → tencentcloud_sdk_python_teo-3.1.31}/tencentcloud_sdk_python_teo.egg-info/top_level.txt +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: tencentcloud-sdk-python-teo
3
- Version: 3.1.29
3
+ Version: 3.1.31
4
4
  Summary: Tencent Cloud Teo SDK for Python
5
5
  Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
6
6
  Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
15
15
  Classifier: Programming Language :: Python :: 3
16
16
  Classifier: Programming Language :: Python :: 3.6
17
17
  Classifier: Programming Language :: Python :: 3.7
18
- Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.29
18
+ Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.31
19
19
 
20
20
  ============================
21
21
  Tencent Cloud SDK for Python
@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
8
8
 
9
9
  setup(
10
10
  name='tencentcloud-sdk-python-teo',
11
- install_requires=["tencentcloud-sdk-python-common>=3.1.29,<4.0.0"],
11
+ install_requires=["tencentcloud-sdk-python-common>=3.1.31,<4.0.0"],
12
12
 
13
13
  version=tencentcloud.__version__,
14
14
  description='Tencent Cloud Teo SDK for Python',
@@ -14,4 +14,4 @@
14
14
  # limitations under the License.
15
15
 
16
16
 
17
- __version__ = '3.1.29'
17
+ __version__ = '3.1.31'
@@ -878,6 +878,9 @@ INVALIDPARAMETERVALUE_CONTENTTYPENOTMATCH = 'InvalidParameterValue.ContentTypeNo
878
878
  # 入参中的域名与站点参数不匹配,请更正后重试。
879
879
  INVALIDPARAMETERVALUE_DOMAINNOTMATCHZONE = 'InvalidParameterValue.DomainNotMatchZone'
880
880
 
881
+ # 当指定 DimensionName 参数时,Filters 字段必须包含与 DimensionName 对应的过滤条件。
882
+ INVALIDPARAMETERVALUE_FILTERSMUSTINCLUDEDIMENSIONNAME = 'InvalidParameterValue.FiltersMustIncludeDimensionName'
883
+
881
884
  # 格式不匹配。
882
885
  INVALIDPARAMETERVALUE_FORMATMISMATCH = 'InvalidParameterValue.FormatMismatch'
883
886
 
@@ -1022,6 +1025,9 @@ LIMITEXCEEDED_RULELIMITEXCEEDED = 'LimitExceeded.RuleLimitExceeded'
1022
1025
  # 超出功能限制。
1023
1026
  LIMITEXCEEDED_SECURITY = 'LimitExceeded.Security'
1024
1027
 
1028
+ # 本次查询的时序数据项超出上限。
1029
+ LIMITEXCEEDED_TIMINGDATAITEMLIMITEXCEEDED = 'LimitExceeded.TimingDataItemLimitExceeded'
1030
+
1025
1031
  # 用户实例数量限制。
1026
1032
  LIMITEXCEEDED_USERQUOTALIMITED = 'LimitExceeded.UserQuotaLimited'
1027
1033
 
@@ -26886,68 +26886,57 @@ class DescribeTimingL7OriginPullDataRequest(AbstractModel):
26886
26886
 
26887
26887
  def __init__(self):
26888
26888
  r"""
26889
- :param _StartTime: 开始时间。
26890
- :type StartTime: str
26891
- :param _EndTime: 结束时间。查询时间范围(`EndTime` - `StartTime`)需小于等于 31 天。
26892
- :type EndTime: str
26889
+ :param _ZoneIds: 站点 ID 集合,此参数必填。最多传入 100 个站点 ID。若需查询腾讯云主账号下所有站点数据,请用 `*` 代替,查询账号级别数据需具备本接口全部站点资源权限。
26890
+ :type ZoneIds: list of str
26893
26891
  :param _MetricNames: 指标列表,取值有:
26894
- <li>l7Flow_outFlux_hy: EdgeOne 节点至源站方向的请求流量,单位:Byte;</li>
26892
+ <ul><li>l7Flow_outFlux_hy: EdgeOne 节点至源站方向的请求流量,单位:Byte;</li>
26895
26893
  <li>l7Flow_outBandwidth_hy: EdgeOne 节点至源站方向的请求带宽,单位:bps;</li>
26896
26894
  <li>l7Flow_request_hy: EdgeOne 节点至源站方向的请求数,单位:次。</li>
26897
26895
  <li>l7Flow_inFlux_hy: 源站至 EdgeOne 节点方向的响应流量,单位:Byte;</li>
26898
- <li>l7Flow_inBandwidth_hy: 源站至 EdgeOne 节点方向的响应带宽,单位:bps;</li>
26899
-
26896
+ <li>l7Flow_inBandwidth_hy: 源站至 EdgeOne 节点方向的响应带宽,单位:bps。</li></ul>
26900
26897
  :type MetricNames: list of str
26901
- :param _ZoneIds: 站点 ID 集合,此参数必填。最多传入 100 个站点 ID。若需查询腾讯云主账号下所有站点数据,请用 `*` 代替,查询账号级别数据需具备本接口全部站点资源权限。
26902
- :type ZoneIds: list of str
26898
+ :param _StartTime: 开始时间。
26899
+ :type StartTime: str
26900
+ :param _EndTime: 结束时间。查询时间范围(`EndTime` - `StartTime`)需小于等于 31 天。
26901
+ :type EndTime: str
26903
26902
  :param _Interval: 查询时间粒度,取值有:
26904
- <li>min: 1分钟;</li>
26905
- <li>5min: 5分钟;</li>
26906
- <li>hour: 1小时;</li>
26907
- <li>day: 1天。</li>不填将根据开始时间跟结束时间的间距自动推算粒度,具体为:2 小时范围内以 min 粒度查询,2 天范围内以 5min 粒度查询,7 天范围内以 hour 粒度查询,超过 7 天以 day 粒度查询。
26903
+ <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 粒度查询。
26908
26904
  :type Interval: str
26909
26905
  :param _Filters: 过滤条件,详细的过滤条件如下:
26910
- <li>domain:客户端请求的域名。若按泛域名接入 EdgeOne,则数据中记录为泛域名,而不是具体域名。</li>
26906
+ <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>
26907
+ **注意**:当 <code>DimensionName</code> 不为空时,仅支持 <code>equals</code> 运算符。
26911
26908
  :type Filters: list of QueryCondition
26909
+ :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>
26910
+ <strong>注意</strong>:当指定 DimensionName 查询时,禁止并发调用。若超出查询频率限制,会返回错误 <code><strong>InvalidParameter.ActionInProgress</strong></code> 。
26911
+ :type DimensionName: str
26912
26912
  """
26913
+ self._ZoneIds = None
26914
+ self._MetricNames = None
26913
26915
  self._StartTime = None
26914
26916
  self._EndTime = None
26915
- self._MetricNames = None
26916
- self._ZoneIds = None
26917
26917
  self._Interval = None
26918
26918
  self._Filters = None
26919
+ self._DimensionName = None
26919
26920
 
26920
26921
  @property
26921
- def StartTime(self):
26922
- r"""开始时间。
26923
- :rtype: str
26924
- """
26925
- return self._StartTime
26926
-
26927
- @StartTime.setter
26928
- def StartTime(self, StartTime):
26929
- self._StartTime = StartTime
26930
-
26931
- @property
26932
- def EndTime(self):
26933
- r"""结束时间。查询时间范围(`EndTime` - `StartTime`)需小于等于 31 天。
26934
- :rtype: str
26922
+ def ZoneIds(self):
26923
+ r"""站点 ID 集合,此参数必填。最多传入 100 个站点 ID。若需查询腾讯云主账号下所有站点数据,请用 `*` 代替,查询账号级别数据需具备本接口全部站点资源权限。
26924
+ :rtype: list of str
26935
26925
  """
26936
- return self._EndTime
26926
+ return self._ZoneIds
26937
26927
 
26938
- @EndTime.setter
26939
- def EndTime(self, EndTime):
26940
- self._EndTime = EndTime
26928
+ @ZoneIds.setter
26929
+ def ZoneIds(self, ZoneIds):
26930
+ self._ZoneIds = ZoneIds
26941
26931
 
26942
26932
  @property
26943
26933
  def MetricNames(self):
26944
26934
  r"""指标列表,取值有:
26945
- <li>l7Flow_outFlux_hy: EdgeOne 节点至源站方向的请求流量,单位:Byte;</li>
26935
+ <ul><li>l7Flow_outFlux_hy: EdgeOne 节点至源站方向的请求流量,单位:Byte;</li>
26946
26936
  <li>l7Flow_outBandwidth_hy: EdgeOne 节点至源站方向的请求带宽,单位:bps;</li>
26947
26937
  <li>l7Flow_request_hy: EdgeOne 节点至源站方向的请求数,单位:次。</li>
26948
26938
  <li>l7Flow_inFlux_hy: 源站至 EdgeOne 节点方向的响应流量,单位:Byte;</li>
26949
- <li>l7Flow_inBandwidth_hy: 源站至 EdgeOne 节点方向的响应带宽,单位:bps;</li>
26950
-
26939
+ <li>l7Flow_inBandwidth_hy: 源站至 EdgeOne 节点方向的响应带宽,单位:bps。</li></ul>
26951
26940
  :rtype: list of str
26952
26941
  """
26953
26942
  return self._MetricNames
@@ -26957,23 +26946,31 @@ class DescribeTimingL7OriginPullDataRequest(AbstractModel):
26957
26946
  self._MetricNames = MetricNames
26958
26947
 
26959
26948
  @property
26960
- def ZoneIds(self):
26961
- r"""站点 ID 集合,此参数必填。最多传入 100 个站点 ID。若需查询腾讯云主账号下所有站点数据,请用 `*` 代替,查询账号级别数据需具备本接口全部站点资源权限。
26962
- :rtype: list of str
26949
+ def StartTime(self):
26950
+ r"""开始时间。
26951
+ :rtype: str
26963
26952
  """
26964
- return self._ZoneIds
26953
+ return self._StartTime
26965
26954
 
26966
- @ZoneIds.setter
26967
- def ZoneIds(self, ZoneIds):
26968
- self._ZoneIds = ZoneIds
26955
+ @StartTime.setter
26956
+ def StartTime(self, StartTime):
26957
+ self._StartTime = StartTime
26958
+
26959
+ @property
26960
+ def EndTime(self):
26961
+ r"""结束时间。查询时间范围(`EndTime` - `StartTime`)需小于等于 31 天。
26962
+ :rtype: str
26963
+ """
26964
+ return self._EndTime
26965
+
26966
+ @EndTime.setter
26967
+ def EndTime(self, EndTime):
26968
+ self._EndTime = EndTime
26969
26969
 
26970
26970
  @property
26971
26971
  def Interval(self):
26972
26972
  r"""查询时间粒度,取值有:
26973
- <li>min: 1分钟;</li>
26974
- <li>5min: 5分钟;</li>
26975
- <li>hour: 1小时;</li>
26976
- <li>day: 1天。</li>不填将根据开始时间跟结束时间的间距自动推算粒度,具体为:2 小时范围内以 min 粒度查询,2 天范围内以 5min 粒度查询,7 天范围内以 hour 粒度查询,超过 7 天以 day 粒度查询。
26973
+ <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 粒度查询。
26977
26974
  :rtype: str
26978
26975
  """
26979
26976
  return self._Interval
@@ -26985,7 +26982,8 @@ class DescribeTimingL7OriginPullDataRequest(AbstractModel):
26985
26982
  @property
26986
26983
  def Filters(self):
26987
26984
  r"""过滤条件,详细的过滤条件如下:
26988
- <li>domain:客户端请求的域名。若按泛域名接入 EdgeOne,则数据中记录为泛域名,而不是具体域名。</li>
26985
+ <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>
26986
+ **注意**:当 <code>DimensionName</code> 不为空时,仅支持 <code>equals</code> 运算符。
26989
26987
  :rtype: list of QueryCondition
26990
26988
  """
26991
26989
  return self._Filters
@@ -26994,12 +26992,24 @@ class DescribeTimingL7OriginPullDataRequest(AbstractModel):
26994
26992
  def Filters(self, Filters):
26995
26993
  self._Filters = Filters
26996
26994
 
26995
+ @property
26996
+ def DimensionName(self):
26997
+ r"""<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>
26998
+ <strong>注意</strong>:当指定 DimensionName 查询时,禁止并发调用。若超出查询频率限制,会返回错误 <code><strong>InvalidParameter.ActionInProgress</strong></code> 。
26999
+ :rtype: str
27000
+ """
27001
+ return self._DimensionName
27002
+
27003
+ @DimensionName.setter
27004
+ def DimensionName(self, DimensionName):
27005
+ self._DimensionName = DimensionName
27006
+
26997
27007
 
26998
27008
  def _deserialize(self, params):
27009
+ self._ZoneIds = params.get("ZoneIds")
27010
+ self._MetricNames = params.get("MetricNames")
26999
27011
  self._StartTime = params.get("StartTime")
27000
27012
  self._EndTime = params.get("EndTime")
27001
- self._MetricNames = params.get("MetricNames")
27002
- self._ZoneIds = params.get("ZoneIds")
27003
27013
  self._Interval = params.get("Interval")
27004
27014
  if params.get("Filters") is not None:
27005
27015
  self._Filters = []
@@ -27007,6 +27017,7 @@ class DescribeTimingL7OriginPullDataRequest(AbstractModel):
27007
27017
  obj = QueryCondition()
27008
27018
  obj._deserialize(item)
27009
27019
  self._Filters.append(obj)
27020
+ self._DimensionName = params.get("DimensionName")
27010
27021
  memeber_set = set(params.keys())
27011
27022
  for name, value in vars(self).items():
27012
27023
  property_name = name[1:]
@@ -3060,7 +3060,66 @@ class TeoClient(AbstractClient):
3060
3060
 
3061
3061
 
3062
3062
  def DescribeTimingL7OriginPullData(self, request):
3063
- r"""本接口用以查询七层域名业务的回源时序数据。
3063
+ r"""本接口用以查询七层域名业务的回源时序数据,可以通过指定查询维度 <code>DimensionName</code> 进行分组查询,返回多组时序数据。
3064
+
3065
+ <p>单次请求最多返回 <strong>50,000</strong> 个数据项<code> TimingDataItem </code>。数据项总数的计算规则如下:</p>
3066
+ <pre>
3067
+ 指标个数 * 时间点个数 * 维度值个数 = 数据项总数
3068
+ </pre>
3069
+ <ul>
3070
+ <li>
3071
+ <strong>指标个数</strong>:<code>MetricNames</code> 的列表长度。
3072
+ </li>
3073
+ <li>
3074
+ <strong>时间点个数</strong>:<code>(EndTime - StartTime) / Interval</code>。
3075
+ </li>
3076
+ <li>
3077
+ <strong>维度值个数</strong>:
3078
+ <ul>
3079
+ <li>当未指定 <code>DimensionName</code> 时,默认按账号维度汇总数据,维度值个数为 1。</li>
3080
+ <li>当 <code>DimensionName = domain</code> 时,维度值个数为 <code>Filters</code> 中 <code>domain</code> 过滤条件指定的域名列表长度。</li>
3081
+ <li>当 <code>DimensionName = origin-status-code-category</code> 时,维度值个数默认为 <code>6</code>。</li>
3082
+ <li>当 <code>DimensionName = origin-status-code</code> 时,维度值个数默认为 <code>600</code>。</li>
3083
+ </ul>
3084
+ </li>
3085
+ </ul>
3086
+
3087
+ <p><code>DimensionName</code> 可以与 <code>Filters</code> 组合使用,通过在 <code>Filters</code> 中指定 <code>DimensionName</code> 对应的过滤条件以限制维度值个数。</p>
3088
+
3089
+ <h3>示例</h3>
3090
+ <p>以查询某一小时的具体状态码维度的时序数据为例,假设查询条件如下:</p>
3091
+ <ul>
3092
+ <li><code>MetricNames = ["l7Flow_request_hy"]</code>(指标个数 = 1)</li>
3093
+ <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>
3094
+ <li><code>DimensionName = origin-status-code</code>,<code>Filters = [{"originStatusCode": ["0", "4xx", "5xx"]}]</code>(维度值个数 = 201)</li>
3095
+ </ul>
3096
+ <p>则数据项总数为:</p>
3097
+ <pre>1 × 60 × 201 = 12060 </pre>
3098
+ <p>未超过限制。</p>
3099
+
3100
+ <p><strong>注意</strong>:若查询的数据项总数超过 <strong>50,000</strong>,系统会返回错误 <strong>LimitExceeded.TimingDataItemLimitExceeded</strong>。</p>
3101
+ <p>此时,请通过调整入参减少单次查询的数据项至 50,000 以内,可采取的做法有:</p>
3102
+ <ol>
3103
+ <li>
3104
+ <strong>减少时间点个数</strong>:
3105
+ <ul>
3106
+ <li>缩短查询时间范围(<code>StartTime</code> 到 <code>EndTime</code> 之间的时间跨度)。</li>
3107
+ <li>选择更大的时间间隔(<code>Interval</code>)。</li>
3108
+ </ul>
3109
+ </li>
3110
+ <li>
3111
+ <strong>减少维度值个数</strong>:
3112
+ <ul>
3113
+ <li>调整 <code>Filters</code>,指定更少的 <code>domain</code> 或 <code>originStatusCode</code> 列表。</li>
3114
+ </ul>
3115
+ </li>
3116
+ <li>
3117
+ <strong>减少指标值个数</strong>:
3118
+ <ul>
3119
+ <li>调整 <code>MetricNames</code>,指定更少的查询指标。</li>
3120
+ </ul>
3121
+ </li>
3122
+ </ol>
3064
3123
 
3065
3124
  :param request: Request instance for DescribeTimingL7OriginPullData.
3066
3125
  :type request: :class:`tencentcloud.teo.v20220901.models.DescribeTimingL7OriginPullDataRequest`
@@ -2414,7 +2414,66 @@ class TeoClient(AbstractClient):
2414
2414
  opts: Dict = None,
2415
2415
  ) -> models.DescribeTimingL7OriginPullDataResponse:
2416
2416
  """
2417
- 本接口用以查询七层域名业务的回源时序数据。
2417
+ 本接口用以查询七层域名业务的回源时序数据,可以通过指定查询维度 <code>DimensionName</code> 进行分组查询,返回多组时序数据。
2418
+
2419
+ <p>单次请求最多返回 <strong>50,000</strong> 个数据项<code> TimingDataItem </code>。数据项总数的计算规则如下:</p>
2420
+ <pre>
2421
+ 指标个数 * 时间点个数 * 维度值个数 = 数据项总数
2422
+ </pre>
2423
+ <ul>
2424
+ <li>
2425
+ <strong>指标个数</strong>:<code>MetricNames</code> 的列表长度。
2426
+ </li>
2427
+ <li>
2428
+ <strong>时间点个数</strong>:<code>(EndTime - StartTime) / Interval</code>。
2429
+ </li>
2430
+ <li>
2431
+ <strong>维度值个数</strong>:
2432
+ <ul>
2433
+ <li>当未指定 <code>DimensionName</code> 时,默认按账号维度汇总数据,维度值个数为 1。</li>
2434
+ <li>当 <code>DimensionName = domain</code> 时,维度值个数为 <code>Filters</code> 中 <code>domain</code> 过滤条件指定的域名列表长度。</li>
2435
+ <li>当 <code>DimensionName = origin-status-code-category</code> 时,维度值个数默认为 <code>6</code>。</li>
2436
+ <li>当 <code>DimensionName = origin-status-code</code> 时,维度值个数默认为 <code>600</code>。</li>
2437
+ </ul>
2438
+ </li>
2439
+ </ul>
2440
+
2441
+ <p><code>DimensionName</code> 可以与 <code>Filters</code> 组合使用,通过在 <code>Filters</code> 中指定 <code>DimensionName</code> 对应的过滤条件以限制维度值个数。</p>
2442
+
2443
+ <h3>示例</h3>
2444
+ <p>以查询某一小时的具体状态码维度的时序数据为例,假设查询条件如下:</p>
2445
+ <ul>
2446
+ <li><code>MetricNames = ["l7Flow_request_hy"]</code>(指标个数 = 1)</li>
2447
+ <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>
2448
+ <li><code>DimensionName = origin-status-code</code>,<code>Filters = [{"originStatusCode": ["0", "4xx", "5xx"]}]</code>(维度值个数 = 201)</li>
2449
+ </ul>
2450
+ <p>则数据项总数为:</p>
2451
+ <pre>1 × 60 × 201 = 12060 </pre>
2452
+ <p>未超过限制。</p>
2453
+
2454
+ <p><strong>注意</strong>:若查询的数据项总数超过 <strong>50,000</strong>,系统会返回错误 <strong>LimitExceeded.TimingDataItemLimitExceeded</strong>。</p>
2455
+ <p>此时,请通过调整入参减少单次查询的数据项至 50,000 以内,可采取的做法有:</p>
2456
+ <ol>
2457
+ <li>
2458
+ <strong>减少时间点个数</strong>:
2459
+ <ul>
2460
+ <li>缩短查询时间范围(<code>StartTime</code> 到 <code>EndTime</code> 之间的时间跨度)。</li>
2461
+ <li>选择更大的时间间隔(<code>Interval</code>)。</li>
2462
+ </ul>
2463
+ </li>
2464
+ <li>
2465
+ <strong>减少维度值个数</strong>:
2466
+ <ul>
2467
+ <li>调整 <code>Filters</code>,指定更少的 <code>domain</code> 或 <code>originStatusCode</code> 列表。</li>
2468
+ </ul>
2469
+ </li>
2470
+ <li>
2471
+ <strong>减少指标值个数</strong>:
2472
+ <ul>
2473
+ <li>调整 <code>MetricNames</code>,指定更少的查询指标。</li>
2474
+ </ul>
2475
+ </li>
2476
+ </ol>
2418
2477
  """
2419
2478
 
2420
2479
  kwargs = {}
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.1
2
2
  Name: tencentcloud-sdk-python-teo
3
- Version: 3.1.29
3
+ Version: 3.1.31
4
4
  Summary: Tencent Cloud Teo SDK for Python
5
5
  Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
6
6
  Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
15
15
  Classifier: Programming Language :: Python :: 3
16
16
  Classifier: Programming Language :: Python :: 3.6
17
17
  Classifier: Programming Language :: Python :: 3.7
18
- Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.29
18
+ Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.31
19
19
 
20
20
  ============================
21
21
  Tencent Cloud SDK for Python
@@ -0,0 +1 @@
1
+ tencentcloud-sdk-python-common<4.0.0,>=3.1.31
@@ -1 +0,0 @@
1
- tencentcloud-sdk-python-common<4.0.0,>=3.1.29