tencentcloud-sdk-nodejs-billing 4.0.612 → 4.0.614

package/src/services/billing/v20180709/billing_models.ts

@@ -142,6 +142,26 @@ export interface VoucherInfos {
   ExcludedProducts: Array<ExcludedProducts>
 }
 
+/**
+ * DescribeBillSummary返回参数结构体
+ */
+export interface DescribeBillSummaryResponse {
+  /**
+   * 数据是否准备好，0准备中，1已就绪。（Ready=0，为当前UIN首次进行初始化出账，预计需要5~10分钟出账，请于10分钟后重试即可）
+   */
+  Ready?: number
+
+  /**
+   * 账单多维度汇总消费详情
+   */
+  SummaryDetail?: Array<SummaryDetail>
+
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   */
+  RequestId?: string
+}
+
 /**
  * DescribeCostSummaryByProduct请求参数结构体
  */
@@ -157,12 +177,12 @@ export interface DescribeCostSummaryByProductRequest {
   EndTime: string
 
   /**
-   * 每次获取数据量
+   * 每次获取数据量，最大值为100
    */
   Limit: number
 
   /**
-   * 偏移量
+   * 偏移量,默认从0开始
    */
   Offset: number
 
@@ -178,13 +198,43 @@ export interface DescribeCostSummaryByProductRequest {
 }
 
 /**
- * 消耗汇总详情
+ * cos产品用量明细返回数据结构
  */
-export interface ConsumptionSummaryTotal {
+export interface CosDetailSets {
   /**
-   * 折后总价
+   * 存储桶名称
    */
-  RealTotalCost: string
+  BucketName: string
+
+  /**
+   * 用量开始时间
+   */
+  DosageBeginTime: string
+
+  /**
+   * 用量结束时间
+   */
+  DosageEndTime: string
+
+  /**
+   * 子产品名称
+   */
+  SubProductCodeName: string
+
+  /**
+   * 计费项名称
+   */
+  BillingItemCodeName: string
+
+  /**
+   * 用量
+   */
+  DosageValue: string
+
+  /**
+   * 单位
+   */
+  Unit: string
 }
 
 /**
@@ -389,6 +439,30 @@ export interface ConsumptionBusinessSummaryDataItem {
    * 费用趋势
    */
   Trend: ConsumptionSummaryTrend
+
+  /**
+      * 现金
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  CashPayAmount?: string
+
+  /**
+      * 赠送金
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  IncentivePayAmount?: string
+
+  /**
+      * 代金券
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  VoucherPayAmount?: string
+
+  /**
+      * 分成金
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  TransferPayAmount?: string
 }
 
 /**
@@ -1081,6 +1155,60 @@ export interface ConsumptionResourceSummaryDataItem {
    * 消耗类型
    */
   ConsumptionTypeName: string
+
+  /**
+      * 折前价
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  RealCost?: string
+
+  /**
+      * 费用起始时间
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  FeeBeginTime?: string
+
+  /**
+      * 费用结束时间
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  FeeEndTime?: string
+
+  /**
+      * 天数
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  DayDiff?: string
+
+  /**
+      * 每日消耗
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  DailyTotalCost?: string
+
+  /**
+      * 订单号
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  OrderId?: string
+
+  /**
+      * 代金券
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  VoucherPayAmount?: string
+
+  /**
+      * 赠送金
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  IncentivePayAmount?: string
+
+  /**
+      * 分成金
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  TransferPayAmount?: string
 }
 
 /**
@@ -1191,6 +1319,21 @@ export interface DescribeBillDetailRequest {
   Context?: string
 }
 
+/**
+ * 商品详细信息
+ */
+export interface ProductInfo {
+  /**
+   * 商品详情名称标识
+   */
+  Name: string
+
+  /**
+   * 商品详情
+   */
+  Value: string
+}
+
 /**
  * 消耗按项目汇总详情
  */
@@ -1219,6 +1362,30 @@ export interface ConsumptionProjectSummaryDataItem {
    * 产品消耗详情
    */
   Business: Array<ConsumptionBusinessSummaryDataItem>
+
+  /**
+      * 现金
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  CashPayAmount?: string
+
+  /**
+      * 赠送金
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  IncentivePayAmount?: string
+
+  /**
+      * 代金券
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  VoucherPayAmount?: string
+
+  /**
+      * 分成金
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  TransferPayAmount?: string
 }
 
 /**
@@ -1310,18 +1477,31 @@ export interface DescribeCostSummaryByProductResponse {
 }
 
 /**
- * 商品详细信息
+ * DescribeBillSummaryByTag返回参数结构体
  */
-export interface ProductInfo {
+export interface DescribeBillSummaryByTagResponse {
   /**
-   * 商品详情名称标识
-   */
-  Name: string
+      * 数据是否准备好，0未准备好，1准备好
+Ready=0，为当前UIN首次进行初始化出账，预计需要5~10分钟，请于10分钟后重试
+      */
+  Ready?: number
 
   /**
-   * 商品详情
+      * 各标签值花费分布详情
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  SummaryOverview?: Array<TagSummaryOverviewItem>
+
+  /**
+      * 总数
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  SummaryTotal?: SummaryTotal
+
+  /**
+   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
    */
-  Value: string
+  RequestId?: string
 }
 
 /**
@@ -1518,12 +1698,12 @@ export interface DescribeCostSummaryByRegionRequest {
   EndTime: string
 
   /**
-   * 每次获取数据量
+   * 每次获取数据量，最大值为100
    */
   Limit: number
 
   /**
-   * 偏移量
+   * 偏移量,默认从0开始
    */
   Offset: number
 
@@ -1816,12 +1996,12 @@ export interface DescribeCostSummaryByProjectRequest {
   EndTime: string
 
   /**
-   * 每次获取数据量
+   * 每次获取数据量，最大值为100
    */
   Limit: number
 
   /**
-   * 偏移量
+   * 偏移量,默认从0开始
    */
   Offset: number
 
@@ -1836,6 +2016,77 @@ export interface DescribeCostSummaryByProjectRequest {
   NeedRecordNum?: number
 }
 
+/**
+ * 账单多维度汇总消费详情
+ */
+export interface SummaryDetail {
+  /**
+      * 账单维度编码
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  GroupKey?: string
+
+  /**
+      * 账单维度值
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  GroupValue?: string
+
+  /**
+   * 原价，单位为元。TotalCost字段自账单3.0（即2021-05）之后开始生效，账单3.0之前返回"-"。合同价的情况下，TotalCost字段与官网价格存在差异，也返回“-”。
+   */
+  TotalCost?: string
+
+  /**
+   * 优惠后总价
+   */
+  RealTotalCost?: string
+
+  /**
+   * 现金账户支出：通过现金账户支付的金额
+   */
+  CashPayAmount?: string
+
+  /**
+   * 赠送账户支出：使用赠送金支付的金额
+   */
+  IncentivePayAmount?: string
+
+  /**
+   * 优惠券支出：使用各类优惠券（如代金券、现金券等）支付的金额
+   */
+  VoucherPayAmount?: string
+
+  /**
+      * 分成金账户支出：通过分成金账户支付的金额
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  TransferPayAmount?: string
+
+  /**
+      * 产品汇总信息
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  Business?: Array<BusinessSummaryInfo>
+}
+
+/**
+ * 购买商品信息
+ */
+export interface UsageDetails {
+  /**
+      * 商品名
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  ProductName: string
+
+  /**
+      * 商品细节
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  SubProductName: string
+}
+
 /**
  * 使用记录
  */
@@ -1903,20 +2154,23 @@ export interface DescribeDosageCosDetailByDateResponse {
 }
 
 /**
- * 购买商品信息
+ * DescribeBillSummary请求参数结构体
  */
-export interface UsageDetails {
+export interface DescribeBillSummaryRequest {
   /**
-      * 商品名
-注意：此字段可能返回 null，表示取不到有效值。
-      */
-  ProductName: string
+   * 账单月份，格式为2023-04
+   */
+  Month: string
 
   /**
-      * 商品细节
-注意：此字段可能返回 null，表示取不到有效值。
-      */
-  SubProductName: string
+   * 账单维度类型，枚举值如下：business、project、region、payMode、tag
+   */
+  GroupType: string
+
+  /**
+   * 标签键，GroupType=tag获取标签维度账单时传
+   */
+  TagKey?: Array<string>
 }
 
 /**
@@ -2535,31 +2789,50 @@ export interface BillDetail {
 }
 
 /**
- * DescribeBillSummaryByTag返回参数结构体
+ * 产品汇总信息
  */
-export interface DescribeBillSummaryByTagResponse {
+export interface BusinessSummaryInfo {
   /**
-      * 数据是否准备好，0未准备好，1准备好
-Ready=0，为当前UIN首次进行初始化出账，预计需要5~10分钟，请于10分钟后重试
-      */
-  Ready?: number
+   * 产品编码
+   */
+  BusinessCode?: string
 
   /**
-      * 各标签值花费分布详情
-注意：此字段可能返回 null，表示取不到有效值。
-      */
-  SummaryOverview?: Array<TagSummaryOverviewItem>
+   * 产品名称：用户所采购的各类云产品，例如：云服务器 CVM
+   */
+  BusinessCodeName?: string
 
   /**
-      * 总数
+      * 原价，单位为元。TotalCost字段自账单3.0（即2021-05）之后开始生效，账单3.0之前返回"-"。合同价的情况下，TotalCost字段与官网价格存在差异，也返回“-”。
 注意：此字段可能返回 null，表示取不到有效值。
       */
-  SummaryTotal?: SummaryTotal
+  TotalCost?: string
 
   /**
-   * 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
+   * 优惠后总价
    */
-  RequestId?: string
+  RealTotalCost?: string
+
+  /**
+   * 现金账户支出：通过现金账户支付的金额
+   */
+  CashPayAmount?: string
+
+  /**
+   * 赠送账户支出：使用赠送金支付的金额
+   */
+  IncentivePayAmount?: string
+
+  /**
+   * 优惠券支出：使用各类优惠券（如代金券、现金券等）支付的金额
+   */
+  VoucherPayAmount?: string
+
+  /**
+      * 分成金账户支出：通过分成金账户支付的金额
+注意：此字段可能返回 null，表示取不到有效值。
+      */
+  TransferPayAmount?: string
 }
 
 /**
@@ -2973,43 +3246,13 @@ export interface ConditionProject {
 }
 
 /**
- * cos产品用量明细返回数据结构
+ * 消耗汇总详情
  */
-export interface CosDetailSets {
-  /**
-   * 存储桶名称
-   */
-  BucketName: string
-
-  /**
-   * 用量开始时间
-   */
-  DosageBeginTime: string
-
-  /**
-   * 用量结束时间
-   */
-  DosageEndTime: string
-
-  /**
-   * 子产品名称
-   */
-  SubProductCodeName: string
-
-  /**
-   * 计费项名称
-   */
-  BillingItemCodeName: string
-
-  /**
-   * 用量
-   */
-  DosageValue: string
-
+export interface ConsumptionSummaryTotal {
   /**
-   * 单位
+   * 折后总价
    */
-  Unit: string
+  RealTotalCost: string
 }
 
 /**
@@ -3084,12 +3327,12 @@ export interface DescribeCostSummaryByResourceRequest {
   EndTime: string
 
   /**
-   * 每次获取数据量
+   * 每次获取数据量，最大值为100
    */
   Limit: number
 
   /**
-   * 偏移量
+   * 偏移量,默认从0开始
    */
   Offset: number
 

package/tencentcloud/services/billing/v20180709/billing_client.d.ts

@@ -1,5 +1,5 @@
 import * as TencentCloudCommon from "tencentcloud-sdk-nodejs-common";
-import { DescribeCostSummaryByProductRequest, DescribeCostSummaryByProjectResponse, DescribeDosageDetailByDateRequest, DescribeBillSummaryByProductRequest, DescribeBillSummaryByPayModeResponse, DescribeBillSummaryByTagRequest, DescribeBillSummaryByProductResponse, DescribeBillSummaryByRegionResponse, DescribeVoucherInfoResponse, DescribeAccountBalanceRequest, DescribeBillDetailRequest, DescribeCostSummaryByProductResponse, DescribeDosageDetailByDateResponse, DescribeBillListResponse, DescribeAccountBalanceResponse, DescribeCostSummaryByRegionRequest, DescribeBillSummaryByRegionRequest, DescribeBillSummaryByPayModeRequest, DescribeCostSummaryByProjectRequest, DescribeDosageCosDetailByDateResponse, DescribeBillResourceSummaryResponse, DescribeVoucherInfoRequest, DescribeVoucherUsageDetailsRequest, DescribeDealsByCondRequest, DescribeBillResourceSummaryRequest, PayDealsRequest, DescribeBillListRequest, PayDealsResponse, DescribeBillSummaryByTagResponse, DescribeCostSummaryByResourceResponse, DescribeBillDetailResponse, DescribeCostDetailRequest, DescribeVoucherUsageDetailsResponse, DescribeDealsByCondResponse, DescribeBillSummaryByProjectRequest, DescribeBillSummaryByProjectResponse, DescribeCostSummaryByResourceRequest, DescribeCostDetailResponse, DescribeDosageCosDetailByDateRequest, DescribeCostSummaryByRegionResponse } from "./billing_models";
+import { DescribeBillSummaryResponse, DescribeCostSummaryByProductRequest, DescribeCostSummaryByProjectResponse, DescribeDosageDetailByDateRequest, DescribeBillSummaryByProductRequest, DescribeBillSummaryByPayModeResponse, DescribeBillSummaryByTagRequest, DescribeBillSummaryByProductResponse, DescribeBillSummaryByRegionResponse, DescribeVoucherInfoResponse, DescribeAccountBalanceRequest, DescribeBillDetailRequest, DescribeCostSummaryByProductResponse, DescribeBillSummaryByTagResponse, DescribeDosageDetailByDateResponse, DescribeBillListResponse, DescribeAccountBalanceResponse, DescribeCostSummaryByRegionRequest, DescribeBillSummaryByRegionRequest, DescribeBillSummaryByPayModeRequest, DescribeCostSummaryByProjectRequest, DescribeDosageCosDetailByDateResponse, DescribeBillSummaryRequest, DescribeBillResourceSummaryResponse, DescribeVoucherInfoRequest, DescribeVoucherUsageDetailsRequest, DescribeDealsByCondRequest, DescribeBillResourceSummaryRequest, PayDealsRequest, DescribeBillListRequest, PayDealsResponse, DescribeCostSummaryByResourceResponse, DescribeBillDetailResponse, DescribeCostDetailRequest, DescribeVoucherUsageDetailsResponse, DescribeDealsByCondResponse, DescribeBillSummaryByProjectRequest, DescribeBillSummaryByProjectResponse, DescribeCostSummaryByResourceRequest, DescribeCostDetailResponse, DescribeDosageCosDetailByDateRequest, DescribeCostSummaryByRegionResponse } from "./billing_models";
 /**
  * billing client
  * @class
@@ -37,6 +37,10 @@ export declare class Client extends TencentCloudCommon.AbstractClient {
   2.对于账单明细数据量级很大（例如每月账单明细量级超过20w）的客户，通过 API 调用账单数据效率较低，建议您开通账单数据存储功能，通过存储桶中获取账单文件进行分析。[账单存储至COS桶](https://cloud.tencent.com/document/product/555/61275)
        */
     DescribeBillDetail(req: DescribeBillDetailRequest, cb?: (error: string, rep: DescribeBillDetailResponse) => void): Promise<DescribeBillDetailResponse>;
+    /**
+     * 该接口支持通过传参，按照产品、项目、地域、计费模式和标签五个维度获取账单费用明细。
+     */
+    DescribeBillSummary(req: DescribeBillSummaryRequest, cb?: (error: string, rep: DescribeBillSummaryResponse) => void): Promise<DescribeBillSummaryResponse>;
     /**
      * 查询订单
      */

package/tencentcloud/services/billing/v20180709/billing_client.js

@@ -72,6 +72,12 @@ class Client extends TencentCloudCommon.AbstractClient {
     async DescribeBillDetail(req, cb) {
         return this.request("DescribeBillDetail", req, cb);
     }
+    /**
+     * 该接口支持通过传参，按照产品、项目、地域、计费模式和标签五个维度获取账单费用明细。
+     */
+    async DescribeBillSummary(req, cb) {
+        return this.request("DescribeBillSummary", req, cb);
+    }
     /**
      * 查询订单
      */