tencentcloud-sdk-python-tokenhub 3.1.115__tar.gz → 3.1.124__tar.gz

{tencentcloud_sdk_python_tokenhub-3.1.115 → tencentcloud_sdk_python_tokenhub-3.1.124}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-tokenhub
-Version: 3.1.115
+Version: 3.1.124
 Summary: Tencent Cloud Tokenhub SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.115
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.124
 
 ============================
 Tencent Cloud SDK for Python

{tencentcloud_sdk_python_tokenhub-3.1.115 → tencentcloud_sdk_python_tokenhub-3.1.124}/setup.py

@@ -8,7 +8,7 @@ ROOT = os.path.dirname(__file__)
 
 setup(
     name='tencentcloud-sdk-python-tokenhub',
-    install_requires=["tencentcloud-sdk-python-common>=3.1.115,<4.0.0"],
+    install_requires=["tencentcloud-sdk-python-common>=3.1.124,<4.0.0"],
     
     version=tencentcloud.__version__,
     description='Tencent Cloud Tokenhub SDK for Python',

{tencentcloud_sdk_python_tokenhub-3.1.115 → tencentcloud_sdk_python_tokenhub-3.1.124}/tencentcloud/__init__.py

@@ -14,4 +14,4 @@
 # limitations under the License.
 
 
-__version__ = '3.1.115'
+__version__ = '3.1.124'

{tencentcloud_sdk_python_tokenhub-3.1.115 → tencentcloud_sdk_python_tokenhub-3.1.124}/tencentcloud/tokenhub/v20260322/models.py

@@ -57,6 +57,10 @@ class ApiKeyDetail(AbstractModel):
         :type IpWhitelist: list of str
         :param _Creator: 当Platform为maas时该字段为空
         :type Creator: str
+        :param _QuotaSet: Token 限额信息多维度列表。未配置限额时不返回该字段。
+        :type QuotaSet: list of QuotaInfo
+        :param _QuotaStatus: Token 限额状态。空字符串表示未配置任何限额包；active 表示已配置且当前可用；inactive 表示已配置但额度耗尽
+        :type QuotaStatus: str
         """
         self._ApiKeyId = None
         self._Name = None
@@ -74,6 +78,8 @@ class ApiKeyDetail(AbstractModel):
         self._BindingItems = None
         self._IpWhitelist = None
         self._Creator = None
+        self._QuotaSet = None
+        self._QuotaStatus = None
 
     @property
     def ApiKeyId(self):
@@ -251,6 +257,28 @@ class ApiKeyDetail(AbstractModel):
     def Creator(self, Creator):
         self._Creator = Creator
 
+    @property
+    def QuotaSet(self):
+        r"""Token 限额信息多维度列表。未配置限额时不返回该字段。
+        :rtype: list of QuotaInfo
+        """
+        return self._QuotaSet
+
+    @QuotaSet.setter
+    def QuotaSet(self, QuotaSet):
+        self._QuotaSet = QuotaSet
+
+    @property
+    def QuotaStatus(self):
+        r"""Token 限额状态。空字符串表示未配置任何限额包；active 表示已配置且当前可用；inactive 表示已配置但额度耗尽
+        :rtype: str
+        """
+        return self._QuotaStatus
+
+    @QuotaStatus.setter
+    def QuotaStatus(self, QuotaStatus):
+        self._QuotaStatus = QuotaStatus
+
 
     def _deserialize(self, params):
         self._ApiKeyId = params.get("ApiKeyId")
@@ -274,6 +302,13 @@ class ApiKeyDetail(AbstractModel):
                 self._BindingItems.append(obj)
         self._IpWhitelist = params.get("IpWhitelist")
         self._Creator = params.get("Creator")
+        if params.get("QuotaSet") is not None:
+            self._QuotaSet = []
+            for item in params.get("QuotaSet"):
+                obj = QuotaInfo()
+                obj._deserialize(item)
+                self._QuotaSet.append(obj)
+        self._QuotaStatus = params.get("QuotaStatus")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -1573,6 +1608,10 @@ class DescribeApiKeyResponse(AbstractModel):
         :type IpWhitelist: list of str
         :param _Creator: 当Platform为maas时该字段为空
         :type Creator: str
+        :param _QuotaSet: Token 限额多维度信息。未配置限额时不返回该字段。
+        :type QuotaSet: list of QuotaInfo
+        :param _QuotaStatus: Token 限额状态。空字符串表示未配置任何限额包；active 表示已配置且当前可用；inactive 表示已配置但额度耗尽
+        :type QuotaStatus: str
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
         """
@@ -1592,6 +1631,8 @@ class DescribeApiKeyResponse(AbstractModel):
         self._BindingItems = None
         self._IpWhitelist = None
         self._Creator = None
+        self._QuotaSet = None
+        self._QuotaStatus = None
         self._RequestId = None
 
     @property
@@ -1770,6 +1811,28 @@ class DescribeApiKeyResponse(AbstractModel):
     def Creator(self, Creator):
         self._Creator = Creator
 
+    @property
+    def QuotaSet(self):
+        r"""Token 限额多维度信息。未配置限额时不返回该字段。
+        :rtype: list of QuotaInfo
+        """
+        return self._QuotaSet
+
+    @QuotaSet.setter
+    def QuotaSet(self, QuotaSet):
+        self._QuotaSet = QuotaSet
+
+    @property
+    def QuotaStatus(self):
+        r"""Token 限额状态。空字符串表示未配置任何限额包；active 表示已配置且当前可用；inactive 表示已配置但额度耗尽
+        :rtype: str
+        """
+        return self._QuotaStatus
+
+    @QuotaStatus.setter
+    def QuotaStatus(self, QuotaStatus):
+        self._QuotaStatus = QuotaStatus
+
     @property
     def RequestId(self):
         r"""唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
@@ -1804,6 +1867,13 @@ class DescribeApiKeyResponse(AbstractModel):
                 self._BindingItems.append(obj)
         self._IpWhitelist = params.get("IpWhitelist")
         self._Creator = params.get("Creator")
+        if params.get("QuotaSet") is not None:
+            self._QuotaSet = []
+            for item in params.get("QuotaSet"):
+                obj = QuotaInfo()
+                obj._deserialize(item)
+                self._QuotaSet.append(obj)
+        self._QuotaStatus = params.get("QuotaStatus")
         self._RequestId = params.get("RequestId")
 
 
@@ -3263,25 +3333,21 @@ class DescribeUsageRankListRequest(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Dimension: 统计维度。取值：apikey（按 APIKey 统计）、endpoint（按接入点统计）、model（按模型统计）。
+        :param _Dimension: <p>统计维度。取值：apikey（按 APIKey 统计）、endpoint（按接入点统计）、model（按模型统计）。</p>
         :type Dimension: str
-        :param _StartTime: 起始时间（闭区间），RFC3339 格式。
+        :param _StartTime: <p>起始时间（闭区间），RFC3339 格式。</p>
         :type StartTime: str
-        :param _EndTime: 结束时间（开区间），RFC3339 格式。与 StartTime 的跨度最大 90 天。
+        :param _EndTime: <p>结束时间（开区间），RFC3339 格式。与 StartTime 的跨度最大 90 天。</p>
         :type EndTime: str
-        :param _MetricType: 指标族切换字段。本期支持 tokens（累计 Token 用量，statistics=sum）；传其他值将返回 InvalidParameter。空字符串或不传时默认 tokens。接口预留 MetricType 字段以支持后续指标族扩展。
+        :param _MetricType: <p>指标族切换字段。</p><ul><li>tokens（默认）：Token 消耗图（statistics=sum），支持 Dimension = apikey/endpoint/model</li><li>search【待上线】：联网搜索调用次数（statistics=sum），仅支持 Dimension = model</li><li>其他值返回 InvalidParameter。</li></ul><p>枚举值：</p><ul><li>tokens： tokens</li></ul>
         :type MetricType: str
-        :param _Target: 维度过滤值。空字符串表示查询全部对象，非空时仅查询指定单个对象（如指定 APIKey ID）。最大 256 字符。
+        :param _Target: <p>维度过滤值。空字符串表示查询全部对象，非空时仅查询指定单个对象（如指定 APIKey ID）。最大 256 字符。</p>
         :type Target: str
-        :param _Period: 统计粒度（秒）。取值：60、300、3600、86400。必须不小于跨度对应下限：跨度 ≤ 1 天 → 60；1 ~ 5 天 → 300；5 ~ 10 天 → 3600；> 10 天 → 86400。仅 ShowAll=false 时使用。
+        :param _Period: <p>统计粒度（秒）。取值：60、300、3600、86400。必须不小于跨度对应下限：跨度 ≤ 1 天 → 60；1 ~ 5 天 → 300；5 ~ 10 天 → 3600；&gt; 10 天 → 86400。仅 ShowAll=false 时使用。</p>
         :type Period: int
-        :param _Offset: 翻页起点，从 0 起，默认 0。ShowAll=true 时忽略。页大小固定为 10。
+        :param _Offset: <p>翻页起点，从 0 起，默认 0。ShowAll=true 时忽略。页大小固定为 10。</p>
         :type Offset: int
-        :param _ShowAll: 是否返回全量结果。
-- false（默认）：按 Offset 分页返回 TopList（每页 10 条），每个对象包含
-  Series 时序点用于绘制曲线。
-- true：忽略 Offset，返回全量对象列表，不返回 Series（CSV 导出场景）。
-
+        :param _ShowAll: <p>是否返回全量结果。</p><ul><li>false（默认）：按 Offset 分页返回 TopList（每页 10 条），每个对象包含<br>Series 时序点用于绘制曲线。</li><li>true：忽略 Offset，返回全量对象列表，不返回 Series（CSV 导出场景）。</li></ul>
         :type ShowAll: bool
         """
         self._Dimension = None
@@ -3295,7 +3361,7 @@ class DescribeUsageRankListRequest(AbstractModel):
 
     @property
     def Dimension(self):
-        r"""统计维度。取值：apikey（按 APIKey 统计）、endpoint（按接入点统计）、model（按模型统计）。
+        r"""<p>统计维度。取值：apikey（按 APIKey 统计）、endpoint（按接入点统计）、model（按模型统计）。</p>
         :rtype: str
         """
         return self._Dimension
@@ -3306,7 +3372,7 @@ class DescribeUsageRankListRequest(AbstractModel):
 
     @property
     def StartTime(self):
-        r"""起始时间（闭区间），RFC3339 格式。
+        r"""<p>起始时间（闭区间），RFC3339 格式。</p>
         :rtype: str
         """
         return self._StartTime
@@ -3317,7 +3383,7 @@ class DescribeUsageRankListRequest(AbstractModel):
 
     @property
     def EndTime(self):
-        r"""结束时间（开区间），RFC3339 格式。与 StartTime 的跨度最大 90 天。
+        r"""<p>结束时间（开区间），RFC3339 格式。与 StartTime 的跨度最大 90 天。</p>
         :rtype: str
         """
         return self._EndTime
@@ -3328,7 +3394,7 @@ class DescribeUsageRankListRequest(AbstractModel):
 
     @property
     def MetricType(self):
-        r"""指标族切换字段。本期支持 tokens（累计 Token 用量，statistics=sum）；传其他值将返回 InvalidParameter。空字符串或不传时默认 tokens。接口预留 MetricType 字段以支持后续指标族扩展。
+        r"""<p>指标族切换字段。</p><ul><li>tokens（默认）：Token 消耗图（statistics=sum），支持 Dimension = apikey/endpoint/model</li><li>search【待上线】：联网搜索调用次数（statistics=sum），仅支持 Dimension = model</li><li>其他值返回 InvalidParameter。</li></ul><p>枚举值：</p><ul><li>tokens： tokens</li></ul>
         :rtype: str
         """
         return self._MetricType
@@ -3339,7 +3405,7 @@ class DescribeUsageRankListRequest(AbstractModel):
 
     @property
     def Target(self):
-        r"""维度过滤值。空字符串表示查询全部对象，非空时仅查询指定单个对象（如指定 APIKey ID）。最大 256 字符。
+        r"""<p>维度过滤值。空字符串表示查询全部对象，非空时仅查询指定单个对象（如指定 APIKey ID）。最大 256 字符。</p>
         :rtype: str
         """
         return self._Target
@@ -3350,7 +3416,7 @@ class DescribeUsageRankListRequest(AbstractModel):
 
     @property
     def Period(self):
-        r"""统计粒度（秒）。取值：60、300、3600、86400。必须不小于跨度对应下限：跨度 ≤ 1 天 → 60；1 ~ 5 天 → 300；5 ~ 10 天 → 3600；> 10 天 → 86400。仅 ShowAll=false 时使用。
+        r"""<p>统计粒度（秒）。取值：60、300、3600、86400。必须不小于跨度对应下限：跨度 ≤ 1 天 → 60；1 ~ 5 天 → 300；5 ~ 10 天 → 3600；&gt; 10 天 → 86400。仅 ShowAll=false 时使用。</p>
         :rtype: int
         """
         return self._Period
@@ -3361,7 +3427,7 @@ class DescribeUsageRankListRequest(AbstractModel):
 
     @property
     def Offset(self):
-        r"""翻页起点，从 0 起，默认 0。ShowAll=true 时忽略。页大小固定为 10。
+        r"""<p>翻页起点，从 0 起，默认 0。ShowAll=true 时忽略。页大小固定为 10。</p>
         :rtype: int
         """
         return self._Offset
@@ -3372,11 +3438,7 @@ class DescribeUsageRankListRequest(AbstractModel):
 
     @property
     def ShowAll(self):
-        r"""是否返回全量结果。
-- false（默认）：按 Offset 分页返回 TopList（每页 10 条），每个对象包含
-  Series 时序点用于绘制曲线。
-- true：忽略 Offset，返回全量对象列表，不返回 Series（CSV 导出场景）。
-
+        r"""<p>是否返回全量结果。</p><ul><li>false（默认）：按 Offset 分页返回 TopList（每页 10 条），每个对象包含<br>Series 时序点用于绘制曲线。</li><li>true：忽略 Offset，返回全量对象列表，不返回 Series（CSV 导出场景）。</li></ul>
         :rtype: bool
         """
         return self._ShowAll
@@ -3412,33 +3474,33 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _Dimension: 回填请求的统计维度。
+        :param _Dimension: <p>回填请求的统计维度。</p>
         :type Dimension: str
-        :param _MetricType: 回填请求的指标族（本期固定为 tokens）。前端按本字段切换图表渲染逻辑。
+        :param _MetricType: <p>回填请求的指标族：tokens / search 。</p>
         :type MetricType: str
-        :param _MetricKeys: 本次响应中 Stats / Series / PageStats / TotalStats 实际包含的 metric key 列表，顺序固定为 [Total, Input, Output]。本期为 [TotalToken, InputTotalToken, OutputTotalToken]。前端可遍历此列表渲染图表，无需硬编码 key 名。
+        :param _MetricKeys: <p>本次响应中 Stats / Series / PageStats / TotalStats 实际包含的 metric key 列表，按MetricType 区分：tokens=[Total,Input,Output,Cache]、search=[SearchRequestCount,SearchCount]</p>
         :type MetricKeys: list of str
-        :param _ViewName: 视图（数据来源）
+        :param _ViewName: <p>视图（数据来源）</p>
         :type ViewName: str
-        :param _Period: 回填请求的统计粒度（秒）。ShowAll=true 时为 0。
+        :param _Period: <p>回填请求的统计粒度（秒）。ShowAll=true 时为 0。</p>
         :type Period: int
-        :param _StartTime: 回填请求的起始时间。
+        :param _StartTime: <p>回填请求的起始时间。</p>
         :type StartTime: str
-        :param _EndTime: 回填请求的结束时间。
+        :param _EndTime: <p>回填请求的结束时间。</p>
         :type EndTime: str
-        :param _Total: 全量对象数。
+        :param _Total: <p>全量对象数。</p>
         :type Total: int
-        :param _Offset: 回填请求的翻页起点。ShowAll=true 时为 0。
+        :param _Offset: <p>回填请求的翻页起点。ShowAll=true 时为 0。</p>
         :type Offset: int
-        :param _Limit: 页大小，恒为 10。ShowAll=true 时为 Total。
+        :param _Limit: <p>页大小，恒为 10。ShowAll=true 时为 Total。</p>
         :type Limit: int
-        :param _Timestamps: Series 数组对应的时间戳序列（Unix 秒）。ShowAll=true 时为空数组。
+        :param _Timestamps: <p>Series 数组对应的时间戳序列（Unix 秒）。ShowAll=true 时为空数组。</p>
         :type Timestamps: list of int
-        :param _TopList: 对象排行列表，按主指标（`MetricKeys[0]`，本期为 TotalToken）降序排序。ShowAll=false 时为当前页 10 个对象（含 Series）；ShowAll=true 时为全量对象（不含 Series，用于 CSV 导出）。
+        :param _TopList: <p>对象排行列表，按<code>MetricKeys[0]</code>降序排序。ShowAll=false 时为当前页 10 个对象（含 Series）；ShowAll=true 时为全量对象（不含 Series，用于 CSV 导出）。</p>
         :type TopList: list of UsageRankItem
-        :param _PageStats: 分页统计结果
+        :param _PageStats: <p>分页统计结果</p>
         :type PageStats: :class:`tencentcloud.tokenhub.v20260322.models.UsageStats`
-        :param _TotalStats: 总统计结果
+        :param _TotalStats: <p>总统计结果</p>
         :type TotalStats: :class:`tencentcloud.tokenhub.v20260322.models.UsageStats`
         :param _RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
         :type RequestId: str
@@ -3461,7 +3523,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def Dimension(self):
-        r"""回填请求的统计维度。
+        r"""<p>回填请求的统计维度。</p>
         :rtype: str
         """
         return self._Dimension
@@ -3472,7 +3534,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def MetricType(self):
-        r"""回填请求的指标族（本期固定为 tokens）。前端按本字段切换图表渲染逻辑。
+        r"""<p>回填请求的指标族：tokens / search 。</p>
         :rtype: str
         """
         return self._MetricType
@@ -3483,7 +3545,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def MetricKeys(self):
-        r"""本次响应中 Stats / Series / PageStats / TotalStats 实际包含的 metric key 列表，顺序固定为 [Total, Input, Output]。本期为 [TotalToken, InputTotalToken, OutputTotalToken]。前端可遍历此列表渲染图表，无需硬编码 key 名。
+        r"""<p>本次响应中 Stats / Series / PageStats / TotalStats 实际包含的 metric key 列表，按MetricType 区分：tokens=[Total,Input,Output,Cache]、search=[SearchRequestCount,SearchCount]</p>
         :rtype: list of str
         """
         return self._MetricKeys
@@ -3494,7 +3556,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def ViewName(self):
-        r"""视图（数据来源）
+        r"""<p>视图（数据来源）</p>
         :rtype: str
         """
         return self._ViewName
@@ -3505,7 +3567,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def Period(self):
-        r"""回填请求的统计粒度（秒）。ShowAll=true 时为 0。
+        r"""<p>回填请求的统计粒度（秒）。ShowAll=true 时为 0。</p>
         :rtype: int
         """
         return self._Period
@@ -3516,7 +3578,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def StartTime(self):
-        r"""回填请求的起始时间。
+        r"""<p>回填请求的起始时间。</p>
         :rtype: str
         """
         return self._StartTime
@@ -3527,7 +3589,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def EndTime(self):
-        r"""回填请求的结束时间。
+        r"""<p>回填请求的结束时间。</p>
         :rtype: str
         """
         return self._EndTime
@@ -3538,7 +3600,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def Total(self):
-        r"""全量对象数。
+        r"""<p>全量对象数。</p>
         :rtype: int
         """
         return self._Total
@@ -3549,7 +3611,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def Offset(self):
-        r"""回填请求的翻页起点。ShowAll=true 时为 0。
+        r"""<p>回填请求的翻页起点。ShowAll=true 时为 0。</p>
         :rtype: int
         """
         return self._Offset
@@ -3560,7 +3622,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def Limit(self):
-        r"""页大小，恒为 10。ShowAll=true 时为 Total。
+        r"""<p>页大小，恒为 10。ShowAll=true 时为 Total。</p>
         :rtype: int
         """
         return self._Limit
@@ -3571,7 +3633,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def Timestamps(self):
-        r"""Series 数组对应的时间戳序列（Unix 秒）。ShowAll=true 时为空数组。
+        r"""<p>Series 数组对应的时间戳序列（Unix 秒）。ShowAll=true 时为空数组。</p>
         :rtype: list of int
         """
         return self._Timestamps
@@ -3582,7 +3644,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def TopList(self):
-        r"""对象排行列表，按主指标（`MetricKeys[0]`，本期为 TotalToken）降序排序。ShowAll=false 时为当前页 10 个对象（含 Series）；ShowAll=true 时为全量对象（不含 Series，用于 CSV 导出）。
+        r"""<p>对象排行列表，按<code>MetricKeys[0]</code>降序排序。ShowAll=false 时为当前页 10 个对象（含 Series）；ShowAll=true 时为全量对象（不含 Series，用于 CSV 导出）。</p>
         :rtype: list of UsageRankItem
         """
         return self._TopList
@@ -3593,7 +3655,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def PageStats(self):
-        r"""分页统计结果
+        r"""<p>分页统计结果</p>
         :rtype: :class:`tencentcloud.tokenhub.v20260322.models.UsageStats`
         """
         return self._PageStats
@@ -3604,7 +3666,7 @@ class DescribeUsageRankListResponse(AbstractModel):
 
     @property
     def TotalStats(self):
-        r"""总统计结果
+        r"""<p>总统计结果</p>
         :rtype: :class:`tencentcloud.tokenhub.v20260322.models.UsageStats`
         """
         return self._TotalStats
@@ -4335,6 +4397,132 @@ class ModifyTokenPlanApiKeySecretResponse(AbstractModel):
         self._RequestId = params.get("RequestId")
 
 
+class QuotaInfo(AbstractModel):
+    r"""Token 限额信息
+
+    """
+
+    def __init__(self):
+        r"""
+        :param _PkgId: 限额包 ID。
+        :type PkgId: str
+        :param _Status: 限额包状态。取值：1（正常）、3（已耗尽）、4（已销毁）。
+        :type Status: int
+        :param _CycleUnit: 限额周期。取值：d（按日）、m（按月）、lifetime（总额度，不重置）。
+        :type CycleUnit: str
+        :param _CycleCredits: 维度当期限额总量（Token 数）。使用字符串避免大数精度丢失。
+        :type CycleCredits: str
+        :param _CycleUsed: 维度当期已使用量（Token 数）。使用字符串避免大数精度丢失。
+        :type CycleUsed: str
+        :param _StartTime: 限额生效起始时间。
+        :type StartTime: str
+        :param _ExpireTime: 限额过期时间。
+        :type ExpireTime: str
+        """
+        self._PkgId = None
+        self._Status = None
+        self._CycleUnit = None
+        self._CycleCredits = None
+        self._CycleUsed = None
+        self._StartTime = None
+        self._ExpireTime = None
+
+    @property
+    def PkgId(self):
+        r"""限额包 ID。
+        :rtype: str
+        """
+        return self._PkgId
+
+    @PkgId.setter
+    def PkgId(self, PkgId):
+        self._PkgId = PkgId
+
+    @property
+    def Status(self):
+        r"""限额包状态。取值：1（正常）、3（已耗尽）、4（已销毁）。
+        :rtype: int
+        """
+        return self._Status
+
+    @Status.setter
+    def Status(self, Status):
+        self._Status = Status
+
+    @property
+    def CycleUnit(self):
+        r"""限额周期。取值：d（按日）、m（按月）、lifetime（总额度，不重置）。
+        :rtype: str
+        """
+        return self._CycleUnit
+
+    @CycleUnit.setter
+    def CycleUnit(self, CycleUnit):
+        self._CycleUnit = CycleUnit
+
+    @property
+    def CycleCredits(self):
+        r"""维度当期限额总量（Token 数）。使用字符串避免大数精度丢失。
+        :rtype: str
+        """
+        return self._CycleCredits
+
+    @CycleCredits.setter
+    def CycleCredits(self, CycleCredits):
+        self._CycleCredits = CycleCredits
+
+    @property
+    def CycleUsed(self):
+        r"""维度当期已使用量（Token 数）。使用字符串避免大数精度丢失。
+        :rtype: str
+        """
+        return self._CycleUsed
+
+    @CycleUsed.setter
+    def CycleUsed(self, CycleUsed):
+        self._CycleUsed = CycleUsed
+
+    @property
+    def StartTime(self):
+        r"""限额生效起始时间。
+        :rtype: str
+        """
+        return self._StartTime
+
+    @StartTime.setter
+    def StartTime(self, StartTime):
+        self._StartTime = StartTime
+
+    @property
+    def ExpireTime(self):
+        r"""限额过期时间。
+        :rtype: str
+        """
+        return self._ExpireTime
+
+    @ExpireTime.setter
+    def ExpireTime(self, ExpireTime):
+        self._ExpireTime = ExpireTime
+
+
+    def _deserialize(self, params):
+        self._PkgId = params.get("PkgId")
+        self._Status = params.get("Status")
+        self._CycleUnit = params.get("CycleUnit")
+        self._CycleCredits = params.get("CycleCredits")
+        self._CycleUsed = params.get("CycleUsed")
+        self._StartTime = params.get("StartTime")
+        self._ExpireTime = params.get("ExpireTime")
+        memeber_set = set(params.keys())
+        for name, value in vars(self).items():
+            property_name = name[1:]
+            if property_name in memeber_set:
+                memeber_set.remove(property_name)
+        if len(memeber_set) > 0:
+            warnings.warn("%s fileds are useless." % ",".join(memeber_set))
+        
+
+
 class RenewTokenPlanTeamOrderRequest(AbstractModel):
     r"""RenewTokenPlanTeamOrder请求参数结构体
 
@@ -6290,20 +6478,29 @@ class UsageSeries(AbstractModel):
 
     def __init__(self):
         r"""
-        :param _TotalToken: 总 token 数用量时间周期内的 JSON 字符串形式，如 `"[12,null,15]"`。
+        :param _TotalToken: <p>[tokens 族]总 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[12,null,15]&quot;</code>。</p>
         :type TotalToken: str
-        :param _InputTotalToken: 输入 token 数用量时间周期内的 JSON 字符串形式，如 `"[7,null,9]"`。
+        :param _InputTotalToken: <p>[tokens 族]输入 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[7,null,9]&quot;</code>。</p>
         :type InputTotalToken: str
-        :param _OutputTotalToken: 输出 token 数用量时间周期内的 JSON 字符串形式，如 `"[5,null,6]"`。
+        :param _OutputTotalToken: <p>[tokens 族]输出 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[5,null,6]&quot;</code>。</p>
         :type OutputTotalToken: str
+        :param _CacheTotalToken: <p>[tokens 族]读缓存 token 数用量时间周期内的 JSON 字符串形式，如<code>&quot;[5,null,6]&quot;</code>。</p>
+        :type CacheTotalToken: str
+        :param _SearchRequestCount: <p>[search 族] 搜索请求数用量时间周期内的 JSON 字符串形式，如<code>&quot;[5,null,6]&quot;</code>。</p>
+        :type SearchRequestCount: str
+        :param _SearchCount: <p>[search 族] 搜索引擎调用次数用量时间周期内的 JSON 字符串形式，如<code>&quot;[5,null,6]&quot;</code>。</p>
+        :type SearchCount: str
         """
         self._TotalToken = None
         self._InputTotalToken = None
         self._OutputTotalToken = None
+        self._CacheTotalToken = None
+        self._SearchRequestCount = None
+        self._SearchCount = None
 
     @property
     def TotalToken(self):
-        r"""总 token 数用量时间周期内的 JSON 字符串形式，如 `"[12,null,15]"`。
+        r"""<p>[tokens 族]总 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[12,null,15]&quot;</code>。</p>
         :rtype: str
         """
         return self._TotalToken
@@ -6314,7 +6511,7 @@ class UsageSeries(AbstractModel):
 
     @property
     def InputTotalToken(self):
-        r"""输入 token 数用量时间周期内的 JSON 字符串形式，如 `"[7,null,9]"`。
+        r"""<p>[tokens 族]输入 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[7,null,9]&quot;</code>。</p>
         :rtype: str
         """
         return self._InputTotalToken
@@ -6325,7 +6522,7 @@ class UsageSeries(AbstractModel):
 
     @property
     def OutputTotalToken(self):
-        r"""输出 token 数用量时间周期内的 JSON 字符串形式，如 `"[5,null,6]"`。
+        r"""<p>[tokens 族]输出 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[5,null,6]&quot;</code>。</p>
         :rtype: str
         """
         return self._OutputTotalToken
@@ -6334,11 +6531,47 @@ class UsageSeries(AbstractModel):
     def OutputTotalToken(self, OutputTotalToken):
         self._OutputTotalToken = OutputTotalToken
 
+    @property
+    def CacheTotalToken(self):
+        r"""<p>[tokens 族]读缓存 token 数用量时间周期内的 JSON 字符串形式，如<code>&quot;[5,null,6]&quot;</code>。</p>
+        :rtype: str
+        """
+        return self._CacheTotalToken
+
+    @CacheTotalToken.setter
+    def CacheTotalToken(self, CacheTotalToken):
+        self._CacheTotalToken = CacheTotalToken
+
+    @property
+    def SearchRequestCount(self):
+        r"""<p>[search 族] 搜索请求数用量时间周期内的 JSON 字符串形式，如<code>&quot;[5,null,6]&quot;</code>。</p>
+        :rtype: str
+        """
+        return self._SearchRequestCount
+
+    @SearchRequestCount.setter
+    def SearchRequestCount(self, SearchRequestCount):
+        self._SearchRequestCount = SearchRequestCount
+
+    @property
+    def SearchCount(self):
+        r"""<p>[search 族] 搜索引擎调用次数用量时间周期内的 JSON 字符串形式，如<code>&quot;[5,null,6]&quot;</code>。</p>
+        :rtype: str
+        """
+        return self._SearchCount
+
+    @SearchCount.setter
+    def SearchCount(self, SearchCount):
+        self._SearchCount = SearchCount
+
 
     def _deserialize(self, params):
         self._TotalToken = params.get("TotalToken")
         self._InputTotalToken = params.get("InputTotalToken")
         self._OutputTotalToken = params.get("OutputTotalToken")
+        self._CacheTotalToken = params.get("CacheTotalToken")
+        self._SearchRequestCount = params.get("SearchRequestCount")
+        self._SearchCount = params.get("SearchCount")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]
@@ -6350,26 +6583,35 @@ class UsageSeries(AbstractModel):
 
 
 class UsageStats(AbstractModel):
