tencentcloud-sdk-nodejs-tcb 4.1.301 → 4.1.303

package/package.json

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

package/tencentcloud/services/tcb/v20180608/tcb_client.d.ts

@@ -216,7 +216,7 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
        */
     DeleteAuthDomain(req: DeleteAuthDomainRequest, cb?: (error: string, rep: DeleteAuthDomainResponse) => void): Promise<DeleteAuthDomainResponse>;
     /**
-     * 本接口DescribeHTTPServiceRoute用于查询环境下HTTP访问服务路由信息。可通过Filters过滤。如果不存在不会返回错误。HTTP访问服务提供了默认域名，通过本接口可直接获取默认域名。
+     * 本接口DescribeHTTPServiceRoute用于查询环境下HTTP访问服务路由信息。可通过Filters过滤。如果不存在不会返回错误。HTTP访问服务提供了默认域名，通过本接口可直接获取默认域名。前置需已开通 HTTP 访问服务；调用CreateHTTPServiceRoute或者ModifyHTTPServiceRoute后可使用本接口查询创建或者修改结果
      */
     DescribeHTTPServiceRoute(req: DescribeHTTPServiceRouteRequest, cb?: (error: string, rep: DescribeHTTPServiceRouteResponse) => void): Promise<DescribeHTTPServiceRouteResponse>;
     /**

package/tencentcloud/services/tcb/v20180608/tcb_client.js

@@ -308,7 +308,7 @@ class Client extends TencentCloudCommon.AbstractClient {
         return this.request("DeleteAuthDomain", req, cb);
     }
     /**
-     * 本接口DescribeHTTPServiceRoute用于查询环境下HTTP访问服务路由信息。可通过Filters过滤。如果不存在不会返回错误。HTTP访问服务提供了默认域名，通过本接口可直接获取默认域名。
+     * 本接口DescribeHTTPServiceRoute用于查询环境下HTTP访问服务路由信息。可通过Filters过滤。如果不存在不会返回错误。HTTP访问服务提供了默认域名，通过本接口可直接获取默认域名。前置需已开通 HTTP 访问服务；调用CreateHTTPServiceRoute或者ModifyHTTPServiceRoute后可使用本接口查询创建或者修改结果
      */
     async DescribeHTTPServiceRoute(req, cb) {
         return this.request("DescribeHTTPServiceRoute", req, cb);

package/tencentcloud/services/tcb/v20180608/tcb_models.d.ts

@@ -421,6 +421,23 @@ export interface DeleteProviderResponse {
      */
     RequestId?: string;
 }
+/**
+ * HTTPService缓存规则匹配条件（必填）
+ */
+export interface HTTPServiceRuleCondition {
+    /**
+     * <p>Target 匹配对象</p><p>枚举值：</p><ul><li>url_path： 请求 URI 路径（不含查询串），例：/static/logo.jpg</li><li>file_extension： 请求文件扩展名（EO 从 path 中解析），例：jpg</li><li>full_uri： 完整 URI（路径 + 查询串），例：/download?type=hd</li></ul>
+     */
+    Target?: string;
+    /**
+     * <p>MatchType 字符串匹配类型</p><p>枚举值：</p><ul><li>prefix：  前缀匹配</li><li>suffix： 后缀匹配</li><li>contains： 包含匹配</li><li>exact： 精确匹配</li></ul>
+     */
+    MatchType?: string;
+    /**
+     * <p>Values 匹配值集合，Values 内任一命中即认为条件成立（OR 语义）</p><p>入参限制：单项 1~1024 字节，最多 100 条</p>
+     */
+    Values?: Array<string>;
+}
 /**
  * 本类型用于UpdateTable接口中描述待创建索引信息
  */
@@ -621,6 +638,31 @@ export interface CloudAppVersionItem {
      */
     Steps?: Array<BuildStepStatus>;
 }
+/**
+ * 自定义缓存键参数。约束：FullURLCache=on 与 QueryStringSwitch=on 互斥
+使用示例：
+- 整 URL 参与缓存键：{FullURLCache: "on", QueryStringSwitch: "off"}
+- URL 路径 + 仅保留 x/y：{FullURLCache: "off", QueryStringSwitch: "on", QueryStringAction: "includeCustom", QueryStringValues: ["x", "y"]}
+- URL 路径 + 忽略 debug：{FullURLCache: "off", QueryStringSwitch: "on", QueryStringAction: "excludeCustom", QueryStringValues: ["debug"]}
+ */
+export interface HTTPServiceCacheKeyParams {
+    /**
+     * <p>全 URL 缓存开关</p><p>枚举值：</p><ul><li>on： 开启</li><li>off： 关闭</li></ul>
+     */
+    FullURLCache?: string;
+    /**
+     * <p>查询参数是否参与缓存键</p><p>枚举值：</p><ul><li>on： 开启</li><li>off： 关闭</li></ul>
+     */
+    QueryStringSwitch?: string;
+    /**
+     * <p>QueryStringSwitch=on 时必填</p><p>枚举值：</p><ul><li>includeCustom： 白名单</li><li>excludeCustom： 黑名单</li></ul>
+     */
+    QueryStringAction?: string;
+    /**
+     * <p>参数名列表</p><p>入参限制：最多 100 项，单项 1~128 字节</p>
+     */
+    QueryStringValues?: Array<string>;
+}
 /**
  * CreateVmInstance请求参数结构体
  */
@@ -1407,6 +1449,68 @@ export interface CreateHostingDomainRequest {
      */
     CertId: string;
 }
+/**
+ * 创建或修改HTTP访问服务输入的域名信息，修改HTTP访问服务域名时对应字段不传参数表示不需要修改。
+ */
+export interface HTTPServiceDomainParam {
+    /**
+     * <p>域名。全局唯一。如果域名在其他环境下占用或者腾讯云CDN占用，可能会导致创建失败</p>
+     */
+    Domain: string;
+    /**
+     * <p>绑定类型</p><p>枚举值：</p><ul><li>DIRECT： 直连到HTTP访问服务</li><li>CDN： 接入云开发CDN（即将下线）</li><li>CUSTOM： 自定义接入类型（CDN、EO、WAF等接入）</li><li>EO： 接入云开发EdgeOne</li></ul><p>默认值：DIRECT</p>
+     */
+    AccessType?: string;
+    /**
+     * <p>证书ID。当前账户下SSL平台的证书ID，无证书无法使用https访问</p>
+     */
+    CertId?: string;
+    /**
+     * <p>协议类型</p><p>枚举值：</p><ul><li>HTTP： 仅开启http</li><li>HTTPS： 仅开启https</li><li>HTTP_AND_HTTPS： 同时开启http和https，默认</li><li>HTTP_TO_HTTPS： http重定向成https，需配置证书</li><li>HTTPS_TO_HTTP： https重定向成http，需配置证书</li></ul><p>默认值：HTTP_AND_HTTPS</p>
+     */
+    Protocol?: string;
+    /**
+     * <p>自定义CNAME。对应AccessType: Custom</p>
+     */
+    CustomCname?: string;
+    /**
+     * <p>域名开启状态，不传默认开启</p>
+     */
+    Enable?: boolean;
+    /**
+     * <p>创建/修改的HTTP访问服务路由列表。如果不传，仅创建或修改域名信息。列表最大支持传入20个</p>
+     */
+    Routes?: Array<HTTPServiceRouteParam>;
+    /**
+     * <p>扩展字段，内部包含headers处理等</p>
+     */
+    Extension?: HTTPServiceExtension;
+}
+/**
+ * HTTPService 缓存参数（节点缓存 + 浏览器缓存共用行为模式）。
+FollowOrigin / NoCache / (CacheTime||MaxAgeTime) 三者互斥，必须开启其一：
+- FollowOrigin=true：节点与浏览器缓存均遵循源站；
+- NoCache=true：节点与浏览器缓存均不缓存（Cache-Control: no-cache）；
+- CacheTime>0 或 MaxAgeTime>0：至少设置其一，分别控制节点、浏览器缓存秒数，可独立设置。
+ */
+export interface HTTPServiceCacheParams {
+    /**
+     * <p>遵循源站</p>
+     */
+    FollowOrigin?: boolean;
+    /**
+     * <p>不缓存</p>
+     */
+    NoCache?: boolean;
+    /**
+     * <p>自定义缓存时间（秒）</p><p>取值范围：[0, 31536000]</p><p>单位：秒</p>
+     */
+    CacheTime?: number;
+    /**
+     * <p>浏览器缓存秒数（对应 max-age）</p><p>取值范围：[0, 31536000]</p><p>单位：秒</p>
+     */
+    MaxAgeTime?: number;
+}
 /**
  * 自定义短信模板中的自定义参数
  */
@@ -2567,28 +2671,26 @@ export interface CreateStaticStoreRequest {
     ExternalStorage?: ExternalStorage;
 }
 /**
- * HTTP访问服务路由扩展字段
+ * HTTPService 路由扩展字段
  */
 export interface HTTPServiceExtension {
     /**
-     * 添加请求头列表
+     * <p>添加请求头列表</p>
      */
     HeadersHandler?: HTTPServiceHeadersHandler;
+    /**
+     * <p>HTTPService 缓存配置，包含Cache 节点缓存 / MaxAge 浏览器缓存 / CacheKey 自定义缓存键</p>
+     */
+    Cache?: HTTPServiceCacheSet;
 }
 /**
- * 多语言模板
+ * HTTPService 缓存配置（域名维度）
  */
-export interface LocalizedTemplate {
+export interface HTTPServiceCacheSet {
     /**
-     * <p>中文</p>
-  注意：此字段可能返回 null，表示取不到有效值。
+     * <p>HTTPService 缓存配置列表。Rules 按数组顺序为优先级顺序，Rules[n-1] 优先级最高</p>
      */
-    ZhCN?: string;
-    /**
-     * <p>英文</p>
-  注意：此字段可能返回 null，表示取不到有效值。
-     */
-    EnUS?: string;
+    Rules?: Array<HTTPServiceCacheRule>;
 }
 /**
  * DescribeBillingInfo返回参数结构体
@@ -5338,6 +5440,23 @@ export interface DescribeResourcePermissionRequest {
      */
     Resources?: Array<string>;
 }
+/**
+ * HTTPService缓存动作（Type + 具体子字段的标签联合，Type 与被设置的子字段必须一一对应）
+ */
+export interface HTTPServiceCacheAction {
+    /**
+     * <p>HTTPService 缓存动作类型</p><p>枚举值：</p><ul><li>Cache： 节点缓存 + 浏览器缓存统一动作（节点秒数 CacheTime、浏览器秒数 MaxAgeTime）</li><li>CacheKey： 仅开启EO边缘加速通道下发</li></ul>
+     */
+    Type?: string;
+    /**
+     * <p>节点缓存配置。Type=Cache 时必填</p>
+     */
+    Cache?: HTTPServiceCacheParams;
+    /**
+     * <p>自定义缓存键。Type=CacheKey 时必填</p>
+     */
+    CacheKey?: HTTPServiceCacheKeyParams;
+}
 /**
  * 资源权限
  */
@@ -6199,41 +6318,25 @@ export interface InquireVmPriceRequest {
  */
 export type CheckTcbServiceRequest = null;
 /**
- * 创建或修改HTTP访问服务输入的域名信息，修改HTTP访问服务域名时对应字段不传参数表示不需要修改。
+ * HTTPService 缓存规则条目
  */
-export interface HTTPServiceDomainParam {
-    /**
-     * <p>域名。全局唯一。如果域名在其他环境下占用或者腾讯云CDN占用，可能会导致创建失败</p>
-     */
-    Domain: string;
-    /**
-     * <p>绑定类型</p><p>枚举值：</p><ul><li>DIRECT： 直连到HTTP访问服务</li><li>CDN： 接入云开发CDN（即将下线）</li><li>CUSTOM： 自定义接入类型（CDN、EO、WAF等接入）</li><li>EO： 接入云开发EdgeOne</li></ul><p>默认值：DIRECT</p>
-     */
-    AccessType?: string;
+export interface HTTPServiceCacheRule {
     /**
-     * <p>证书ID。当前账户下SSL平台的证书ID，无证书无法使用https访问</p>
+     * <p>自定义描述，最多 128 字节</p>
      */
-    CertId?: string;
-    /**
-     * <p>协议类型</p><p>枚举值：</p><ul><li>HTTP： 仅开启http</li><li>HTTPS： 仅开启https</li><li>HTTP_AND_HTTPS： 同时开启http和https，默认</li><li>HTTP_TO_HTTPS： http重定向成https，需配置证书</li><li>HTTPS_TO_HTTP： https重定向成http，需配置证书</li></ul><p>默认值：HTTP_AND_HTTPS</p>
-     */
-    Protocol?: string;
-    /**
-     * <p>自定义CNAME。对应AccessType: Custom</p>
-     */
-    CustomCname?: string;
+    Description?: string;
     /**
-     * <p>域名开启状态，不传默认开启</p>
+     * <p>规则开关：nil/true 启用，false 禁用</p>
      */
     Enable?: boolean;
     /**
-     * <p>创建/修改的HTTP访问服务路由列表。如果不传，仅创建或修改域名信息。列表最大支持传入20个</p>
+     * <p>HTTPService 规则匹配条件（必填）</p>
      */
-    Routes?: Array<HTTPServiceRouteParam>;
+    Condition?: HTTPServiceRuleCondition;
     /**
-     * <p>扩展字段，内部包含headers处理等</p>
+     * <p>HTTPService 缓存动作列表，同一规则内相同 Type 至多一个</p>
      */
-    Extension?: HTTPServiceExtension;
+    Actions?: Array<HTTPServiceCacheAction>;
 }
 /**
  * FlexDB数据库权限信息
@@ -6318,6 +6421,21 @@ export interface StaticEnvironment {
      */
     Variables?: Array<Variable>;
 }
+/**
+ * 多语言模板
+ */
+export interface LocalizedTemplate {
+    /**
+     * <p>中文</p>
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    ZhCN?: string;
+    /**
+     * <p>英文</p>
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    EnUS?: string;
+}
 /**
  * 标签键值对
  */