tencentcloud-sdk-nodejs-svp 4.0.1035 → 4.0.1050

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tencentcloud-sdk-nodejs-svp",
-  "version": "4.0.1035",
-  "description": "Tencent Cloud API NODEJS SDK",
+  "version": "4.0.1050",
+  "description": "腾讯云 API NODEJS SDK",
   "main": "tencentcloud/index.js",
   "scripts": {
     "test": "mocha -t 10000",
@@ -22,7 +22,7 @@
   "author": "tencentcloudapi",
   "license": "Apache-2.0",
   "dependencies": {
-    "tencentcloud-sdk-nodejs-common": "^4.0.488",
+    "tencentcloud-sdk-nodejs-common": "*",
     "tslib": "1.13.0"
   },
   "directories": {
@@ -35,14 +35,19 @@
   },
   "devDependencies": {
     "@types/form-data": "^2.5.0",
+    "@types/json-bigint": "^1.0.1",
     "@types/node": "^14.0.26",
     "@types/node-fetch": "^2.5.7",
+    "@types/uuid": "^9.0.8",
     "@typescript-eslint/eslint-plugin": "^2.34.0",
     "@typescript-eslint/parser": "^2.34.0",
+    "babel-eslint": "^10.0.2",
     "chai": "^4.2.0",
     "eslint": "^6.8.0",
+    "eslint-plugin-react": "^7.17.0",
     "mocha": "^8.1.1",
+    "prettier": "^2.3.0",
     "ts-node": "^8.10.2",
     "typescript": "^3.9.7"
   }
-}
+}

package/src/services/svp/v20240125/svp_client.ts

@@ -18,16 +18,20 @@
 import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common"
 import {
   CreateSavingPlanOrderRequest,
+  DescribeSavingPlanCoverageRequest,
   CreateSavingPlanOrderResponse,
   DescribeSavingPlanDeductRequest,
   SavingPlanOverviewDetail,
+  SavingPlanCoverageRate,
   DescribeSavingPlanUsageRequest,
   SavingPlanDeductDetail,
+  SavingPlanCoverageDetail,
   DescribeSavingPlanOverviewResponse,
   DescribeSavingPlanUsageResponse,
   DescribeSavingPlanDeductResponse,
   DescribeSavingPlanOverviewRequest,
   SavingPlanUsageDetail,
+  DescribeSavingPlanCoverageResponse,
 } from "./svp_models"
 
 /**
@@ -39,6 +43,16 @@ export class Client extends TencentCloudCommon.AbstractClient {
     super("svp.tencentcloudapi.com", "2024-01-25", clientConfig)
   }
 
+  /**
+   * 查询当前用户节省计划覆盖率明细数据，如无特别说明，金额单位均为元（国内站）或者美元（国际站）。
+   */
+  async DescribeSavingPlanCoverage(
+    req: DescribeSavingPlanCoverageRequest,
+    cb?: (error: string, rep: DescribeSavingPlanCoverageResponse) => void
+  ): Promise<DescribeSavingPlanCoverageResponse> {
+    return this.request("DescribeSavingPlanCoverage", req, cb)
+  }
+
   /**
    * 查用当前用户明细节省计划查询时段内的使用情况
    */

package/src/services/svp/v20240125/svp_models.ts

@@ -57,6 +57,32 @@ export interface CreateSavingPlanOrderRequest {
   ClientToken?: string
 }
 
+/**
+ * DescribeSavingPlanCoverage请求参数结构体
+ */
+export interface DescribeSavingPlanCoverageRequest {
+  /**
+   * 费用起始日期，格式yyyy-MM-dd
+   */
+  StartDate: string
+  /**
+   * 费用结束日期，格式yyyy-MM-dd
+   */
+  EndDate: string
+  /**
+   * 分页偏移量，Offset=0表示第一页，如果Limit=100，则Offset=100表示第二页，Offset=200表示第三页，以此类推
+   */
+  Offset: number
+  /**
+   * 数量，最大值为200
+   */
+  Limit: number
+  /**
+   * 取值包括1（缺省值）和2，1表示按天统计覆盖率，2表示按月统计覆盖率，此参数仅影响返回的RateSet聚合粒度，不影响返回的DetailSet
+   */
+  PeriodType?: number
+}
+
 /**
  * CreateSavingPlanOrder返回参数结构体
  */
@@ -163,6 +189,20 @@ export interface SavingPlanOverviewDetail {
   BuyTime?: string
 }
 
+/**
+ * 节省计划覆盖率聚合数据
+ */
+export interface SavingPlanCoverageRate {
+  /**
+   * 聚合时间维度，按天聚合格式为yyyy-MM-dd，按月聚合格式为yyyy-MM
+   */
+  DatePoint?: string
+  /**
+   * 覆盖率结果，取值[0, 100]
+   */
+  Rate?: number
+}
+
 /**
  * DescribeSavingPlanUsage请求参数结构体
  */