-    r"""时间周期内的统计聚合值（按 metric key 索引）。本期返回 tokens 族（statistics=sum）的累计 Token 用量；具体包含哪些 key、顺序如何，参见响应顶层 `MetricKeys` 字段。接口预留 MetricType 字段以支持后续指标族扩展，本期仅支持 tokens。
+    r"""时间周期内的统计聚合值（按 metric key 索引）。声明 tokens / search 两族字段都在本 schema 中，按 MetricKeys 实际返回取值，参见响应顶层 `MetricKeys` 字段。
 
     """
 
     def __init__(self):
         r"""
-        :param _TotalToken: 时间周期内的累计总 token 数。
+        :param _TotalToken: <p>[tokens 族] 时间周期内的累计总 token 数。</p>
         :type TotalToken: int
-        :param _InputTotalToken: 时间周期内的累计输入 token 数。
+        :param _InputTotalToken: <p>[tokens 族] 时间周期内的累计输入 token 数。</p>
         :type InputTotalToken: int
-        :param _OutputTotalToken: 时间周期内的累计输出 token 数。
+        :param _OutputTotalToken: <p>[tokens 族] 时间周期内的累计输出 token 数。</p>
         :type OutputTotalToken: int
+        :param _CacheTotalToken: <p>[tokens 族] 时间周期内的累计读缓存 token 数（命中缓存部分）</p>
+        :type CacheTotalToken: int
+        :param _SearchRequestCount: <p>[search 族] 整段累计联网搜索请求数</p>
+        :type SearchRequestCount: int
+        :param _SearchCount: <p>[search 族] 整段累计搜索引擎调用次数</p>
+        :type SearchCount: int
         """
         self._TotalToken = None
         self._InputTotalToken = None
         self._OutputTotalToken = None
+        self._CacheTotalToken = None
+        self._SearchRequestCount = None
+        self._SearchCount = None
 
     @property
     def TotalToken(self):
-        r"""时间周期内的累计总 token 数。
+        r"""<p>[tokens 族] 时间周期内的累计总 token 数。</p>
         :rtype: int
         """
         return self._TotalToken
