tencentcloud-sdk-nodejs-tokenhub 4.1.309 → 4.1.312

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tencentcloud-sdk-nodejs-tokenhub",
-  "version": "4.1.309",
+  "version": "4.1.312",
   "description": "腾讯云 API NODEJS SDK",
   "main": "./tencentcloud/index.js",
   "module": "./es/index.js",

package/tencentcloud/services/tokenhub/v20260322/tokenhub_client.d.ts

@@ -95,8 +95,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
   指标族（MetricType）
   - `tokens`（默认）：Token 用量统计。支持 Dimension = apikey / endpoint / model。
     返回指标：TotalToken（总）/ InputTotalToken（输入）/ OutputTotalToken（输出）/ CacheTotalToken（读缓存）。
-  - `search`：【待上线】联网搜索用量统计。支持 Dimension = apikey / endpoint / model。
+  - `search`：联网搜索用量统计。支持 Dimension = apikey / endpoint / model。
     返回指标：SearchRequestCount（搜索请求数）/ SearchCount（搜索引擎调用次数）。
+  - `apikey_usage`：APIKey 锚定用量统计（某 APIKey 下按模型或接入点展开）。支持 Dimension = endpoint / model。
+    返回指标：TotalToken（总 Token）/ InputTotalToken（输入 Token）/ OutputTotalToken（输出 Token）/ CacheTotalToken（读缓存）/ RequestCount（请求次数）/ SuccessCount（成功次数）。
   
   响应内容
   - MetricType 字段用于切换指标族，响应回显 MetricType 与 MetricKeys。

package/tencentcloud/services/tokenhub/v20260322/tokenhub_client.js

