tencentcloud-sdk-nodejs 4.1.310 → 4.1.312

package/tencentcloud/services/teo/v20220901/teo_client.d.ts

@@ -49,7 +49,8 @@ export declare class Client extends AbstractClient {
      */
     DescribeMultiPathGatewayRegions(req: DescribeMultiPathGatewayRegionsRequest, cb?: (error: string, rep: DescribeMultiPathGatewayRegionsResponse) => void): Promise<DescribeMultiPathGatewayRegionsResponse>;
     /**
-     * 本接口（DownloadL4Logs）用于下载四层离线日志。
+     * 本接口（DownloadL4Logs）用于获取四层代理业务的离线日志下载链接。
+**注意：**仅当离线日志功能开启期间，EO 才会存储相关离线日志并提供下载服务。具体功能介绍请见[文档](https://cloud.tencent.com/document/product/1552/73660)。
      */
     DownloadL4Logs(req: DownloadL4LogsRequest, cb?: (error: string, rep: DownloadL4LogsResponse) => void): Promise<DownloadL4LogsResponse>;
     /**
@@ -151,7 +152,8 @@ export declare class Client extends AbstractClient {
      */
     ModifyL4ProxyStatus(req: ModifyL4ProxyStatusRequest, cb?: (error: string, rep: ModifyL4ProxyStatusResponse) => void): Promise<ModifyL4ProxyStatusResponse>;
     /**
-     * 本接口（DownloadL7Logs）下载七层离线日志。
+     * 本接口（DownloadL7Logs）用于获取七层域名业务的离线日志下载链接。
+**注意：**仅当离线日志功能开启期间，EO 才会存储相关离线日志并提供下载服务。具体功能介绍请见[文档](https://cloud.tencent.com/document/product/1552/73660)。
      */
     DownloadL7Logs(req: DownloadL7LogsRequest, cb?: (error: string, rep: DownloadL7LogsResponse) => void): Promise<DownloadL7LogsResponse>;
     /**

package/tencentcloud/services/teo/v20220901/teo_client.js

@@ -85,7 +85,8 @@ class Client extends abstract_client_1.AbstractClient {
         return this.request("DescribeMultiPathGatewayRegions", req, cb);
     }
     /**
-     * 本接口（DownloadL4Logs）用于下载四层离线日志。
+     * 本接口（DownloadL4Logs）用于获取四层代理业务的离线日志下载链接。
+**注意：**仅当离线日志功能开启期间，EO 才会存储相关离线日志并提供下载服务。具体功能介绍请见[文档](https://cloud.tencent.com/document/product/1552/73660)。
      */
     async DownloadL4Logs(req, cb) {
         return this.request("DownloadL4Logs", req, cb);
@@ -237,7 +238,8 @@ class Client extends abstract_client_1.AbstractClient {
         return this.request("ModifyL4ProxyStatus", req, cb);
     }
     /**
-     * 本接口（DownloadL7Logs）下载七层离线日志。
+     * 本接口（DownloadL7Logs）用于获取七层域名业务的离线日志下载链接。
+**注意：**仅当离线日志功能开启期间，EO 才会存储相关离线日志并提供下载服务。具体功能介绍请见[文档](https://cloud.tencent.com/document/product/1552/73660)。
      */
     async DownloadL7Logs(req, cb) {
         return this.request("DownloadL7Logs", req, cb);

package/tencentcloud/services/teo/v20220901/teo_models.d.ts

@@ -524,29 +524,42 @@ export interface OriginDetail {
  */
 export interface InferenceHardwareSpecification {
     /**
-     * 规格标识。
+     * <p>规格标识。已废弃，参考使用字段 <code>HardwareSpecId</code>。</p>
+     * @deprecated
      */
     Spec?: string;
     /**
-     * 规格名称。
+     * <p>规格唯一标识 ID。</p>
+     */
+    HardwareSpecId?: string;
+    /**
+     * <p>规格名称。</p>
      */
     Name?: string;
     /**
-     * CPU 核数。
+     * <p>规格默认分配的 GPU 卡数。</p>
+     */
+    GPUNum?: number;
+    /**
+     * <p>规格默认分配的 CPU 核数。</p>
      */
     CPUNum?: number;
     /**
-     * 内存大小。单位为 MB。
+     * <p>规格默认分配的内存大小。</p><p>单位：MB</p>
      */
     MemSize?: number;
     /**
-     * GPU 卡数。
+     * <p>规格默认分配的显存大小。</p><p>单位：MB</p>
      */
-    GPUNum?: number;
+    GPUMemSize?: number;
     /**
-     * 显存大小。单位为 MB。
+     * <p>规格默认分配的磁盘大小。</p><p>单位：MB</p>
      */
-    GPUMemSize?: number;
+    DiskSize?: number;
+    /**
+     * <p>规格当前支持的 GPU 卡数列表。</p><p>若不填充或填充空数组，则仅支持规格默认分配的 GPU 卡数。</p>
+     */
+    AllowedGPUNums?: Array<number>;
 }
 /**
  * DescribeSecurityClientAttester返回参数结构体
@@ -3204,7 +3217,7 @@ export interface DownloadL4LogsRequest {
     /**
      * 站点 ID 集合，此参数将于2024年05月30日后由可选改为必填，详见公告：[【腾讯云 EdgeOne】云 API 变更通知](https://cloud.tencent.com/document/product/1552/104902)。
      */
-    ZoneIds?: Array<string>;
+    ZoneIds: Array<string>;
     /**
      * 四层实例 ID 集合。
      */
@@ -5125,25 +5138,34 @@ export interface DescribePrefetchTasksResponse {
  */
 export interface InferenceResourceConfig {
     /**
-     * 扩容缩容的方式。取值有：<li>Auto：根据请求量自动调整实例数量；</li><li>Manual：人工设置固定的实例数量。</li>
+     * <p>扩容缩容的方式。取值有：<li>Auto：根据请求量自动调整实例数量；</li><li>Manual：人工设置固定的实例数量。</li></p>
      */
     ScalingMode: string;
     /**
-     * 硬件规格。
+     * <p>硬件规格标识。已废弃，请参考使用 <code>HardwareSpecId</code>。</p>
+     * @deprecated
+     */
+    HardwareSpec?: string;
+    /**
+     * <p>硬件规格唯一标识 ID，可通过 <code>DescribeInferenceHardwareSpecifications</code> 接口获取当前站点支持的硬件规格。</p><p>系统默认按照所选 <code>HardwareSpecId</code> 对应的硬件规格配置推理服务所需资源；如需调整，可通过 <code>HardwareConfig</code> 自定义硬件资源配置。</p>
+     */
+    HardwareSpecId?: string;
+    /**
+     * <p>推理服务硬件配置。</p><p>作为入参时，若未填充则按照所选 <code>HardwareSpecId</code> 规格的默认值配置硬件资源；若填充则优先按照填写值进行配置。</p>
      */
-    HardwareSpec: string;
+    HardwareConfig?: InferenceHardwareConfig;
     /**
-     * 推理服务自动伸缩配置。当 ScalingMode 为 Auto 时必填。
+     * <p>推理服务自动伸缩配置。当 ScalingMode 为 Auto 时必填。</p>
   注意：此字段可能返回 null，表示取不到有效值。
      */
     AutoScalingConfig?: InferenceAutoScalingConfig;
     /**
-     * 推理服务人工设置实例配置。当 ScalingMode 为 Manual 时必填。
+     * <p>推理服务人工设置实例配置。当 ScalingMode 为 Manual 时必填。</p>
   注意：此字段可能返回 null，表示取不到有效值。
      */
     ManualInstanceConfig?: InferenceManualInstanceConfig;
     /**
-     * 单实例的并发数。默认值为 1。
+     * <p>单实例的并发数。默认值为 1。</p>
      */
     Concurrency?: number;
 }
@@ -7355,7 +7377,7 @@ export interface DownloadL7LogsRequest {
     /**
      * 站点ID集合，此参数将于2024年05月30日后由可选改为必填，详见公告：[【腾讯云 EdgeOne】云 API 变更通知](https://cloud.tencent.com/document/product/1552/104902)。
      */
-    ZoneIds?: Array<string>;
+    ZoneIds: Array<string>;
     /**
      * 子域名集合，不填默认选择全部子域名。
      */
@@ -8915,6 +8937,28 @@ export interface AclConfig {
      */
     Customizes?: Array<AclUserRule>;
 }
+/**
+ * Bot智能分析规则详情
+ */
+export interface IntelligenceRuleItem {
+    /**
+     * 智能分析标签，取值有：
+  <li>evil_bot：恶意bot；</li>
+  <li>suspect_bot：疑似bot；</li>
+  <li>good_bot：良好bot；</li>
+  <li>normal：正常请求。</li>
+     */
+    Label: string;
+    /**
+     * 触发智能分析标签对应的处置方式，取值有：
+  <li>drop：拦截；</li>
+  <li>trans：放行；</li>
+  <li>alg：Javascript挑战；</li>
+  <li>captcha：数字验证码；</li>
+  <li>monitor：观察。</li>
+     */
+    Action: string;
+}
 /**
  * 视频即时处理配置
  */
@@ -10208,6 +10252,23 @@ export interface ModifyL7AccSettingResponse {
      */
     RequestId?: string;
 }
+/**
+ * 边缘推理定时伸缩有效期范围配置。
+ */
+export interface InferenceScheduledScalingEffectiveRange {
+    /**
+     * <p>有效期类型。取值有：<li>LongTerm：长期有效；</li><li>Custom：自定义起止日期。</li></p>
+     */
+    EffectiveType: string;
+    /**
+     * <p>有效期起始日期。当 EffectiveType 为 Custom 时必填；当 EffectiveType 为 LongTerm 时不传该字段。</p>
+     */
+    StartDate?: string;
+    /**
+     * <p>有效期终止日期。当 EffectiveType 为 Custom 时必填，且不得早于 StartDate；当 EffectiveType 为 LongTerm 时不传该字段。</p>
+     */
+    EndDate?: string;
+}
 /**
  * DeleteSecurityJSInjectionRule返回参数结构体
  */
@@ -11860,21 +11921,25 @@ export interface LogItem {
  */
 export interface InferenceResourceConfigForModify {
     /**
-     * 扩容缩容的方式。取值有：<li>Auto：根据请求量自动调整实例数量；</li><li>Manual：人工设置固定的实例数量。</li>
+     * <p>扩容缩容的方式。取值有：<li>Auto：根据请求量自动调整实例数量；</li><li>Manual：人工设置固定的实例数量。</li></p>
      */
     ScalingMode?: string;
     /**
-     * 推理服务自动伸缩配置。当 ScalingMode 为 Auto 时必填。
+     * <p>推理服务自动伸缩配置。当 ScalingMode 为 Auto 时必填。</p>
      */
     AutoScalingConfig?: InferenceAutoScalingConfig;
     /**
-     * 推理服务人工设置实例配置。当 ScalingMode 为 Manual 时必填。
+     * <p>推理服务人工设置实例配置。当 ScalingMode 为 Manual 时必填。</p>
      */
     ManualInstanceConfig?: InferenceManualInstanceConfig;
     /**
-     * 单实例的并发数。默认值为 1。
+     * <p>单实例的并发数。默认值为 1。</p>
      */
     Concurrency?: number;
+    /**
+     * <p>推理服务的硬件资源配置。</p>
+     */
+    HardwareConfig?: InferenceHardwareConfigForModify;
 }
 /**
  * Hsts配置
@@ -14307,21 +14372,25 @@ export interface DescribeTopL7CacheDataRequest {
     Area?: string;
 }
 /**
- * 边缘推理定时伸缩有效期范围配置。
+ * 推理服务硬件配置。
  */
-export interface InferenceScheduledScalingEffectiveRange {
+export interface InferenceHardwareConfig {
     /**
-     * <p>有效期类型。取值有：<li>LongTerm：长期有效；</li><li>Custom：自定义起止日期。</li></p>
+     * <p>推理服务单个实例分配的 GPU 卡数，当前仅支持整数值，且必须为 <code>HardwareSpecId</code> 对应规格的 <code>AllowedGPUNums</code> 中的可选值。</p><p>若不填充，则使用所选 <code>HardwareSpecId</code> 规格对应的默认 <code>GPUNum</code> 值。</p>
      */
-    EffectiveType: string;
+    GPUNum?: number;
     /**
-     * <p>有效期起始日期。当 EffectiveType 为 Custom 时必填；当 EffectiveType 为 LongTerm 时不传该字段。</p>
+     * <p>推理服务单个实例分配的 CPU 核数，当前仅支持整数值。</p><p>若不填充，则使用所选 <code>HardwareSpecId</code> 规格对应的默认 <code>CPUNum</code> 值。</p>
      */
-    StartDate?: string;
+    CPUNum?: number;
     /**
-     * <p>有效期终止日期。当 EffectiveType 为 Custom 时必填，且不得早于 StartDate；当 EffectiveType 为 LongTerm 时不传该字段。</p>
+     * <p>推理服务单实例分配的内存大小。</p><p>单位：MB</p><p>若不填充，则使用所选 <code>HardwareSpecId</code> 对应规格的默认 <code>MemSize</code> 值；若填充，则必须为 <code>1024</code> 的整数倍。</p>
      */
-    EndDate?: string;
+    MemSize?: number;
+    /**
+     * <p>推理服务单实例分配的临时磁盘大小。</p><p>单位：MB</p><p>若不填充，则使用所选 <code>HardwareSpecId</code> 对应规格的默认 <code>DiskSize</code> 值；若填充，则必须为 <code>1024</code> 的整数倍。</p>
+     */
+    DiskSize?: number;
 }
 /**
  * 会话速率和周期特征校验配置。
@@ -17036,26 +17105,21 @@ export interface RuleEngineSubRule {
     Description?: Array<string>;
 }
 /**
- * Bot智能分析规则详情
+ * 推理服务资源硬件配置的修改参数。
  */
-export interface IntelligenceRuleItem {
+export interface InferenceHardwareConfigForModify {
     /**
-     * 智能分析标签，取值有：
-  <li>evil_bot：恶意bot；</li>
-  <li>suspect_bot：疑似bot；</li>
-  <li>good_bot：良好bot；</li>
-  <li>normal：正常请求。</li>
+     * <p>推理服务单实例分配的 CPU 核数，当前仅支持整数值。</p><p>若不填充，则不修改。</p>
      */
-    Label: string;
+    CPUNum?: number;
     /**
-     * 触发智能分析标签对应的处置方式，取值有：
-  <li>drop：拦截；</li>
-  <li>trans：放行；</li>
-  <li>alg：Javascript挑战；</li>
-  <li>captcha：数字验证码；</li>
-  <li>monitor：观察。</li>
+     * <p>推理服务单实例分配的内存大小。</p><p>单位：MB</p><p>若不填充，则不修改；若填写，则必须为 <code>1024</code> 的整数倍。</p>
      */
-    Action: string;
+    MemSize?: number;
+    /**
+     * <p>推理服务单实例分配的临时磁盘大小。</p><p>单位：MB</p><p>若不填充，则不修改；若填充，则必须为 <code>1024</code> 的整数倍。</p>
+     */
+    DiskSize?: number;
 }
 /**
  * ExportZoneConfig返回参数结构体

package/tencentcloud/services/tke/v20220501/tke_models.d.ts

@@ -102,6 +102,10 @@ export interface CreateNativeNodePoolParam {
      * <p>原生节点池密码</p>
      */
     Password?: string;
+    /**
+     * <p>自定义镜像 ID</p>
+     */
+    CustomImage?: string;
 }
 /**
  * DescribeClusterInstances返回参数结构体
@@ -1198,6 +1202,11 @@ export interface NativeNodePoolInfo {
      * <p>原生节点机型 Native, NativeCVM</p>
      */
     MachineType?: string;
+    /**
+     * <p>自定义镜像 ID</p>
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    CustomImage?: string;
 }
 /**
  * 节点系统盘和数据盘配置
@@ -2344,6 +2353,10 @@ export interface UpdateNativeNodePoolParam {
      * <p>原生节点池密码</p>
      */
     Password?: string;
+    /**
+     * <p>自定义镜像 ID</p>
+     */
+    CustomImage?: string;
 }
 /**
  * 健康检测规则

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

@@ -96,8 +96,10 @@ export declare class Client extends 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

@@ -144,8 +144,10 @@ class Client extends abstract_client_1.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请求参数结构体