@@ -6380,7 +6622,7 @@ class UsageStats(AbstractModel):
 
     @property
     def InputTotalToken(self):
-        r"""时间周期内的累计输入 token 数。
+        r"""<p>[tokens 族] 时间周期内的累计输入 token 数。</p>
         :rtype: int
         """
         return self._InputTotalToken
@@ -6391,7 +6633,7 @@ class UsageStats(AbstractModel):
 
     @property
     def OutputTotalToken(self):
-        r"""时间周期内的累计输出 token 数。
+        r"""<p>[tokens 族] 时间周期内的累计输出 token 数。</p>
         :rtype: int
         """
         return self._OutputTotalToken
@@ -6400,11 +6642,47 @@ class UsageStats(AbstractModel):
     def OutputTotalToken(self, OutputTotalToken):
         self._OutputTotalToken = OutputTotalToken
 
+    @property
+    def CacheTotalToken(self):
+        r"""<p>[tokens 族] 时间周期内的累计读缓存 token 数（命中缓存部分）</p>
+        :rtype: int
+        """
+        return self._CacheTotalToken
+
+    @CacheTotalToken.setter
+    def CacheTotalToken(self, CacheTotalToken):
+        self._CacheTotalToken = CacheTotalToken
+
+    @property
+    def SearchRequestCount(self):
+        r"""<p>[search 族] 整段累计联网搜索请求数</p>
+        :rtype: int
+        """
+        return self._SearchRequestCount
+
+    @SearchRequestCount.setter
+    def SearchRequestCount(self, SearchRequestCount):
+        self._SearchRequestCount = SearchRequestCount
+
+    @property
+    def SearchCount(self):
+        r"""<p>[search 族] 整段累计搜索引擎调用次数</p>
+        :rtype: int
+        """
+        return self._SearchCount
+
+    @SearchCount.setter
+    def SearchCount(self, SearchCount):
+        self._SearchCount = SearchCount
+
 
     def _deserialize(self, params):
         self._TotalToken = params.get("TotalToken")
         self._InputTotalToken = params.get("InputTotalToken")
         self._OutputTotalToken = params.get("OutputTotalToken")
