tencentcloud-sdk-python-tokenhub 3.1.106__py2.py3-none-any.whl

tencentcloud/tokenhub/v20260322/tokenhub_client_async.py

@@ -0,0 +1,346 @@
+# -*- coding: utf8 -*-
+# Copyright (c) 2017-2025 Tencent. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+
+from tencentcloud.common.abstract_client_async import AbstractClient
+from tencentcloud.tokenhub.v20260322 import models
+from typing import Dict
+
+
+class TokenhubClient(AbstractClient):
+    _apiVersion = '2026-03-22'
+    _endpoint = 'tokenhub.tencentcloudapi.com'
+    _service = 'tokenhub'
+
+    async def CreateTokenPlanApiKeys(
+            self,
+            request: models.CreateTokenPlanApiKeysRequest,
+            opts: Dict = None,
+    ) -> models.CreateTokenPlanApiKeysResponse:
+        """
+        批量创建 TokenPlan APIKey。
+
+        传入名称前缀和数量，自动按 {ApiKeyName}-{序号} 格式生成名称（如 aaa-1, aaa-2）。允许同名。支持部分成功，最多 100 条。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "CreateTokenPlanApiKeys"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.CreateTokenPlanApiKeysResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def CreateTokenPlanTeamOrderAndBuy(
+            self,
+            request: models.CreateTokenPlanTeamOrderAndBuyRequest,
+            opts: Dict = None,
+    ) -> models.CreateTokenPlanTeamOrderAndBuyResponse:
+        """
+        购买套餐。
+
+        发起 TokenPlan 套餐下单并完成支付，成功后返回大订单 ID 及关联的子订单、资源信息。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "CreateTokenPlanTeamOrderAndBuy"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.CreateTokenPlanTeamOrderAndBuyResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DeleteTokenPlanApiKey(
+            self,
+            request: models.DeleteTokenPlanApiKeyRequest,
+            opts: Dict = None,
+    ) -> models.DeleteTokenPlanApiKeyResponse:
+        """
+        删除 TokenPlan APIKey。
+
+        同时删除额度中心子额度包并通知网关清除缓存。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DeleteTokenPlanApiKey"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DeleteTokenPlanApiKeyResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeApiKey(
+            self,
+            request: models.DescribeApiKeyRequest,
+            opts: Dict = None,
+    ) -> models.DescribeApiKeyResponse:
+        """
+        根据 API 密钥 ID 或密钥值查询 API 密钥详情，返回明文密钥。ApiKeyId 和 ApiKey 至少需传入其一，优先使用 ApiKeyId。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeApiKey"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeApiKeyResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeApiKeyList(
+            self,
+            request: models.DescribeApiKeyListRequest,
+            opts: Dict = None,
+    ) -> models.DescribeApiKeyListResponse:
+        """
+        查询 API 密钥列表。
+
+        查询当前用户的 API 密钥列表，密钥值脱敏展示。支持分页、过滤和排序。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeApiKeyList"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeApiKeyListResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeTokenPlan(
+            self,
+            request: models.DescribeTokenPlanRequest,
+            opts: Dict = None,
+    ) -> models.DescribeTokenPlanResponse:
+        """
+        查询 TokenPlan 套餐详情。
+
+        返回套餐基本信息及额度中心主额度包余量。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeTokenPlan"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeTokenPlanResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeTokenPlanApiKey(
+            self,
+            request: models.DescribeTokenPlanApiKeyRequest,
+            opts: Dict = None,
+    ) -> models.DescribeTokenPlanApiKeyResponse:
+        """
+        查询 TokenPlan APIKey 详情。
+
+        返回 APIKey 完整信息（含明文密钥）及子额度包余量。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeTokenPlanApiKey"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeTokenPlanApiKeyResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeTokenPlanApiKeyList(
+            self,
+            request: models.DescribeTokenPlanApiKeyListRequest,
+            opts: Dict = None,
+    ) -> models.DescribeTokenPlanApiKeyListResponse:
+        """
+        查询 TokenPlan APIKey 列表。
+
+        返回指定套餐下的 APIKey 列表，密钥已脱敏。主账号可查看全部，子账号仅可查看自己创建的。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeTokenPlanApiKeyList"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeTokenPlanApiKeyListResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeTokenPlanApiKeySecret(
+            self,
+            request: models.DescribeTokenPlanApiKeySecretRequest,
+            opts: Dict = None,
+    ) -> models.DescribeTokenPlanApiKeySecretResponse:
+        """
+        查询 TokenPlan APIKey 密钥（明文）。
+
+        返回指定 APIKey 的明文密钥值，请妥善保管。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeTokenPlanApiKeySecret"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeTokenPlanApiKeySecretResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeTokenPlanApiKeyUsageDetail(
+            self,
+            request: models.DescribeTokenPlanApiKeyUsageDetailRequest,
+            opts: Dict = None,
+    ) -> models.DescribeTokenPlanApiKeyUsageDetailResponse:
+        """
+        查询 TokenPlan APIKey 调用明细。
+
+        从 CLS 日志服务查询套餐下的调用明细，按 pkg_id 过滤，支持游标分页。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeTokenPlanApiKeyUsageDetail"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeTokenPlanApiKeyUsageDetailResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeTokenPlanList(
+            self,
+            request: models.DescribeTokenPlanListRequest,
+            opts: Dict = None,
+    ) -> models.DescribeTokenPlanListResponse:
+        """
+        查询 TokenPlan 套餐列表。
+
+        支持分页、过滤和排序。主账号可查看全部，子账号仅可查看自己创建的。返回结果包含每个套餐关联的额度中心主额度包详情。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeTokenPlanList"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeTokenPlanListResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def DescribeUsageRankList(
+            self,
+            request: models.DescribeUsageRankListRequest,
+            opts: Dict = None,
+    ) -> models.DescribeUsageRankListResponse:
+        """
+        查询用量排行列表。
+
+        按 apikey、endpoint、model 三个维度统计指定时间窗内的用量排行，返回顶部数据卡所需的 PageStats/TotalStats、左侧 Top 列表（含每对象整段累计值）、右侧色块趋势图所需的逐点曲线。前端通过 Offset 翻页、ShowAll 切换 CSV 全量导出模式。
+
+        MetricType 字段用于切换指标族，本期支持 tokens；接口预留以支持后续指标族扩展。响应回显 MetricType 与 MetricKeys（实际参与渲染的 metric key 列表，顺序固定 [Total, Input, Output]），前端按此渲染顶部数据卡与趋势图，无需硬编码 key 名。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "DescribeUsageRankList"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.DescribeUsageRankListResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def ModifyTokenPlanApiKey(
+            self,
+            request: models.ModifyTokenPlanApiKeyRequest,
+            opts: Dict = None,
+    ) -> models.ModifyTokenPlanApiKeyResponse:
+        """
+        修改 TokenPlan APIKey 配置（网关关注字段）。
+
+        修改后自动通知网关更新缓存并同步额度中心。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ModifyTokenPlanApiKey"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ModifyTokenPlanApiKeyResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def ModifyTokenPlanApiKeySecret(
+            self,
+            request: models.ModifyTokenPlanApiKeySecretRequest,
+            opts: Dict = None,
+    ) -> models.ModifyTokenPlanApiKeySecretResponse:
+        """
+        重置 TokenPlan APIKey 密钥。
+
+        重新生成密钥值，密钥版本号递增，旧密钥立即失效。APIKey ID 不变。重置后需通过 DescribeTokenPlanApiKeySecret 查询新密钥。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "ModifyTokenPlanApiKeySecret"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.ModifyTokenPlanApiKeySecretResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def RenewTokenPlanTeamOrder(
+            self,
+            request: models.RenewTokenPlanTeamOrderRequest,
+            opts: Dict = None,
+    ) -> models.RenewTokenPlanTeamOrderResponse:
+        """
+        续费套餐。
+
+        对已有的 TokenPlan 套餐发起续费下单并完成支付，成功后返回大订单 ID 及关联的子订单、资源信息。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "RenewTokenPlanTeamOrder"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.RenewTokenPlanTeamOrderResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)
+        
+    async def UpgradeTokenPlanTeamOrder(
+            self,
+            request: models.UpgradeTokenPlanTeamOrderRequest,
+            opts: Dict = None,
+    ) -> models.UpgradeTokenPlanTeamOrderResponse:
+        """
+        升配套餐。
+
+        对已有的 TokenPlan 套餐发起升配下单并完成支付，扩容积分或 Token 额度，成功后返回大订单 ID 及关联的子订单、资源信息。新额度必须大于当前额度。
+        """
+        
+        kwargs = {}
+        kwargs["action"] = "UpgradeTokenPlanTeamOrder"
+        kwargs["params"] = request._serialize()
+        kwargs["resp_cls"] = models.UpgradeTokenPlanTeamOrderResponse
+        kwargs["headers"] = request.headers
+        kwargs["opts"] = opts or {}
+        
+        return await self.call_and_deserialize(**kwargs)

tencentcloud_sdk_python_tokenhub-3.1.106.dist-info/METADATA

@@ -0,0 +1,46 @@
+Metadata-Version: 2.1
+Name: tencentcloud-sdk-python-tokenhub
+Version: 3.1.106
+Summary: Tencent Cloud Tokenhub SDK for Python
+Home-page: https://github.com/TencentCloud/tencentcloud-sdk-python
+Author: Tencent Cloud
+Maintainer-email: tencentcloudapi@tencent.com
+License: Apache License 2.0
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python
+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.106
+
+============================
+Tencent Cloud SDK for Python
+============================
+
+Tencent Cloud Python Tokenhub SDK is the official software development kit, which allows Python developers to write software that makes use of Tencent Cloud services like CVM and CBS.
+The SDK works on Python versions:
+
+   * 2.7 and greater, including 3.x
+
+Quick Start
+-----------
+
+First, install the library:
+
+.. code-block:: sh
+
+    $ pip install tencentcloud-sdk-python-common
+    $ pip install tencentcloud-sdk-python-tokenhub
+
+or download source code from github and install:
+
+.. code-block:: sh
+
+    $ git clone https://github.com/tencentcloud/tencentcloud-sdk-python.git
+    $ cd tencentcloud-sdk-python
+    $ python package.py --components common tokenhub
+

tencentcloud_sdk_python_tokenhub-3.1.106.dist-info/RECORD

@@ -0,0 +1,11 @@
+tencentcloud/__init__.py,sha256=NnhqlJlkdALH49n6wVHJgZsZTZ5ZqRT6-bJscLnyLNw,630
+tencentcloud/tokenhub/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tencentcloud/tokenhub/v20260322/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tencentcloud/tokenhub/v20260322/errorcodes.py,sha256=LP9PbP5xI6k6L7L1R_XB8T4nC17f-te0kwMvnxN2RaQ,1857
+tencentcloud/tokenhub/v20260322/models.py,sha256=blY6StXHkHX3EzJI6jVOxzEN-CF-Xfc2s3SNAO5I1gE,148717
+tencentcloud/tokenhub/v20260322/tokenhub_client.py,sha256=QhQmXatX4iTfPNP4H_YV6UX-jYZTpbegP00daTuoV9o,18335
+tencentcloud/tokenhub/v20260322/tokenhub_client_async.py,sha256=F7d3G2e9Y_QVBRtZDZi1thjYzFFhgMB73jvmHogfLd8,13206
+tencentcloud_sdk_python_tokenhub-3.1.106.dist-info/METADATA,sha256=A50TcfdSbmPa2g9vgOnA9P7p3WIDf53r-QPCpgzO9xU,1522
+tencentcloud_sdk_python_tokenhub-3.1.106.dist-info/WHEEL,sha256=a5ogxI61vGGBHYbAAwISCXsfU7mxKr76gTpCEmSNOI8,109
+tencentcloud_sdk_python_tokenhub-3.1.106.dist-info/top_level.txt,sha256=g-8OyzoqI6O6LiS85zkeNzhB-osEnRIPZMdyRd_0eL0,13
+tencentcloud_sdk_python_tokenhub-3.1.106.dist-info/RECORD,,

tencentcloud_sdk_python_tokenhub-3.1.106.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.3.4)
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any
+

tencentcloud_sdk_python_tokenhub-3.1.106.dist-info/top_level.txt

@@ -0,0 +1 @@
+tencentcloud