@@ -295,6 +335,80 @@ export interface SavingPlanDeductDetail {
   DeductRate?: string
 }
 
+/**
+ * 节省计划覆盖率数据
+ */
+export interface SavingPlanCoverageDetail {
+  /**
+   * 资源 ID：账单中出账对象 ID，不同产品因资源形态不同，资源内容不完全相同，如云服务器 CVM 为对应的实例 ID
+   */
+  ResourceId?: string
+  /**
+   * 地域ID
+   */
+  RegionId?: number
+  /**
+   * 产品编码
+   */
+  ProductCode?: string
+  /**
+   * 子产品编码
+   */
+  SubProductCode?: string
+  /**
+   * 费用起始日期，格式yyyy-MM-dd
+   */
+  StartDate?: string
+  /**
+   * 费用结束日期，格式yyyy-MM-dd，目前与StartDate相等
+   */
+  EndDate?: string
+  /**
+   * 节省计划覆盖金额（即节省计划支付金额）
+   */
+  SpCoveredAmount?: number
+  /**
+   * 节省计划未覆盖金额（即优惠后总价）
+   */
+  SpUncoveredAmount?: number
+  /**
+   * 总支出（即节省计划未覆盖金额 + 节省计划覆盖金额）
+   */
+  TotalRealAmount?: number
+  /**
+   * 按量计费预期金额（即折前价 * 折扣）
+   */
+  ExpectedAmount?: number
+  /**
+   * 覆盖率结果，取值[0, 100]
+   */
+  SpCoverage?: number
+  /**
+   * 支付者昵称
+   */
+  PayerUinName?: string
+  /**
+   * 使用者昵称
+   */
+  OwnerUinName?: string
+  /**
+   * 支付者uin
+   */
+  PayerUin?: string
+  /**
+   * 计费项名称
+   */
+  SubBillingItemName?: string
+  /**
+   * 计费细项名称
+   */
+  BillingItemName?: string
+  /**
+   * 子产品名称
+   */
+  SubProductName?: string
+}
+
 /**
  * DescribeSavingPlanOverview返回参数结构体
  */
@@ -418,3 +532,25 @@ export interface SavingPlanUsageDetail {
    */
   Region?: Array<string>
 }