+        self._CacheTotalToken = params.get("CacheTotalToken")
+        self._SearchRequestCount = params.get("SearchRequestCount")
+        self._SearchCount = params.get("SearchCount")
         memeber_set = set(params.keys())
         for name, value in vars(self).items():
             property_name = name[1:]

{tencentcloud_sdk_python_tokenhub-3.1.115 → tencentcloud_sdk_python_tokenhub-3.1.124}/tencentcloud/tokenhub/v20260322/tokenhub_client.py

@@ -477,9 +477,17 @@ class TokenhubClient(AbstractClient):
     def DescribeUsageRankList(self, request):
         r"""查询用量排行列表。
 
-        按 apikey、endpoint、model 三个维度统计指定时间窗内的用量排行，返回顶部数据卡所需的 PageStats/TotalStats、左侧 Top 列表（含每对象整段累计值）、右侧色块趋势图所需的逐点曲线。前端通过 Offset 翻页、ShowAll 切换 CSV 全量导出模式。
-
-        MetricType 字段用于切换指标族，本期支持 tokens；接口预留以支持后续指标族扩展。响应回显 MetricType 与 MetricKeys（实际参与渲染的 metric key 列表，顺序固定 [Total, Input, Output]），前端按此渲染顶部数据卡与趋势图，无需硬编码 key 名。
+        指标族（MetricType）
+        - `tokens`（默认）：Token 用量统计。支持 Dimension = apikey / endpoint / model。
+          返回指标：TotalToken（总）/ InputTotalToken（输入）/ OutputTotalToken（输出）/ CacheTotalToken（读缓存）。
+        - `search`：【待上线】联网搜索用量统计。支持 Dimension = apikey / endpoint / model。
+          返回指标：SearchRequestCount（搜索请求数）/ SearchCount（搜索引擎调用次数）。
+
+        响应内容
+        - MetricType 字段用于切换指标族，响应回显 MetricType 与 MetricKeys。
+        - TotalStats：时间窗内全部对象的整段聚合值。
+        - PageStats：当前翻页内对象的整段聚合值。
+        - TopList：按MetricKeys[0]降序的对象列表，含整段聚合值与逐时间点曲线。
 
         :param request: Request instance for DescribeUsageRankList.
         :type request: :class:`tencentcloud.tokenhub.v20260322.models.DescribeUsageRankListRequest`

{tencentcloud_sdk_python_tokenhub-3.1.115 → tencentcloud_sdk_python_tokenhub-3.1.124}/tencentcloud/tokenhub/v20260322/tokenhub_client_async.py

@@ -391,9 +391,17 @@ class TokenhubClient(AbstractClient):
         """
         查询用量排行列表。
 
