tencentcloud-sdk-nodejs 4.0.689 → 4.0.690

package/src/services/vod/v20180717/vod_models.ts

@@ -7069,11 +7069,11 @@ export interface DescribeCDNUsageDataResponse {
   /**
    * 时间粒度，单位：分钟。
    */
-  DataInterval: number
+  DataInterval?: number
   /**
    * CDN 统计数据。
    */
-  Data: Array<StatDataItem>
+  Data?: Array<StatDataItem>
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -10462,7 +10462,7 @@ export interface DescribeStorageDetailsResponse {
   /**
    * 存储统计数据，每5分钟或每天一条数据。
    */
-  Data: Array<StatDataItem>
+  Data?: Array<StatDataItem>
   /**
    * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
@@ -19328,6 +19328,7 @@ export interface DescribeStorageDetailsRequest {
 <li>ArchiveBulkRetrieval：归档批量取回量。</li>
 <li>DeepArchiveStandardRetrieval：深度归档标准取回量。</li>
 <li>DeepArchiveBulkRetrieval：深度归档批量取回量。</li>
+<li>InfrequentRetrieval：低频存储取回量。</li>
 默认值为 TotalStorage。
    */
   StorageType?: string

package/src/services/vpc/v20170312/vpc_models.ts

@@ -10590,6 +10590,10 @@ export interface CreateNatGatewayRequest {
    * 公网IP是否强制与NAT网关来自同可用区，true表示需要与NAT网关同可用区；false表示可与NAT网关不是同一个可用区。此参数只有当参数Zone存在时才能生效。
    */
   PublicIpFromSameZone?: boolean
+  /**
+   * NAT网关大版本号，1是传统型，2是标准型，默认是1
+   */
+  NatProductVersion?: number
 }
 
 /**

package/src/services/waf/v20180125/waf_client.ts

@@ -37,6 +37,7 @@ import {
   DomainPackageNew,
   DescribeCustomWhiteRuleResponse,
   AccessLogItems,
+  ModifyInstanceNameRequest,
   DescribePeakValueResponse,
   HostDel,
   DescribeCiphersDetailRequest,
@@ -54,14 +55,17 @@ import {
   AccessRuleTagInfo,
   DescribePeakPointsRequest,
   DescribeAccessIndexRequest,
+  ModifyInstanceQpsLimitRequest,
   DeleteHostRequest,
   DomainInfo,
   DescribeAntiInfoLeakRulesStrategyItem,
+  ModifyInstanceNameResponse,
   UpsertSessionResponse,
   AccessLogItem,
   DescribeDomainVerifyResultResponse,
   DeleteSessionRequest,
   DescribeWafAutoDenyRulesRequest,
+  UpsertIpAccessControlRequest,
   GenerateDealsAndPayNewRequest,
   RefreshAccessCheckResultRequest,
   DescribeUserClbWafRegionsRequest,
@@ -94,6 +98,7 @@ import {
   ModifyAntiFakeUrlStatusRequest,
   DeleteCustomWhiteRuleRequest,
   ModifyHostModeResponse,
+  ModifyInstanceRenewFlagResponse,
   DescribeCCRuleListRequest,
   ModifyProtectionStatusResponse,
   DescribeAutoDenyIPRequest,
@@ -214,7 +219,7 @@ import {
   BatchIpAccessControlItem,
   InstanceInfo,
   TLSCiphers,
-  ModifyWafAutoDenyRulesRequest,
+  ModifyInstanceRenewFlagRequest,
   DescribeBatchIpAccessControlResponse,
   DescribeDomainDetailsSaasResponse,
   AccessKeyValueInfo,
@@ -236,17 +241,19 @@ import {
   DescribeFindDomainListRequest,
   ModifyAntiFakeUrlStatusResponse,
   DescribeHostsRequest,
-  UpsertIpAccessControlRequest,
+  ModifyInstanceElasticModeRequest,
   AutoDenyDetail,
   UpsertCCRuleRequest,
   ResponseCode,
   ModifyCustomWhiteRuleStatusRequest,
   DeleteAntiFakeUrlRequest,
   CacheUrlItems,
+  ModifyInstanceQpsLimitResponse,
   SearchAttackLogResponse,
   Strategy,
   AccessFullTextInfo,
   DeleteAntiInfoLeakRuleRequest,
+  ModifyInstanceElasticModeResponse,
   DescribeIpHitItemsRequest,
   DescribeVipInfoResponse,
   GoodNews,
@@ -283,6 +290,7 @@ import {
   DescribeAccessIndexResponse,
   DescribeAccessExportsResponse,
   DeleteCustomRuleResponse,
+  ModifyWafAutoDenyRulesRequest,
   BotStatPointItem,
   ClbDomainsInfo,
   DescribeHostResponse,
@@ -395,6 +403,16 @@ export class Client extends AbstractClient {
     return this.request("ModifyCustomRule", req, cb)
   }
 
+  /**
+   * 设置套餐实例的弹性qps上限
+   */
+  async ModifyInstanceQpsLimit(
+    req: ModifyInstanceQpsLimitRequest,
+    cb?: (error: string, rep: ModifyInstanceQpsLimitResponse) => void
+  ): Promise<ModifyInstanceQpsLimitResponse> {
+    return this.request("ModifyInstanceQpsLimit", req, cb)
+  }
+
   /**
      * 接口已废弃
 
@@ -467,6 +485,16 @@ export class Client extends AbstractClient {
     return this.request("ModifySpartaProtection", req, cb)
   }
 
+  /**
+   * 修改实例的QPS弹性计费开关
+   */
+  async ModifyInstanceElasticMode(
+    req: ModifyInstanceElasticModeRequest,
+    cb?: (error: string, rep: ModifyInstanceElasticModeResponse) => void
+  ): Promise<ModifyInstanceElasticModeResponse> {
+    return this.request("ModifyInstanceElasticMode", req, cb)
+  }
+
   /**
    * api分析页面开关
    */
@@ -719,6 +747,16 @@ export class Client extends AbstractClient {
     return this.request("ModifyCustomWhiteRule", req, cb)
   }
 
+  /**
+   * 修改实例的自动续费开关
+   */
+  async ModifyInstanceRenewFlag(
+    req: ModifyInstanceRenewFlagRequest,
+    cb?: (error: string, rep: ModifyInstanceRenewFlagResponse) => void
+  ): Promise<ModifyInstanceRenewFlagResponse> {
+    return this.request("ModifyInstanceRenewFlag", req, cb)
+  }
+
   /**
    * 查询单个saas域名详情
    */
@@ -1023,7 +1061,7 @@ export class Client extends AbstractClient {
   }
 
   /**
-   * waf斯巴达-删除防护域名
+   * SAASWAF删除防护域名
    */
   async DeleteSpartaProtection(
     req: DeleteSpartaProtectionRequest,
@@ -1232,6 +1270,16 @@ export class Client extends AbstractClient {
     return this.request("ModifyHostFlowMode", req, cb)
   }
 
+  /**
+   * 修改实例的名称
+   */
+  async ModifyInstanceName(
+    req: ModifyInstanceNameRequest,
+    cb?: (error: string, rep: ModifyInstanceNameResponse) => void
+  ): Promise<ModifyInstanceNameResponse> {
+    return this.request("ModifyInstanceName", req, cb)
+  }
+
   /**
    * 在CDC场景下，负载均衡型WAF的添加、编辑域名配置的时候，需要展示CDC负载均衡型WAF（cdc-clb-waf)支持的地域列表，通过DescribeUserCdcClbWafRegions既可以获得当前对客户已经开放的地域列表
    */

package/src/services/waf/v20180125/waf_models.ts

@@ -417,6 +417,20 @@ export interface AccessLogItems {
   Data: Array<AccessLogItem>
 }
 
+/**
+ * ModifyInstanceName请求参数结构体
+ */
+export interface ModifyInstanceNameRequest {
+  /**
+   * 实例id
+   */
+  InstanceID: string
+  /**
+   * 版本
+   */
+  Edition: string
+}
+
 /**
  * DescribePeakValue返回参数结构体
  */
@@ -799,6 +813,20 @@ UpstreamRedirect-源站返回给WAF状态码次数趋势图
  */
 export type DescribeAccessIndexRequest = null
 
+/**
+ * ModifyInstanceQpsLimit请求参数结构体
+ */
+export interface ModifyInstanceQpsLimitRequest {
+  /**
+   * 套餐实例id
+   */
+  InstanceId: string
+  /**
+   * qps上限
+   */
+  QpsLimit: number
+}
+
 /**
  * DeleteHost请求参数结构体
  */
@@ -954,6 +982,20 @@ export interface DescribeAntiInfoLeakRulesStrategyItem {
   Content: string
 }
 
+/**
+ * ModifyInstanceName返回参数结构体
+ */
+export interface ModifyInstanceNameResponse {
+  /**
+   * 修改状态：0为成功
+   */
+  ModifyCode?: number
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * UpsertSession返回参数结构体
  */
@@ -1027,6 +1069,28 @@ export interface DescribeWafAutoDenyRulesRequest {
   Domain: string
 }
 
+/**
+ * UpsertIpAccessControl请求参数结构体
+ */
+export interface UpsertIpAccessControlRequest {
+  /**
+   * 域名
+   */
+  Domain: string
+  /**
+   * ip 参数列表，json数组由ip，source，note，action，valid_ts组成。ip对应配置的ip地址，source固定为custom值，note为注释，action值42为黑名单，40为白名单，valid_ts为有效日期，值为秒级时间戳（（如1680570420代表2023-04-04 09:07:00））
+   */
+  Items: Array<string>
+  /**
+   * WAF实例类型，sparta-waf表示SAAS型WAF，clb-waf表示负载均衡型WAF
+   */
+  Edition?: string
+  /**
+   * 是否为多域名黑白名单，当为多域名的黑白名单时，取值为batch，否则为空
+   */
+  SourceType?: string
+}
+
 /**
  * GenerateDealsAndPayNew请求参数结构体
  */
@@ -1525,6 +1589,16 @@ export interface ModifyHostModeResponse {
   RequestId?: string
 }
 
+/**
+ * ModifyInstanceRenewFlag返回参数结构体
+ */
+export interface ModifyInstanceRenewFlagResponse {
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * DescribeCCRuleList请求参数结构体
  */
@@ -3971,18 +4045,24 @@ export interface GoodsDetailNew {
    */
   TimeSpan?: number
   /**
-   * 单位，支持m、y、d
+   * 单位，支持购买d、m、y 即（日、月、年）
 注意：此字段可能返回 null，表示取不到有效值。
    */
   TimeUnit?: string
   /**
    * 子产品标签,。新购，续费必传，变配时放在oldConfig newConfig里面
-高级版 ：sp_wsm_waf_premium
-企业版 ：sp_wsm_waf_enterprise
-旗舰版 ：sp_wsm_waf_ultimate
+
+Saas 高级版 ：sp_wsm_waf_premium
+Saas企业版 ：sp_wsm_waf_enterprise
+Saas旗舰版 ：sp_wsm_waf_ultimate
+Saas 业务扩展包：sp_wsm_waf_qpsep
+Saas 域名扩展包：sp_wsm_waf_domain
+
 高级版-CLB:sp_wsm_waf_premium_clb
 企业版-CLB : sp_wsm_waf_enterprise_clb
 旗舰版-CLB:sp_wsm_waf_ultimate_clb
+ 业务扩展包-CLB：sp_wsm_waf_qpsep_clb
+域名扩展包-CLB：sp_wsm_waf_domain_clb
 
 注意：此字段可能返回 null，表示取不到有效值。
    */
@@ -3992,9 +4072,13 @@ export interface GoodsDetailNew {
 高级版 ：1000827
 企业版 ：1000830
 旗舰版 ：1000832
+域名包 : 1000834
+业务扩展包 : 1000481
 高级版-CLB:1001150
 企业版-CLB : 1001152
 旗舰版-CLB:1001154
+域名包-CLB: 1001156
+业务扩展包-CLB : 1001160
 
 注意：此字段可能返回 null，表示取不到有效值。
    */
@@ -4016,6 +4100,24 @@ export interface GoodsDetailNew {
   RealRegion?: number
   /**
    * 计费细项标签数组
+Saas 高级版  sv_wsm_waf_package_premium 
+Saas 企业版  sv_wsm_waf_package_enterprise
+Saas 旗舰版  sv_wsm_waf_package_ultimate 
+Saas 非中国大陆高级版  sv_wsm_waf_package_premium_intl
+Saas 非中国大陆企业版   sv_wsm_waf_package_enterprise_intl
+Saas 非中国大陆旗舰版  sv_wsm_waf_package_ultimate _intl
+Saas 业务扩展包  sv_wsm_waf_qps_ep
+Saas 域名扩展包  sv_wsm_waf_domain
+
+高级版CLB   sv_wsm_waf_package_premium_clb
+企业版CLB  sv_wsm_waf_package_enterprise_clb
+旗舰版CLB   sv_wsm_waf_package_ultimate_clb
+非中国大陆高级版 CLB sv_wsm_waf_package_premium_clb_intl
+非中国大陆企业版CLB   sv_wsm_waf_package_premium_clb_intl
+非中国大陆旗舰版CLB  sv_wsm_waf_package_ultimate_clb _intl
+业务扩展包CLB sv_wsm_waf_qps_ep_clb
+域名扩展包CLB  sv_wsm_waf_domain_clb
+
 注意：此字段可能返回 null，表示取不到有效值。
    */
   LabelTypes?: Array<string>
@@ -4480,29 +4582,17 @@ export interface TLSCiphers {
 }
 
 /**
- * ModifyWafAutoDenyRules请求参数结构体
+ * ModifyInstanceRenewFlag请求参数结构体
  */
-export interface ModifyWafAutoDenyRulesRequest {
-  /**
-   * 域名
-   */
-  Domain: string
-  /**
-   * 触发IP封禁的攻击次数阈值，范围为2~100次
-   */
-  AttackThreshold: number
+export interface ModifyInstanceRenewFlagRequest {
   /**
-   * IP封禁统计时间，范围为1-60分钟
+   * 实例ID
    */
-  TimeThreshold: number
+  InstanceId: string
   /**
-   * 触发IP封禁后的封禁时间，范围为5~360分钟
+   * 续费开关
    */
-  DenyTimeThreshold: number
-  /**
-   * 自动封禁状态，0表示关闭，1表示打开
-   */
-  DefenseStatus: number
+  RenewFlag: number
 }
 
 /**
@@ -4991,25 +5081,17 @@ export interface DescribeHostsRequest {
 }
 
 /**
- * UpsertIpAccessControl请求参数结构体
+ * ModifyInstanceElasticMode请求参数结构体
  */
-export interface UpsertIpAccessControlRequest {
-  /**
-   * 域名
-   */
-  Domain: string
+export interface ModifyInstanceElasticModeRequest {
   /**
-   * ip 参数列表，json数组由ip，source，note，action，valid_ts组成。ip对应配置的ip地址，source固定为custom值，note为注释，action值42为黑名单，40为白名单，valid_ts为有效日期，值为秒级时间戳（（如1680570420代表2023-04-04 09:07:00））
-   */
-  Items: Array<string>
-  /**
-   * WAF实例类型，sparta-waf表示SAAS型WAF，clb-waf表示负载均衡型WAF
+   * 实例ID
    */
-  Edition?: string
+  InstanceId: string
   /**
-   * 是否为多域名黑白名单，当为多域名的黑白名单时，取值为batch，否则为空
+   * 弹性计费开关
    */
-  SourceType?: string
+  Mode: number
 }
 
 /**
@@ -5184,6 +5266,16 @@ export interface CacheUrlItems {
   Status: number
 }
 
+/**
+ * ModifyInstanceQpsLimit返回参数结构体
+ */
+export interface ModifyInstanceQpsLimitResponse {
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * SearchAttackLog返回参数结构体
  */
@@ -5307,6 +5399,16 @@ export interface DeleteAntiInfoLeakRuleRequest {
   RuleId: number
 }
 
+/**
+ * ModifyInstanceElasticMode返回参数结构体
+ */
+export interface ModifyInstanceElasticModeResponse {
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * DescribeIpHitItems请求参数结构体
  */
@@ -5392,17 +5494,22 @@ export interface GoodNews {
 高级版: 102375(新购),102376(续费),102377(变配)
 企业版 : 102378(新购),102379(续费),102380(变配)
 旗舰版 : 102369(新购),102370(续费),102371(变配)
+域名包 : 102372(新购),102373(续费),102374(变配)
+业务扩展包 : 101040(新购),101041(续费),101042(变配)
+
 高级版-CLB: 新购 101198  续费 101199 变配 101200
 企业版-CLB 101204(新购),101205(续费),101206(变配)
 旗舰版-CLB : 101201(新购),101202(续费),101203(变配)
+域名包-CLB: 101207(新购),101208(续费),101209(变配)
+业务扩展包-CLB: 101210(新购),101211(续费),101212(变配)
 
 注意：此字段可能返回 null，表示取不到有效值。
    */
   GoodsCategoryId?: number
   /**
    * 购买waf实例区域ID
-1 表示购买大陆资源
-2表示购买非中国大陆资源
+1 表示购买大陆资源;
+9表示购买非中国大陆资源
 注意：此字段可能返回 null，表示取不到有效值。
    */
   RegionId?: number
@@ -6217,6 +6324,32 @@ export interface DeleteCustomRuleResponse {
   RequestId?: string
 }
 
+/**
+ * ModifyWafAutoDenyRules请求参数结构体
+ */
+export interface ModifyWafAutoDenyRulesRequest {
+  /**
+   * 域名
+   */
+  Domain: string
+  /**
+   * 触发IP封禁的攻击次数阈值，范围为2~100次
+   */
+  AttackThreshold: number
+  /**
+   * IP封禁统计时间，范围为1-60分钟
+   */
+  TimeThreshold: number
+  /**
+   * 触发IP封禁后的封禁时间，范围为5~360分钟
+   */
+  DenyTimeThreshold: number
+  /**
+   * 自动封禁状态，0表示关闭，1表示打开
+   */
+  DefenseStatus: number
+}
+
 /**
  * bot的趋势图对象
  */

package/tencentcloud/common/sdk_version.d.ts

@@ -1 +1 @@
-export declare const sdkVersion = "4.0.689";
+export declare const sdkVersion = "4.0.690";

package/tencentcloud/common/sdk_version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sdkVersion = void 0;
-exports.sdkVersion = "4.0.689";
+exports.sdkVersion = "4.0.690";

package/tencentcloud/services/batch/v20170312/batch_models.d.ts

@@ -2015,10 +2015,6 @@ export interface Placement {
      * 实例所属的专用宿主机ID列表，仅用于入参。如果您有购买专用宿主机并且指定了该参数，则您购买的实例就会随机的部署在这些专用宿主机上。
      */
     HostIds?: Array<string>;
-    /**
-     * 指定母机IP生产子机
-     */
-    HostIps?: Array<string>;
     /**
      * 实例所属的专用宿主机ID，仅用于出参。
      */

package/tencentcloud/services/bi/v20220105/bi_models.d.ts

@@ -105,6 +105,14 @@ export interface CreateEmbedTokenRequest {
      * 备用字段
      */
     ExtraParam?: string;
+    /**
+     * 使用者企业Id(仅用于多用户)
+     */
+    UserCorpId?: string;
+    /**
+     * 使用者Id(仅用于多用户)
+     */
+    UserId?: string;
 }
 /**
  * 报表嵌出数据结构-强鉴权
@@ -165,4 +173,14 @@ export interface EmbedTokenInfo {
   注意：此字段可能返回 null，表示取不到有效值。
      */
     ExpireTime?: number;
+    /**
+     * 使用者企业Id(仅用于多用户)
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    UserCorpId?: string;
+    /**
+     * 使用者Id(仅用于多用户)
+  注意：此字段可能返回 null，表示取不到有效值。
+     */
+    UserId?: string;
 }

package/tencentcloud/services/cynosdb/v20190107/cynosdb_models.d.ts

@@ -54,7 +54,8 @@ export interface ModifyProxyRwSplitRequest {
      */
     ConsistencyType?: string;
     /**
-     * 一致性超时时间
+     * 一致性超时时间。
+  取值范围：0~1000000（微秒）,设置0则表示若只读实例出现延迟, 导致一致性策略不满足, 请求将一直等待。
      */
     ConsistencyTimeOut?: string;
     /**
@@ -62,7 +63,8 @@ export interface ModifyProxyRwSplitRequest {
      */
     WeightMode?: string;
     /**
-     * 实例只读权重
+     * 实例只读权重。
+  该参数必填。
      */
     InstanceWeights?: Array<ProxyInstanceWeight>;
     /**
@@ -74,7 +76,8 @@ export interface ModifyProxyRwSplitRequest {
      */
     AutoAddRo?: string;
     /**
-     * 是否打开读写分离
+     * 是否打开读写分离。
+  该参数已废弃，请通过RwType设置读写属性。
      */
     OpenRw?: string;
     /**
@@ -83,7 +86,8 @@ export interface ModifyProxyRwSplitRequest {
      */
     RwType?: string;
     /**
-     * 事务拆分
+     * 事务拆分。
+  在一个事务中拆分读和写到不同的实例上去执行。
      */
     TransSplit?: boolean;
     /**
@@ -102,7 +106,8 @@ export interface ModifyProxyRwSplitRequest {
      */
     ConnectionPoolType?: string;
     /**
-     * 连接池时间
+     * 连接池时间。
+  可选范围:0~300（秒）
      */
     ConnectionPoolTimeOut?: number;
 }
@@ -511,11 +516,13 @@ export interface RollBackClusterRequest {
      */
     RollbackStrategy: string;
     /**
-     * 回档ID
+     * 备份文件ID。
+  回档策略为按备份文件回档时必填。
      */
     RollbackId: number;
     /**
-     * 期望回档时间
+     * 期望回档时间。
+  回档策略为timeRollback按时间点回档时必填。
      */
     ExpectTime?: string;
     /**
@@ -1570,7 +1577,7 @@ export interface CreateClustersResponse {
  */
 export interface SetRenewFlagRequest {
     /**
-     * 需操作的实例ID
+     * 需操作的集群ID
      */
     ResourceIds: Array<string>;
     /**
@@ -2555,7 +2562,7 @@ export interface SetRenewFlagResponse {
     /**
      * 操作成功实例数
      */
-    Count: number;
+    Count?: number;
     /**
      * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
      */
@@ -4844,7 +4851,7 @@ export interface CreateProxyEndPointRequest {
      */
     ConnectionPoolTimeOut?: number;
     /**
-     * 安全组ID数组
+     * 绑定的安全组ID数组
      */
     SecurityGroupIds?: Array<string>;
     /**
@@ -4852,7 +4859,7 @@ export interface CreateProxyEndPointRequest {
      */
     Description?: string;
     /**
-     * vip信息
+     * 想要绑定的vip信息，需与UniqueVpcId对应。
      */
     Vip?: string;
     /**
@@ -4865,7 +4872,10 @@ export interface CreateProxyEndPointRequest {
      */
     AutoAddRo?: string;
     /**
-     * 是否开启故障转移
+     * 是否开启故障转移。
+  yes：开启
+  no：不开启。
+  数据库代理出现故障时，链接地址将会路由到主实例
      */
     FailOver?: string;
     /**
@@ -4879,11 +4889,11 @@ export interface CreateProxyEndPointRequest {
      */
     RwType?: string;
     /**
-     * 一致性超时时间
+     * 一致性超时时间。取值范围：0~1000000（微秒）,设置0则表示若只读实例出现延迟, 导致一致性策略不满足, 请求将一直等待
      */
     ConsistencyTimeOut?: number;
     /**
-     * 事务拆分
+     * 是否开启事务拆分。在一个事务中拆分读和写到不同的实例上去执行
      */
     TransSplit?: boolean;
     /**