+
+/**
+ * DescribeSavingPlanCoverage返回参数结构体
+ */
+export interface DescribeSavingPlanCoverageResponse {
+  /**
+   * 节省计划覆盖率明细数据
+   */
+  DetailSet?: Array<SavingPlanCoverageDetail>
+  /**
+   * 节省计划覆盖率聚合数据
+   */
+  RateSet?: Array<SavingPlanCoverageRate>
+  /**
+   * 查询命中的节省计划覆盖率明细数据总条数
+   */
+  TotalCount?: number
+  /**
+   * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}

package/tencentcloud/services/svp/v20240125/svp_client.d.ts

@@ -1,11 +1,15 @@
 import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
-import { CreateSavingPlanOrderRequest, CreateSavingPlanOrderResponse, DescribeSavingPlanDeductRequest, DescribeSavingPlanUsageRequest, DescribeSavingPlanOverviewResponse, DescribeSavingPlanUsageResponse, DescribeSavingPlanDeductResponse, DescribeSavingPlanOverviewRequest } from "./svp_models";
+import { CreateSavingPlanOrderRequest, DescribeSavingPlanCoverageRequest, CreateSavingPlanOrderResponse, DescribeSavingPlanDeductRequest, DescribeSavingPlanUsageRequest, DescribeSavingPlanOverviewResponse, DescribeSavingPlanUsageResponse, DescribeSavingPlanDeductResponse, DescribeSavingPlanOverviewRequest, DescribeSavingPlanCoverageResponse } from "./svp_models";
 /**
  * svp client
  * @class
  */
 export declare class Client extends TencentCloudCommon.AbstractClient {
     constructor(clientConfig: TencentCloudCommon.ClientConfig);
+    /**
+     * 查询当前用户节省计划覆盖率明细数据，如无特别说明，金额单位均为元（国内站）或者美元（国际站）。
+     */
+    DescribeSavingPlanCoverage(req: DescribeSavingPlanCoverageRequest, cb?: (error: string, rep: DescribeSavingPlanCoverageResponse) => void): Promise<DescribeSavingPlanCoverageResponse>;
     /**
      * 查用当前用户明细节省计划查询时段内的使用情况
      */

package/tencentcloud/services/svp/v20240125/svp_client.js

@@ -27,6 +27,12 @@ class Client extends TencentCloudCommon.AbstractClient {
     constructor(clientConfig) {
         super("svp.tencentcloudapi.com", "2024-01-25", clientConfig);
     }
+    /**
+     * 查询当前用户节省计划覆盖率明细数据，如无特别说明，金额单位均为元（国内站）或者美元（国际站）。
+     */
+    async DescribeSavingPlanCoverage(req, cb) {
+        return this.request("DescribeSavingPlanCoverage", req, cb);
+    }
     /**
      * 查用当前用户明细节省计划查询时段内的使用情况
      */

package/tencentcloud/services/svp/v20240125/svp_models.d.ts

@@ -39,6 +39,31 @@ export interface CreateSavingPlanOrderRequest {
      */
     ClientToken?: string;
 }
+/**
+ * DescribeSavingPlanCoverage请求参数结构体
+ */
+export interface DescribeSavingPlanCoverageRequest {
+    /**
+     * 费用起始日期，格式yyyy-MM-dd
+     */
+    StartDate: string;
+    /**
+     * 费用结束日期，格式yyyy-MM-dd
+     */
+    EndDate: string;
+    /**
+     * 分页偏移量，Offset=0表示第一页，如果Limit=100，则Offset=100表示第二页，Offset=200表示第三页，以此类推
+     */
+    Offset: number;
+    /**
+     * 数量，最大值为200
+     */
+    Limit: number;
+    /**
+     * 取值包括1（缺省值）和2，1表示按天统计覆盖率，2表示按月统计覆盖率，此参数仅影响返回的RateSet聚合粒度，不影响返回的DetailSet
+     */
+    PeriodType?: number;
+}
 /**
  * CreateSavingPlanOrder返回参数结构体
  */
@@ -142,6 +167,19 @@ export interface SavingPlanOverviewDetail {
      */
     BuyTime?: string;
 }
+/**
+ * 节省计划覆盖率聚合数据
+ */
+export interface SavingPlanCoverageRate {
+    /**
+     * 聚合时间维度，按天聚合格式为yyyy-MM-dd，按月聚合格式为yyyy-MM
+     */
+    DatePoint?: string;
+    /**
+     * 覆盖率结果，取值[0, 100]
+     */
+    Rate?: number;
+}
 /**
  * DescribeSavingPlanUsage请求参数结构体
  */
@@ -272,6 +310,79 @@ export interface SavingPlanDeductDetail {
      */
     DeductRate?: string;
 }
+/**
+ * 节省计划覆盖率数据
+ */
+export interface SavingPlanCoverageDetail {
+    /**
+     * 资源 ID：账单中出账对象 ID，不同产品因资源形态不同，资源内容不完全相同，如云服务器 CVM 为对应的实例 ID
+     */
+    ResourceId?: string;
+    /**
+     * 地域ID
+     */
+    RegionId?: number;
+    /**
+     * 产品编码
+     */
+    ProductCode?: string;
+    /**
+     * 子产品编码
+     */
+    SubProductCode?: string;
+    /**
+     * 费用起始日期，格式yyyy-MM-dd
+     */
+    StartDate?: string;
+    /**
+     * 费用结束日期，格式yyyy-MM-dd，目前与StartDate相等
+     */
+    EndDate?: string;
+    /**
+     * 节省计划覆盖金额（即节省计划支付金额）
+     */
+    SpCoveredAmount?: number;
+    /**
+     * 节省计划未覆盖金额（即优惠后总价）
+     */
+    SpUncoveredAmount?: number;
+    /**
+     * 总支出（即节省计划未覆盖金额 + 节省计划覆盖金额）
+     */
+    TotalRealAmount?: number;
+    /**
+     * 按量计费预期金额（即折前价 * 折扣）
+     */
+    ExpectedAmount?: number;
+    /**
+     * 覆盖率结果，取值[0, 100]
+     */
+    SpCoverage?: number;
+    /**
+     * 支付者昵称
+     */
+    PayerUinName?: string;
+    /**
+     * 使用者昵称
+     */
+    OwnerUinName?: string;
+    /**
+     * 支付者uin
+     */
+    PayerUin?: string;
+    /**
+     * 计费项名称
+     */
+    SubBillingItemName?: string;
+    /**
+     * 计费细项名称
+     */
+    BillingItemName?: string;
+    /**
+     * 子产品名称
+     */
+    SubProductName?: string;
+}
 /**
  * DescribeSavingPlanOverview返回参数结构体
  */
@@ -391,3 +502,24 @@ export interface SavingPlanUsageDetail {
      */
     Region?: Array<string>;
 }
+/**
+ * DescribeSavingPlanCoverage返回参数结构体
+ */
+export interface DescribeSavingPlanCoverageResponse {
+    /**
+     * 节省计划覆盖率明细数据
+     */
+    DetailSet?: Array<SavingPlanCoverageDetail>;
+    /**
+     * 节省计划覆盖率聚合数据
+     */
+    RateSet?: Array<SavingPlanCoverageRate>;
+    /**
+     * 查询命中的节省计划覆盖率明细数据总条数
+     */
+    TotalCount?: number;
+    /**
+     * 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+     */
+    RequestId?: string;
+}