-        按 apikey、endpoint、model 三个维度统计指定时间窗内的用量排行，返回顶部数据卡所需的 PageStats/TotalStats、左侧 Top 列表（含每对象整段累计值）、右侧色块趋势图所需的逐点曲线。前端通过 Offset 翻页、ShowAll 切换 CSV 全量导出模式。
+        指标族（MetricType）
+        - `tokens`（默认）：Token 用量统计。支持 Dimension = apikey / endpoint / model。
+          返回指标：TotalToken（总）/ InputTotalToken（输入）/ OutputTotalToken（输出）/ CacheTotalToken（读缓存）。
+        - `search`：【待上线】联网搜索用量统计。支持 Dimension = apikey / endpoint / model。
+          返回指标：SearchRequestCount（搜索请求数）/ SearchCount（搜索引擎调用次数）。
 
-        MetricType 字段用于切换指标族，本期支持 tokens；接口预留以支持后续指标族扩展。响应回显 MetricType 与 MetricKeys（实际参与渲染的 metric key 列表，顺序固定 [Total, Input, Output]），前端按此渲染顶部数据卡与趋势图，无需硬编码 key 名。
+        响应内容
+        - MetricType 字段用于切换指标族，响应回显 MetricType 与 MetricKeys。
+        - TotalStats：时间窗内全部对象的整段聚合值。
+        - PageStats：当前翻页内对象的整段聚合值。
+        - TopList：按MetricKeys[0]降序的对象列表，含整段聚合值与逐时间点曲线。
         """
         
         kwargs = {}

{tencentcloud_sdk_python_tokenhub-3.1.115 → tencentcloud_sdk_python_tokenhub-3.1.124}/tencentcloud_sdk_python_tokenhub.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: tencentcloud-sdk-python-tokenhub
-Version: 3.1.115
+Version: 3.1.124
 Summary: Tencent Cloud Tokenhub SDK for Python
 Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
 Author: Tencent Cloud
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
-Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.115
+Requires-Dist: tencentcloud-sdk-python-common<4.0.0,>=3.1.124
 
 ============================
 Tencent Cloud SDK for Python

tencentcloud_sdk_python_tokenhub-3.1.124/tencentcloud_sdk_python_tokenhub.egg-info/requires.txt

@@ -0,0 +1 @@
+tencentcloud-sdk-python-common<4.0.0,>=3.1.124

tencentcloud_sdk_python_tokenhub-3.1.115/tencentcloud_sdk_python_tokenhub.egg-info/requires.txt

@@ -1 +0,0 @@
-tencentcloud-sdk-python-common<4.0.0,>=3.1.115