@@ -145,8 +145,10 @@ class Client extends TencentCloudCommon.AbstractClient {
   指标族（MetricType）
   - `tokens`（默认）：Token 用量统计。支持 Dimension = apikey / endpoint / model。
     返回指标：TotalToken（总）/ InputTotalToken（输入）/ OutputTotalToken（输出）/ CacheTotalToken（读缓存）。
-  - `search`：【待上线】联网搜索用量统计。支持 Dimension = apikey / endpoint / model。
+  - `search`：联网搜索用量统计。支持 Dimension = apikey / endpoint / model。
     返回指标：SearchRequestCount（搜索请求数）/ SearchCount（搜索引擎调用次数）。
+  - `apikey_usage`：APIKey 锚定用量统计（某 APIKey 下按模型或接入点展开）。支持 Dimension = endpoint / model。
+    返回指标：TotalToken（总 Token）/ InputTotalToken（输入 Token）/ OutputTotalToken（输出 Token）/ CacheTotalToken（读缓存）/ RequestCount（请求次数）/ SuccessCount（成功次数）。
   
   响应内容
   - MetricType 字段用于切换指标族，响应回显 MetricType 与 MetricKeys。

package/tencentcloud/services/tokenhub/v20260322/tokenhub_models.d.ts

@@ -176,19 +176,19 @@ export interface ModelImage {
  */
 export interface UsageSeries {
     /**
-     * <p>[tokens 族]总 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[12,null,15]&quot;</code>。</p>
+     * <p>[tokens / apikey_usage 族]总 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[12,null,15]&quot;</code>。</p>
      */
     TotalToken?: string;
     /**
-     * <p>[tokens 族]输入 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[7,null,9]&quot;</code>。</p>
+     * <p>[tokens / apikey_usage 族]输入 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[7,null,9]&quot;</code>。</p>
      */
     InputTotalToken?: string;
     /**
-     * <p>[tokens 族]输出 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[5,null,6]&quot;</code>。</p>
+     * <p>[tokens / apikey_usage 族]输出 token 数用量时间周期内的 JSON 字符串形式，如 <code>&quot;[5,null,6]&quot;</code>。</p>
      */
     OutputTotalToken?: string;
     /**
-     * <p>[tokens 族]读缓存 token 数用量时间周期内的 JSON 字符串形式，如<code>&quot;[5,null,6]&quot;</code>。</p>
+     * <p>[tokens / apikey_usage 族]读缓存 token 数用量时间周期内的 JSON 字符串形式，如<code>&quot;[5,null,6]&quot;</code>。</p>
      */
     CacheTotalToken?: string;
     /**
@@ -199,6 +199,14 @@ export interface UsageSeries {
      * <p>[search 族] 搜索引擎调用次数用量时间周期内的 JSON 字符串形式，如<code>&quot;[5,null,6]&quot;</code>。</p>
      */
     SearchCount?: string;
+    /**
+     * <p>[apikey_usage 族] 请求次数在时间周期内的 JSON 字符串形式，如 <code>&quot;[12,null,15]&quot;</code>。</p>
+     */
+    RequestCount?: string;
+    /**
+     * <p>[apikey_usage 族] 请求失败次数在时间周期内的 JSON 字符串形式，如 &quot;[12,null,15]&quot;。</p>
+     */
+    RequestFailCount?: string;
 }
 /**
  * DescribeTokenPlanList返回参数结构体
@@ -1190,33 +1198,41 @@ export interface TokenPlanPackageInfo {
     RemainCycles?: number;
 }
 /**
- * 时间周期内的统计聚合值（按 metric key 索引）。声明 tokens / search 两族字段都在本 schema 中，按 MetricKeys 实际返回取值，参见响应顶层 `MetricKeys` 字段。
+ * 时间周期内的统计聚合值，按 MetricKeys 实际返回取值，参见响应顶层 `MetricKeys` 字段。
  */
 export interface UsageStats {
     /**
-     * <p>[tokens 族] 时间周期内的累计总 token 数。</p>
+     * <p>[tokens / apikey_usage 族] 时间周期内的累计总 token 数。</p>
      */
     TotalToken?: number;
     /**
-     * <p>[tokens 族] 时间周期内的累计输入 token 数。</p>
+     * <p>[tokens / apikey_usage 族] 时间周期内的累计输入 token 数。</p>
      */
     InputTotalToken?: number;
     /**
-     * <p>[tokens 族] 时间周期内的累计输出 token 数。</p>
+     * <p>[tokens / apikey_usage 族] 时间周期内的累计输出 token 数。</p>
      */
     OutputTotalToken?: number;
     /**
-     * <p>[tokens 族] 时间周期内的累计读缓存 token 数（命中缓存部分）</p>
+     * <p>[tokens / apikey_usage 族] 时间周期内的累计读缓存 token 数（命中缓存部分）注意：CacheTotalToken 是 InputTotalToken 的子集（已包含在内）。</p>
      */
     CacheTotalToken?: number;
     /**
-     * <p>[search 族] 整段累计联网搜索请求数</p>
+     * <p>[search 族] 时间周期内的累计联网搜索请求数</p>
      */
     SearchRequestCount?: number;
     /**
-     * <p>[search 族] 整段累计搜索引擎调用次数</p>
+     * <p>[search 族] 时间周期内的累计搜索引擎调用次数</p>
      */
     SearchCount?: number;
+    /**
+     * <p>[apikey_usage 族] 时间周期内的累计请求次数</p>
+     */
+    RequestCount?: number;
+    /**
+     * <p>[apikey_usage 族] 时间周期内的累计请求失败次数</p>
+     */
+    RequestFailCount?: number;
 }
 /**
  * DescribeUsageRankList返回参数结构体
@@ -1227,11 +1243,11 @@ export interface DescribeUsageRankListResponse {
      */
     Dimension?: string;
     /**
-     * <p>回填请求的指标族：tokens / search 。</p>
+     * <p>回填请求的指标族：取值同入参 MetricType（tokens / search / apikey_usage）</p><p>枚举值：</p><ul><li>tokens： tokens</li></ul>
      */
     MetricType?: string;
     /**
-     * <p>本次响应中 Stats / Series / PageStats / TotalStats 实际包含的 metric key 列表，按MetricType 区分：tokens=[Total,Input,Output,Cache]、search=[SearchRequestCount,SearchCount]</p>
+     * <p>本次响应中 Stats / Series / PageStats / TotalStats 实际包含的 metric key 列表，按MetricType 区分：<br>tokens=[TotalToken, InputTotalToken, OutputTotalToken, CacheTotalToken]<br>search=[SearchRequestCount,SearchCount]<br>apikey_usage=[TotalToken, InputTotalToken, OutputTotalToken, CacheTotalToken, RequestCount, RequestFailCount]</p>
      */
     MetricKeys?: Array<string>;
     /**
@@ -1267,7 +1283,7 @@ export interface DescribeUsageRankListResponse {
      */
     Timestamps?: Array<number | bigint>;
     /**
-     * <p>对象排行列表，按<code>MetricKeys[0]</code>降序排序。ShowAll=false 时为当前页 10 个对象（含 Series）；ShowAll=true 时为全量对象（不含 Series，用于 CSV 导出）。</p>
+     * <p>对象排行列表，按 SortKey 降序排序。ShowAll=false 时为当前页 10 个对象（含 Series）；ShowAll=true 时为全量对象（不含 Series，用于 CSV 导出）。</p>
      */
     TopList?: Array<UsageRankItem>;
     /**
@@ -1278,6 +1294,10 @@ export interface DescribeUsageRankListResponse {
      * <p>总统计结果</p>
      */
     TotalStats?: UsageStats;
+    /**
+     * <p>排序指标键</p>
+     */
+    SortKey?: string;
     /**
      * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
      */
@@ -1802,9 +1822,13 @@ export interface DescribeUsageRankListRequest {
      */
     EndTime: string;
     /**
-     * <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>
+     * <p>指标族切换字段。</p><ul><li>tokens（默认）：Token 用量消耗（statistics=sum），支持 Dimension = apikey/endpoint/model</li><li>search：联网搜索调用次数（statistics=sum），仅支持 Dimension = model</li><li>apikey_usage: APIKey 锚定用量统计（某 APIKey 下按模型或接入点展开）（statistics=sum），支持 Dimension = endpoint/model</li><li>其他值返回 InvalidParameter。</li></ul>
      */
     MetricType?: string;
+    /**
+     * <p>锚定对象，用于缩小统计范围「在哪个具体对象之内」，MetricType 为 apikey_usage 时必填。<br>各 MetricType 是否支持/如何使用 Anchor，见 MetricType 字段说明。</p>
+     */
+    Anchor?: string;
     /**
      * <p>维度过滤值。空字符串表示查询全部对象，非空时仅查询指定单个对象（如指定 APIKey ID）。最大 256 字符。</p>
      */
@@ -1821,6 +1845,10 @@ export interface DescribeUsageRankListRequest {
      * <p>是否返回全量结果。</p><ul><li>false（默认）：按 Offset 分页返回 TopList（每页 10 条），每个对象包含<br>Series 时序点用于绘制曲线。</li><li>true：忽略 Offset，返回全量对象列表，不返回 Series（CSV 导出场景）。</li></ul>
      */
     ShowAll?: boolean;
+    /**
+     * <p>排序指标键（可选），具体值见响应 MetricKeys。为空时按 <code>MetricKeys[0]</code> 降序排序（tokens/apikey_usage 族为 TotalToken，search 族为 SearchRequestCount）。非法值返回 InvalidParameter。</p>
+     */
+    SortKey?: string;
 }
 /**
  * CreateGlossaryEntries请求参数结构体