tencentcloud-sdk-nodejs-billing 4.0.603 → 4.0.605

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -218,29 +218,33 @@ export interface ProjectSummaryOverviewItem {
218
218
  */
219
219
  ProjectId: string;
220
220
  /**
221
- * 项目名称
221
+ * 项目名称:资源归属的项目,用户在控制台给资源自主分配项目,未分配则是默认项目
222
222
  */
223
223
  ProjectName: string;
224
- /**
225
- * 实际花费
226
- */
227
- RealTotalCost: string;
228
224
  /**
229
225
  * 费用所占百分比,两位小数
230
226
  */
231
227
  RealTotalCostRatio: string;
232
228
  /**
233
- * 现金金额
229
+ * 优惠后总价
230
+ */
231
+ RealTotalCost: string;
232
+ /**
233
+ * 现金账户支出:通过现金账户支付的金额
234
234
  */
235
235
  CashPayAmount: string;
236
236
  /**
237
- * 赠送金金额
237
+ * 赠送账户支出:使用赠送金支付的金额
238
238
  */
239
239
  IncentivePayAmount: string;
240
240
  /**
241
- * 代金券金额
241
+ * 优惠券支出:使用各类优惠券(如代金券、现金券等)支付的金额
242
242
  */
243
243
  VoucherPayAmount: string;
244
+ /**
245
+ * 分成金账户支出:通过分成金账户支付的金额
246
+ */
247
+ TransferPayAmount: string;
244
248
  /**
245
249
  * 账单月份,格式2019-08
246
250
  */
@@ -249,10 +253,6 @@ export interface ProjectSummaryOverviewItem {
249
253
  * 原价,单位为元。TotalCost字段自账单3.0(即2021-05)之后开始生效,账单3.0之前返回"-"。合同价的情况下,TotalCost字段与官网价格存在差异,也返回“-”。
250
254
  */
251
255
  TotalCost: string;
252
- /**
253
- * 分成金金额
254
- */
255
- TransferPayAmount: string;
256
256
  }
257
257
  /**
258
258
  * 地域过滤条件
@@ -402,14 +402,15 @@ export interface CostDetail {
402
402
  */
403
403
  export interface DescribeBillSummaryByPayModeResponse {
404
404
  /**
405
- * 数据是否准备好,0未准备好,1准备好
406
- */
407
- Ready: number;
405
+ * 数据是否准备好,0未准备好,1准备好。
406
+ Ready=0,为当前UIN首次进行初始化出账,预计需要5~10分钟,请于10分钟后重试
407
+ */
408
+ Ready?: number;
408
409
  /**
409
410
  * 各付费模式花费分布详情
410
411
  注意:此字段可能返回 null,表示取不到有效值。
411
412
  */
412
- SummaryOverview: Array<PayModeSummaryOverviewItem>;
413
+ SummaryOverview?: Array<PayModeSummaryOverviewItem>;
413
414
  /**
414
415
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
415
416
  */
@@ -420,161 +421,157 @@ export interface DescribeBillSummaryByPayModeResponse {
420
421
  */
421
422
  export interface BillResourceSummary {
422
423
  /**
423
- * 产品名称:云产品大类,如云服务器CVM、云数据库MySQL
424
+ * 产品名称:用户所采购的各类云产品,例如:云服务器 CVM
424
425
  */
425
426
  BusinessCodeName: string;
426
427
  /**
427
- * 子产品名称:云产品子类,如云服务器CVM-标准型S1, 当没有获取到子产品名称时,返回"-"
428
+ * 子产品名称:用户采购的具体产品细分类型,例如:云服务器 CVM-标准型 S1
428
429
  */
429
430
  ProductCodeName: string;
430
431
  /**
431
- * 计费模式:包年包月和按量计费
432
+ * 计费模式:资源的计费模式,区分为包年包月和按量计费
432
433
  */
433
434
  PayModeName: string;
434
435
  /**
435
- * 项目
436
+ * 项目名称:资源归属的项目,用户在控制台给资源自主分配项目,未分配则是默认项目
436
437
  */
437
438
  ProjectName: string;
438
439
  /**
439
- * 地域
440
+ * 地域:资源所属地域,如华南地区(广州)
440
441
  */
441
442
  RegionName: string;
442
443
  /**
443
- * 可用区
444
+ * 可用区:资源所属可用区,如广州三区
444
445
  */
445
446
  ZoneName: string;
446
447
  /**
447
- * 资源实例ID
448
+ * 资源 ID:账单中出账对象 ID,不同产品因资源形态不同,资源内容不完全相同,如云服务器 CVM 为对应的实例 ID
448
449
  */
449
450
  ResourceId: string;
450
451
  /**
451
- * 资源实例名称
452
+ * 资源别名:用户在控制台为资源设置的名称,如果未设置,则默认为空
452
453
  */
453
454
  ResourceName: string;
454
455
  /**
455
- * 交易类型:包年包月新购/续费/升降配/退款、按量计费扣费、调账补偿/扣费等类型
456
+ * 交易类型:如包年包月新购、包年包月续费、按量计费扣费等类型
456
457
  */
457
458
  ActionTypeName: string;
458
459
  /**
459
- * 订单ID
460
+ * 订单ID:包年包月计费模式下订购的订单号
460
461
  */
461
462
  OrderId: string;
462
463
  /**
463
- * 扣费时间
464
+ * 扣费时间:结算扣费时间
464
465
  */
465
466
  PayTime: string;
466
467
  /**
467
- * 开始使用时间
468
+ * 开始使用时间:产品服务开始使用时间
468
469
  */
469
470
  FeeBeginTime: string;
470
471
  /**
471
- * 结束使用时间
472
+ * 结束使用时间:产品服务结束使用时间
472
473
  */
473
474
  FeeEndTime: string;
474
475
  /**
475
- * 配置描述
476
+ * 配置描述:该资源下的计费项名称和用量合并展示,仅在资源账单体现
476
477
  */
477
478
  ConfigDesc: string;
478
479
  /**
479
- * 扩展字段1
480
+ * 扩展字段1:产品对应的扩展属性信息,仅在资源账单体现
480
481
  */
481
482
  ExtendField1: string;
482
483
  /**
483
- * 扩展字段2
484
+ * 扩展字段2:产品对应的扩展属性信息,仅在资源账单体现
484
485
  */
485
486
  ExtendField2: string;
486
487
  /**
487
- * 原价,单位为元
488
+ * 原价:原价 = 组件刊例价 * 组件用量 * 使用时长(如果客户享受一口价/合同价则默认不展示,退费类场景也默认不展示)
488
489
  */
489
490
  TotalCost: string;
490
491
  /**
491
- * 折扣率
492
- 当聚合之后折扣不唯一或者合同价的情况下,返回“-”
493
- */
492
+ * 折扣率:本资源享受的折扣率(如果客户享受一口价/合同价则默认不展示,退费场景也默认不展示)
493
+ */
494
494
  Discount: string;
495
495
  /**
496
496
  * 优惠类型
497
497
  */
498
498
  ReduceType: string;
499
499
  /**
500
- * 优惠后总价,单位为元
500
+ * 优惠后总价
501
501
  */
502
502
  RealTotalCost: string;
503
503
  /**
504
- * 代金券支付金额,单位为元
504
+ * 优惠券支出:使用各类优惠券(如代金券、现金券等)支付的金额
505
505
  */
506
506
  VoucherPayAmount: string;
507
507
  /**
508
- * 现金账户支付金额,单位为元
508
+ * 现金账户支出:通过现金账户支付的金额
509
509
  */
510
510
  CashPayAmount: string;
511
511
  /**
512
- * 赠送账户支付金额,单位为元
512
+ * 赠送账户支出:使用赠送金支付的金额
513
513
  */
514
514
  IncentivePayAmount: string;
515
515
  /**
516
- * 扩展字段3
516
+ * 分成金账户支出:通过分成金账户支付的金额
517
+ 注意:此字段可能返回 null,表示取不到有效值。
518
+ */
519
+ TransferPayAmount?: string;
520
+ /**
521
+ * 扩展字段3:产品对应的扩展属性信息,仅在资源账单体现
517
522
  */
518
523
  ExtendField3: string;
519
524
  /**
520
- * 扩展字段4
525
+ * 扩展字段4:产品对应的扩展属性信息,仅在资源账单体现
521
526
  */
522
527
  ExtendField4: string;
523
528
  /**
524
- * 扩展字段5
529
+ * 扩展字段5:产品对应的扩展属性信息,仅在资源账单体现
525
530
  */
526
531
  ExtendField5: string;
527
532
  /**
528
- * Tag 信息
533
+ * 标签信息
529
534
  注意:此字段可能返回 null,表示取不到有效值。
530
535
  */
531
536
  Tags: Array<BillTagInfo>;
532
537
  /**
533
- * 付款方uin
538
+ * 支付者UIN:支付者的账号 ID,账号 ID 是用户在腾讯云的唯一账号标识
534
539
  */
535
540
  PayerUin: string;
536
541
  /**
537
- * 资源所有者uin,无值则返回"-"
542
+ * 使用者UIN:实际使用资源的账号 ID
538
543
  */
539
544
  OwnerUin: string;
540
545
  /**
541
- * 操作者uin,无值则返回"-"
546
+ * 操作者UIN:操作者账号 ID(预付费资源下单或后付费操作开通资源账号的 ID 或者角色 ID )
542
547
  */
543
548
  OperateUin: string;
544
549
  /**
545
- * 产品名称代码
550
+ * 产品编码
546
551
  */
547
552
  BusinessCode: string;
548
553
  /**
549
- * 子产品名称代码
554
+ * 子产品编码
550
555
  */
551
556
  ProductCode: string;
552
557
  /**
553
- * 区域ID
558
+ * 地域ID
554
559
  */
555
560
  RegionId: number;
556
561
  /**
557
- * 资源包、预留实例、节省计划、竞价实例这四类特殊实例本身的扣费行为,此字段体现对应的实例类型。枚举值如下:
558
-
559
- ri=Standard RI
560
-
561
- svp=Savings Plan
562
-
563
- si=Spot Instances
564
-
565
- rp=Resource Pack
566
- */
562
+ * 实例类型:购买的产品服务对应的实例类型,包括资源包、RI、SP、竞价实例。正常的实例展示默认为不展示
563
+ */
567
564
  InstanceType: string;
568
565
  /**
569
- * 按组件原价的口径换算的预留实例抵扣金额
566
+ * 预留实例抵扣组件原价:本产品或服务使用预留实例抵扣的组件原价金额
570
567
  */
571
568
  OriginalCostWithRI: string;
572
569
  /**
573
- * 节省计划抵扣的SP包面值
570
+ * 节省计划抵扣金额(已废弃)
574
571
  */
575
- SPDeduction: string;
572
+ SPDeduction?: string;
576
573
  /**
577
- * 按组件原价的口径换算的节省计划抵扣金额
574
+ * 节省计划抵扣组件原价:节省计划抵扣原价=节省计划包抵扣金额/节省计划抵扣率
578
575
  */
579
576
  OriginalCostWithSP: string;
580
577
  }
@@ -689,19 +686,20 @@ export interface Conditions {
689
686
  */
690
687
  export interface DescribeBillSummaryByProductResponse {
691
688
  /**
692
- * 数据是否准备好,0未准备好,1准备好
693
- */
694
- Ready: number;
689
+ * 数据是否准备好,0未准备好,1准备好。
690
+ Ready=0,为当前UIN首次进行初始化出账,预计需要5~10分钟,请于10分钟后重试
691
+ */
692
+ Ready?: number;
695
693
  /**
696
694
  * 总花费详情
697
695
  注意:此字段可能返回 null,表示取不到有效值。
698
696
  */
699
- SummaryTotal: BusinessSummaryTotal;
697
+ SummaryTotal?: BusinessSummaryTotal;
700
698
  /**
701
699
  * 各产品花费分布
702
700
  注意:此字段可能返回 null,表示取不到有效值。
703
701
  */
704
- SummaryOverview: Array<BusinessSummaryOverviewItem>;
702
+ SummaryOverview?: Array<BusinessSummaryOverviewItem>;
705
703
  /**
706
704
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
707
705
  */
@@ -725,14 +723,15 @@ export interface BillTagInfo {
725
723
  */
726
724
  export interface DescribeBillSummaryByRegionResponse {
727
725
  /**
728
- * 数据是否准备好,0未准备好,1准备好
729
- */
730
- Ready: number;
726
+ * 数据是否准备好,0未准备好,1准备好
727
+ Ready=0,为当前UIN首次进行初始化出账,预计需要5~10分钟,请于10分钟后重试
728
+ */
729
+ Ready?: number;
731
730
  /**
732
731
  * 各地域花费分布详情
733
732
  注意:此字段可能返回 null,表示取不到有效值。
734
733
  */
735
- SummaryOverview: Array<RegionSummaryOverviewItem>;
734
+ SummaryOverview?: Array<RegionSummaryOverviewItem>;
736
735
  /**
737
736
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
738
737
  */
@@ -1012,29 +1011,33 @@ export interface RegionSummaryOverviewItem {
1012
1011
  */
1013
1012
  RegionId: string;
1014
1013
  /**
1015
- * 地域名称
1014
+ * 地域名称:资源所属地域,例如华南地区(广州)
1016
1015
  */
1017
1016
  RegionName: string;
1018
- /**
1019
- * 实际花费
1020
- */
1021
- RealTotalCost: string;
1022
1017
  /**
1023
1018
  * 费用所占百分比,两位小数
1024
1019
  */
1025
1020
  RealTotalCostRatio: string;
1026
1021
  /**
1027
- * 现金金额
1022
+ * 优惠后总价
1023
+ */
1024
+ RealTotalCost: string;
1025
+ /**
1026
+ * 现金账户支出:通过现金账户支付的金额
1028
1027
  */
1029
1028
  CashPayAmount: string;
1030
1029
  /**
1031
- * 赠送金金额
1030
+ * 赠送账户支出:使用赠送金支付的金额
1032
1031
  */
1033
1032
  IncentivePayAmount: string;
1034
1033
  /**
1035
- * 代金券金额
1034
+ * 优惠券支出:使用各类优惠券(如代金券、现金券等)支付的金额
1036
1035
  */
1037
1036
  VoucherPayAmount: string;
1037
+ /**
1038
+ * 分成金账户支出:通过分成金账户支付的金额
1039
+ */
1040
+ TransferPayAmount: string;
1038
1041
  /**
1039
1042
  * 账单月份,格式2019-08
1040
1043
  */
@@ -1043,10 +1046,6 @@ export interface RegionSummaryOverviewItem {
1043
1046
  * 原价,单位为元。TotalCost字段自账单3.0(即2021-05)之后开始生效,账单3.0之前返回"-"。合同价的情况下,TotalCost字段与官网价格存在差异,也返回“-”。
1044
1047
  */
1045
1048
  TotalCost: string;
1046
- /**
1047
- * 分成金金额
1048
- */
1049
- TransferPayAmount: string;
1050
1049
  }
1051
1050
  /**
1052
1051
  * DescribeCostSummaryByProduct返回参数结构体
@@ -1269,34 +1268,38 @@ export interface DescribeCostSummaryByRegionRequest {
1269
1268
  */
1270
1269
  export interface BusinessSummaryOverviewItem {
1271
1270
  /**
1272
- * 产品名称代码
1271
+ * 产品编码
1273
1272
  注意:此字段可能返回 null,表示取不到有效值。
1274
1273
  */
1275
1274
  BusinessCode: string;
1276
1275
  /**
1277
- * 产品名称:云产品大类,如云服务器CVM、云数据库MySQL
1276
+ * 产品名称:用户所采购的各类云产品,例如:云服务器 CVM
1278
1277
  */
1279
1278
  BusinessCodeName: string;
1280
- /**
1281
- * 实际花费
1282
- */
1283
- RealTotalCost: string;
1284
1279
  /**
1285
1280
  * 费用所占百分比,两位小数
1286
1281
  */
1287
1282
  RealTotalCostRatio: string;
1288
1283
  /**
1289
- * 现金金额
1284
+ * 优惠后总价
1285
+ */
1286
+ RealTotalCost: string;
1287
+ /**
1288
+ * 现金账户支出:通过现金账户支付的金额
1290
1289
  */
1291
1290
  CashPayAmount: string;
1292
1291
  /**
1293
- * 赠送金金额
1292
+ * 赠送账户支出:使用赠送金支付的金额
1294
1293
  */
1295
1294
  IncentivePayAmount: string;
1296
1295
  /**
1297
- * 代金券金额
1296
+ * 优惠券支出:使用各类优惠券(如代金券、现金券等)支付的金额
1298
1297
  */
1299
1298
  VoucherPayAmount: string;
1299
+ /**
1300
+ * 分成金账户支出:通过分成金账户支付的金额
1301
+ */
1302
+ TransferPayAmount: string;
1300
1303
  /**
1301
1304
  * 账单月份,格式2019-08
1302
1305
  */
@@ -1305,57 +1308,53 @@ export interface BusinessSummaryOverviewItem {
1305
1308
  * 原价,单位为元。TotalCost字段自账单3.0(即2021-05)之后开始生效,账单3.0之前返回"-"。合同价的情况下,TotalCost字段与官网价格存在差异,也返回“-”。
1306
1309
  */
1307
1310
  TotalCost: string;
1308
- /**
1309
- * 分成金金额
1310
- */
1311
- TransferPayAmount: string;
1312
1311
  }
1313
1312
  /**
1314
1313
  * 账单明细组件对象
1315
1314
  */
1316
1315
  export interface BillDetailComponent {
1317
1316
  /**
1318
- * 组件类型:资源组件类型的名称,如内存、硬盘等
1317
+ * 组件类型:用户购买的产品或服务对应的组件大类,例如:云服务器 CVM 的组件:CPU、内存等
1319
1318
  */
1320
1319
  ComponentCodeName: string;
1321
1320
  /**
1322
- * 组件名称:资源组件的名称,如云数据库MySQL-内存等
1321
+ * 组件名称:用户购买的产品或服务,所包含的具体组件
1323
1322
  */
1324
1323
  ItemCodeName: string;
1325
1324
  /**
1326
- * 组件刊例价:资源组件的原始价格,保持原始粒度
1325
+ * 组件刊例价:组件的官网原始单价(如果客户享受一口价/合同价则默认不展示)
1327
1326
  */
1328
1327
  SinglePrice: string;
1329
1328
  /**
1330
- * 组件指定价
1329
+ * 组件指定价(已废弃)
1331
1330
  */
1332
- SpecifiedPrice: string;
1331
+ SpecifiedPrice?: string;
1333
1332
  /**
1334
- * 价格单位
1333
+ * 组件价格单位:组件价格的单位,单位构成:元/用量单位/时长单位
1335
1334
  */
1336
1335
  PriceUnit: string;
1337
1336
  /**
1338
- * 组件用量
1337
+ * 组件用量:该组件实际结算用量,组件用量 = 组件原始用量 - 抵扣用量(含资源包
1339
1338
  */
1340
1339
  UsedAmount: string;
1341
1340
  /**
1342
- * 组件用量单位
1341
+ * 组件用量单位:组件用量对应的单位
1343
1342
  */
1344
1343
  UsedAmountUnit: string;
1345
1344
  /**
1346
- * 使用时长
1345
+ * 使用时长:资源使用的时长
1347
1346
  */
1348
1347
  TimeSpan: string;
1349
1348
  /**
1350
- * 时长单位
1349
+ * 时长单位:资源使用时长的单位
1351
1350
  */
1352
1351
  TimeUnitName: string;
1353
1352
  /**
1354
- * 组件原价
1353
+ * 组件原价:原价 = 组件刊例价 * 组件用量 * 使用时长(如果客户享受一口价/合同价则默认不展示,退费类场景也默认不展示)
1355
1354
  */
1356
1355
  Cost: string;
1357
1356
  /**
1358
- * 折扣率,本资源享受的折扣率(如果客户享受一口价/合同价则默认不展示,退费场景也默认不展示)
1357
+ * 折扣率:本资源享受的折扣率(如果客户享受一口价/合同价则默认不展示,退费场景也默认不展示)
1359
1358
  */
1360
1359
  Discount: string;
1361
1360
  /**
@@ -1363,68 +1362,73 @@ export interface BillDetailComponent {
1363
1362
  */
1364
1363
  ReduceType: string;
1365
1364
  /**
1366
- * 优惠后总价
1365
+ * 优惠后总价:优惠后总价=(原价 - 预留实例抵扣原价 - 节省计划抵扣原价)* 折扣率
1367
1366
  */
1368
1367
  RealCost: string;
1369
1368
  /**
1370
- * 代金券支付金额
1369
+ * 优惠券支出:使用各类优惠券(如代金券、现金券等)支付的金额
1371
1370
  */
1372
1371
  VoucherPayAmount: string;
1373
1372
  /**
1374
- * 现金支付金额
1373
+ * 现金账户支出:通过现金账户支付的金额
1375
1374
  */
1376
1375
  CashPayAmount: string;
1377
1376
  /**
1378
- * 赠送账户支付金额
1377
+ * 赠送账户支出:使用赠送金支付的金额
1379
1378
  */
1380
1379
  IncentivePayAmount: string;
1381
1380
  /**
1382
- * 组件类型代码
1381
+ * 分成金账户支出:通过分成金账户支付的金额
1382
+ 注意:此字段可能返回 null,表示取不到有效值。
1383
+ */
1384
+ TransferPayAmount?: string;
1385
+ /**
1386
+ * 组件类型编码
1383
1387
  注意:此字段可能返回 null,表示取不到有效值。
1384
1388
  */
1385
1389
  ItemCode: string;
1386
1390
  /**
1387
- * 组件名称代码
1391
+ * 组件名称编码
1388
1392
  注意:此字段可能返回 null,表示取不到有效值。
1389
1393
  */
1390
1394
  ComponentCode: string;
1391
1395
  /**
1392
- * 组件单价
1396
+ * 组件单价:组件的折后单价,组件单价 = 刊例价 * 折扣
1393
1397
  注意:此字段可能返回 null,表示取不到有效值。
1394
1398
  */
1395
1399
  ContractPrice: string;
1396
1400
  /**
1397
- * 资源包、预留实例、节省计划、竞价实例这四类特殊实例本身的扣费行为,此字段体现对应的实例类型。枚举值如下:
1401
+ * 实例类型:购买的产品服务对应的实例类型,包括资源包、RI、SP、竞价实例。正常的实例展示默认为不展示
1398
1402
  注意:此字段可能返回 null,表示取不到有效值。
1399
1403
  */
1400
1404
  InstanceType: string;
1401
1405
  /**
1402
- * 预留实例抵扣的使用时长,时长单位与被抵扣的时长单位保持一致
1406
+ * 预留实例抵扣的使用时长:本产品或服务使用预留实例抵扣的使用时长
1403
1407
  注意:此字段可能返回 null,表示取不到有效值。
1404
1408
  */
1405
1409
  RiTimeSpan: string;
1406
1410
  /**
1407
- * 预留实例抵扣组件原价,本产品或服务使用预留实例抵扣的组件原价金额
1411
+ * 预留实例抵扣组件原价:本产品或服务使用预留实例抵扣的组件原价金额
1408
1412
  注意:此字段可能返回 null,表示取不到有效值。
1409
1413
  */
1410
1414
  OriginalCostWithRI: string;
1411
1415
  /**
1412
- * 节省计划抵扣率,节省计划可用余额额度范围内,节省计划对于此组件打的折扣率
1416
+ * 节省计划抵扣率:节省计划可用余额额度范围内,节省计划对于此组件打的折扣率
1413
1417
  注意:此字段可能返回 null,表示取不到有效值。
1414
1418
  */
1415
1419
  SPDeductionRate: string;
1416
1420
  /**
1417
- * 节省计划抵扣金额,节省计划抵扣的SP包面值
1421
+ * 节省计划抵扣金额(已废弃)
1418
1422
  注意:此字段可能返回 null,表示取不到有效值。
1419
1423
  */
1420
- SPDeduction: string;
1424
+ SPDeduction?: string;
1421
1425
  /**
1422
- * 节省计划抵扣组件原价,节省计划抵扣原价=节省计划包抵扣金额/节省计划抵扣率
1426
+ * 节省计划抵扣组件原价:节省计划抵扣原价=节省计划包抵扣金额/节省计划抵扣率
1423
1427
  注意:此字段可能返回 null,表示取不到有效值。
1424
1428
  */
1425
1429
  OriginalCostWithSP: string;
1426
1430
  /**
1427
- * 混合折扣率,综合各类折扣抵扣信息后的最终折扣率,混合折扣率 = 优惠后总价 / 组件原价
1431
+ * 混合折扣率:综合各类折扣抵扣信息后的最终折扣率,混合折扣率 = 优惠后总价 / 组件原价
1428
1432
  注意:此字段可能返回 null,表示取不到有效值。
1429
1433
  */
1430
1434
  BlendedDiscount: string;
@@ -1586,7 +1590,7 @@ export interface DescribeBillResourceSummaryResponse {
1586
1590
  */
1587
1591
  ResourceSummarySet?: Array<BillResourceSummary>;
1588
1592
  /**
1589
- * 资源汇总列表总数
1593
+ * 资源汇总列表总数,入参NeedRecordNum为0时不返回
1590
1594
  注意:此字段可能返回 null,表示取不到有效值。
1591
1595
  */
1592
1596
  Total?: number;
@@ -1600,33 +1604,38 @@ export interface DescribeBillResourceSummaryResponse {
1600
1604
  */
1601
1605
  export interface ActionSummaryOverviewItem {
1602
1606
  /**
1603
- * 交易类型:包年包月新购/续费/升降配/退款、按量计费扣费、调账补偿/扣费等类型
1607
+ * 交易类型编码
1604
1608
  */
1605
1609
  ActionType: string;
1606
1610
  /**
1607
- * 交易类型名称
1611
+ * 交易类型:如包年包月新购、包年包月续费、按量计费扣费等类型
1608
1612
  */
1609
1613
  ActionTypeName: string;
1610
- /**
1611
- * 实际花费
1612
- */
1613
- RealTotalCost: string;
1614
1614
  /**
1615
1615
  * 费用所占百分比,两位小数
1616
1616
  */
1617
1617
  RealTotalCostRatio: string;
1618
1618
  /**
1619
- * 现金金额
1619
+ * 优惠后总价
1620
+ */
1621
+ RealTotalCost: string;
1622
+ /**
1623
+ * 现金账户支出:通过现金账户支付的金额
1620
1624
  */
1621
1625
  CashPayAmount: string;
1622
1626
  /**
1623
- * 赠送金金额
1627
+ * 赠送账户支出:使用赠送金支付的金额
1624
1628
  */
1625
1629
  IncentivePayAmount: string;
1626
1630
  /**
1627
- * 代金券金额
1631
+ * 优惠券支出:使用各类优惠券(如代金券、现金券等)支付的金额
1628
1632
  */
1629
1633
  VoucherPayAmount: string;
1634
+ /**
1635
+ * 分成金账户支出:通过分成金账户支付的金额
1636
+ 注意:此字段可能返回 null,表示取不到有效值。
1637
+ */
1638
+ TransferPayAmount?: string;
1630
1639
  /**
1631
1640
  * 账单月份,格式2019-08
1632
1641
  */
@@ -1635,11 +1644,6 @@ export interface ActionSummaryOverviewItem {
1635
1644
  * 原价,单位为元。TotalCost字段自账单3.0(即2021-05)之后开始生效,账单3.0之前返回"-"。合同价的情况下,TotalCost字段与官网价格存在差异,也返回“-”。
1636
1645
  */
1637
1646
  TotalCost: string;
1638
- /**
1639
- * 分成金金额
1640
- 注意:此字段可能返回 null,表示取不到有效值。
1641
- */
1642
- TransferPayAmount?: string;
1643
1647
  }
1644
1648
  /**
1645
1649
  * DescribeVoucherInfo请求参数结构体
@@ -1807,7 +1811,7 @@ export interface DescribeDealsByCondRequest {
1807
1811
  */
1808
1812
  export interface DescribeBillResourceSummaryRequest {
1809
1813
  /**
1810
- * 偏移量
1814
+ * 分页偏移量,Offset=0表示第一页,如果Limit=100,则Offset=100表示第二页,Offset=200表示第三页,依次类推
1811
1815
  */
1812
1816
  Offset: number;
1813
1817
  /**
@@ -1815,7 +1819,7 @@ export interface DescribeBillResourceSummaryRequest {
1815
1819
  */
1816
1820
  Limit: number;
1817
1821
  /**
1818
- * 月份,格式为yyyy-mm。不能早于开通账单2.0的月份,最多可拉取24个月内的数据。
1822
+ * 月份,格式为yyyy-mm。不能早于开通账单2.0的月份
1819
1823
  */
1820
1824
  Month: string;
1821
1825
  /**
@@ -1828,19 +1832,19 @@ export interface DescribeBillResourceSummaryRequest {
1828
1832
  */
1829
1833
  NeedRecordNum?: number;
1830
1834
  /**
1831
- * 查询交易类型,如下:
1835
+ * 查询交易类型(请使用交易类型名称入参),入参示例枚举如下:
1832
1836
  包年包月新购
1833
1837
  包年包月续费
1834
1838
  包年包月配置变更
1835
1839
  包年包月退款
1836
1840
  按量计费扣费
1837
- 按量计费小时结
1838
- 按量计费日结
1839
- 按量计费月结
1840
1841
  线下项目扣费
1841
1842
  线下产品扣费
1842
1843
  调账扣费
1843
1844
  调账补偿
1845
+ 按量计费小时结
1846
+ 按量计费日结
1847
+ 按量计费月结
1844
1848
  竞价实例小时结
1845
1849
  线下项目调账补偿
1846
1850
  线下产品调账补偿
@@ -1855,6 +1859,8 @@ export interface DescribeBillResourceSummaryRequest {
1855
1859
  预留实例退款
1856
1860
  按量计费冲正
1857
1861
  包年包月转按量
1862
+ 保底扣款
1863
+ 节省计划小时费用
1858
1864
  */
1859
1865
  ActionType?: string;
1860
1866
  /**
@@ -1974,7 +1980,7 @@ export interface PayDealsResponse {
1974
1980
  */
1975
1981
  export interface SummaryTotal {
1976
1982
  /**
1977
- * 总数
1983
+ * 优惠后总价
1978
1984
  注意:此字段可能返回 null,表示取不到有效值。
1979
1985
  */
1980
1986
  RealTotalCost: string;
@@ -1989,23 +1995,23 @@ export interface SummaryTotal {
1989
1995
  */
1990
1996
  export interface BillDetail {
1991
1997
  /**
1992
- * 产品名称:云产品大类,如云服务器CVM、云数据库MySQL
1998
+ * 产品名称:用户所采购的各类云产品,例如:云服务器 CVM
1993
1999
  */
1994
2000
  BusinessCodeName: string;
1995
2001
  /**
1996
- * 子产品名称:云产品子类,如云服务器CVM-标准型S1
2002
+ * 子产品名称:用户采购的具体产品细分类型,例如:云服务器 CVM-标准型 S1
1997
2003
  */
1998
2004
  ProductCodeName: string;
1999
2005
  /**
2000
- * 计费模式:包年包月和按量计费
2006
+ * 计费模式:资源的计费模式,区分为包年包月和按量计费
2001
2007
  */
2002
2008
  PayModeName: string;
2003
2009
  /**
2004
- * 项目:资源所属项目
2010
+ * 项目名称:资源归属的项目,用户在控制台给资源自主分配项目,未分配则是默认项目
2005
2011
  */
2006
2012
  ProjectName: string;
2007
2013
  /**
2008
- * 区域:资源所属地域,如华南地区(广州)
2014
+ * 地域:资源所属地域,如华南地区(广州)
2009
2015
  */
2010
2016
  RegionName: string;
2011
2017
  /**
@@ -2013,35 +2019,35 @@ export interface BillDetail {
2013
2019
  */
2014
2020
  ZoneName: string;
2015
2021
  /**
2016
- * 资源实例ID
2022
+ * 资源 ID:账单中出账对象 ID,不同产品因资源形态不同,资源内容不完全相同,如云服务器 CVM 为对应的实例 ID
2017
2023
  */
2018
2024
  ResourceId: string;
2019
2025
  /**
2020
- * 实例名称
2026
+ * 资源别名:用户在控制台为资源设置的名称,如果未设置,则默认为空
2021
2027
  */
2022
2028
  ResourceName: string;
2023
2029
  /**
2024
- * 交易类型
2030
+ * 交易类型,如包年包月新购、包年包月续费、按量计费扣费等类型
2025
2031
  */
2026
2032
  ActionTypeName: string;
2027
2033
  /**
2028
- * 订单ID
2034
+ * 订单ID:包年包月计费模式下订购的订单号
2029
2035
  */
2030
2036
  OrderId: string;
2031
2037
  /**
2032
- * 交易ID
2038
+ * 交易ID:结算扣费单号
2033
2039
  */
2034
2040
  BillId: string;
2035
2041
  /**
2036
- * 扣费时间
2042
+ * 扣费时间:结算扣费时间
2037
2043
  */
2038
2044
  PayTime: string;
2039
2045
  /**
2040
- * 开始使用时间
2046
+ * 开始使用时间:产品服务开始使用时间
2041
2047
  */
2042
2048
  FeeBeginTime: string;
2043
2049
  /**
2044
- * 结束使用时间
2050
+ * 结束使用时间:产品服务结束使用时间
2045
2051
  */
2046
2052
  FeeEndTime: string;
2047
2053
  /**
@@ -2049,44 +2055,44 @@ export interface BillDetail {
2049
2055
  */
2050
2056
  ComponentSet: Array<BillDetailComponent>;
2051
2057
  /**
2052
- * 支付者UIN
2058
+ * 支付者UIN:支付者的账号 ID,账号 ID 是用户在腾讯云的唯一账号标识
2053
2059
  */
2054
2060
  PayerUin: string;
2055
2061
  /**
2056
- * 使用者UIN
2062
+ * 使用者UIN:实际使用资源的账号 ID
2057
2063
  */
2058
2064
  OwnerUin: string;
2059
2065
  /**
2060
- * 操作者UIN
2066
+ * 操作者UIN:操作者账号 ID(预付费资源下单或后付费操作开通资源账号的 ID 或者角色 ID )
2061
2067
  */
2062
2068
  OperateUin: string;
2063
2069
  /**
2064
- * Tag 信息
2070
+ * 标签信息
2065
2071
  注意:此字段可能返回 null,表示取不到有效值。
2066
2072
  */
2067
2073
  Tags: Array<BillTagInfo>;
2068
2074
  /**
2069
- * 产品名称代码
2075
+ * 产品编码
2070
2076
  注意:此字段可能返回 null,表示取不到有效值。
2071
2077
  */
2072
2078
  BusinessCode: string;
2073
2079
  /**
2074
- * 子产品名称代码
2080
+ * 子产品编码
2075
2081
  注意:此字段可能返回 null,表示取不到有效值。
2076
2082
  */
2077
2083
  ProductCode: string;
2078
2084
  /**
2079
- * 交易类型代码
2085
+ * 交易类型编码
2080
2086
  注意:此字段可能返回 null,表示取不到有效值。
2081
2087
  */
2082
2088
  ActionType: string;
2083
2089
  /**
2084
- * 区域ID
2090
+ * 地域ID
2085
2091
  注意:此字段可能返回 null,表示取不到有效值。
2086
2092
  */
2087
2093
  RegionId: string;
2088
2094
  /**
2089
- * 项目ID:资源所属项目ID
2095
+ * 项目ID
2090
2096
  */
2091
2097
  ProjectId: number;
2092
2098
  /**
@@ -2100,8 +2106,9 @@ export interface BillDetail {
2100
2106
  */
2101
2107
  export interface DescribeBillSummaryByTagResponse {
2102
2108
  /**
2103
- * 数据是否准备好,0未准备好,1准备好
2104
- */
2109
+ * 数据是否准备好,0未准备好,1准备好
2110
+ Ready=0,为当前UIN首次进行初始化出账,预计需要5~10分钟,请于10分钟后重试
2111
+ */
2105
2112
  Ready?: number;
2106
2113
  /**
2107
2114
  * 各标签值花费分布详情
@@ -2127,41 +2134,41 @@ export interface TagSummaryOverviewItem {
2127
2134
  注意:此字段可能返回 null,表示取不到有效值。
2128
2135
  */
2129
2136
  TagValue: string;
2130
- /**
2131
- * 实际花费
2132
- 注意:此字段可能返回 null,表示取不到有效值。
2133
- */
2134
- RealTotalCost: string;
2135
2137
  /**
2136
2138
  * 费用所占百分比,两位小数
2137
2139
  注意:此字段可能返回 null,表示取不到有效值。
2138
2140
  */
2139
2141
  RealTotalCostRatio: string;
2140
2142
  /**
2141
- * 原价,单位为元。TotalCost字段自账单3.0(即2021-05)之后开始生效,账单3.0之前返回"-"。合同价的情况下,TotalCost字段与官网价格存在差异,也返回“-”。
2143
+ * 优惠后总价
2142
2144
  注意:此字段可能返回 null,表示取不到有效值。
2143
2145
  */
2144
- TotalCost: string;
2146
+ RealTotalCost: string;
2145
2147
  /**
2146
- * 现金金额
2148
+ * 现金账户支出:通过现金账户支付的金额
2147
2149
  注意:此字段可能返回 null,表示取不到有效值。
2148
2150
  */
2149
2151
  CashPayAmount: string;
2150
2152
  /**
2151
- * 赠送金金额
2153
+ * 赠送账户支出:使用赠送金支付的金额
2152
2154
  注意:此字段可能返回 null,表示取不到有效值。
2153
2155
  */
2154
2156
  IncentivePayAmount: string;
2155
2157
  /**
2156
- * 代金券金额
2158
+ * 优惠券支出:使用各类优惠券(如代金券、现金券等)支付的金额
2157
2159
  注意:此字段可能返回 null,表示取不到有效值。
2158
2160
  */
2159
2161
  VoucherPayAmount: string;
2160
2162
  /**
2161
- * 分成金金额
2163
+ * 分成金账户支出:通过分成金账户支付的金额
2162
2164
  注意:此字段可能返回 null,表示取不到有效值。
2163
2165
  */
2164
2166
  TransferPayAmount: string;
2167
+ /**
2168
+ * 原价,单位为元。TotalCost字段自账单3.0(即2021-05)之后开始生效,账单3.0之前返回"-"。合同价的情况下,TotalCost字段与官网价格存在差异,也返回“-”。
2169
+ 注意:此字段可能返回 null,表示取不到有效值。
2170
+ */
2171
+ TotalCost: string;
2165
2172
  }
2166
2173
  /**
2167
2174
  * DescribeCostSummaryByResource返回参数结构体
@@ -2517,14 +2524,15 @@ export interface DescribeBillSummaryByProjectRequest {
2517
2524
  */
2518
2525
  export interface DescribeBillSummaryByProjectResponse {
2519
2526
  /**
2520
- * 数据是否准备好,0未准备好,1准备好
2521
- */
2522
- Ready: number;
2527
+ * 数据是否准备好,0未准备好,1准备好
2528
+ Ready=0,为当前UIN首次进行初始化出账,预计需要5~10分钟,请于10分钟后重试
2529
+ */
2530
+ Ready?: number;
2523
2531
  /**
2524
2532
  * 各项目花费分布详情
2525
2533
  注意:此字段可能返回 null,表示取不到有效值。
2526
2534
  */
2527
- SummaryOverview: Array<ProjectSummaryOverviewItem>;
2535
+ SummaryOverview?: Array<ProjectSummaryOverviewItem>;
2528
2536
  /**
2529
2537
  * 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
2530
2538
  */
@@ -2630,78 +2638,79 @@ export interface ExcludedProducts {
2630
2638
  PayMode: string;
2631
2639
  }
2632
2640
  /**
2633
- * 按付费模式汇总消费详情
2641
+ * 按计费模式汇总消费详情
2634
2642
  */
2635
2643
  export interface PayModeSummaryOverviewItem {
2636
2644
  /**
2637
- * 付费模式
2645
+ * 计费模式编码
2638
2646
  */
2639
2647
  PayMode: string;
2640
2648
  /**
2641
- * 付费模式名称
2649
+ * 计费模式:区分为包年包月和按量计费
2642
2650
  */
2643
2651
  PayModeName: string;
2644
- /**
2645
- * 实际花费
2646
- */
2647
- RealTotalCost: string;
2648
2652
  /**
2649
2653
  * 费用所占百分比,两位小数
2650
2654
  */
2651
2655
  RealTotalCostRatio: string;
2652
2656
  /**
2653
- * 按交易类型:包年包月新购/续费/升降配/退款、按量计费扣费、调账补偿/扣费等类型汇总消费详情
2657
+ * 优惠后总价
2654
2658
  */
2655
- Detail: Array<ActionSummaryOverviewItem>;
2659
+ RealTotalCost: string;
2656
2660
  /**
2657
- * 现金金额
2661
+ * 现金账户支出:通过现金账户支付的金额
2658
2662
  */
2659
2663
  CashPayAmount: string;
2660
2664
  /**
2661
- * 赠送金金额
2665
+ * 赠送账户支出:使用赠送金支付的金额
2662
2666
  */
2663
2667
  IncentivePayAmount: string;
2664
2668
  /**
2665
- * 代金券金额
2669
+ * 优惠券支出:使用各类优惠券(如代金券、现金券等)支付的金额
2666
2670
  */
2667
2671
  VoucherPayAmount: string;
2672
+ /**
2673
+ * 分成金账户支出:通过分成金账户支付的金额
2674
+ */
2675
+ TransferPayAmount: string;
2668
2676
  /**
2669
2677
  * 原价,单位为元。TotalCost字段自账单3.0(即2021-05)之后开始生效,账单3.0之前返回"-"。合同价的情况下,TotalCost字段与官网价格存在差异,也返回“-”。
2670
2678
  */
2671
2679
  TotalCost: string;
2672
2680
  /**
2673
- * 分成金金额
2681
+ * 按交易类型汇总消费详情
2674
2682
  */
2675
- TransferPayAmount: string;
2683
+ Detail: Array<ActionSummaryOverviewItem>;
2676
2684
  }
2677
2685
  /**
2678
2686
  * 按产品汇总总费用
2679
2687
  */
2680
2688
  export interface BusinessSummaryTotal {
2681
2689
  /**
2682
- * 总花费
2683
- */
2690
+ * 优惠后总价
2691
+
2692
+ */
2684
2693
  RealTotalCost: string;
2685
2694
  /**
2686
- * 代金券金额
2695
+ * 优惠券支出:使用各类优惠券(如代金券、现金券等)支付的金额
2687
2696
  */
2688
2697
  VoucherPayAmount: string;
2689
2698
  /**
2690
- * 赠送金金额
2699
+ * 赠送账户支出:使用赠送金支付的金额
2691
2700
  */
2692
2701
  IncentivePayAmount: string;
2693
2702
  /**
2694
- * 现金金额
2703
+ * 现金账户支出:通过现金账户支付的金额
2695
2704
  */
2696
2705
  CashPayAmount: string;
2697
2706
  /**
2698
- * 原价,单位为元。TotalCost字段自账单3.0(即2021-05)之后开始生效,账单3.0之前返回"-"。合同价的情况下,TotalCost字段与官网价格存在差异,也返回“-”。
2707
+ * 分成金账户支出:通过分成金账户支付的金额
2699
2708
  */
2700
- TotalCost: string;
2709
+ TransferPayAmount: string;
2701
2710
  /**
2702
- * 分成金金额
2711
+ * 原价,单位为元。TotalCost字段自账单3.0(即2021-05)之后开始生效,账单3.0之前返回"-"。合同价的情况下,TotalCost字段与官网价格存在差异,也返回“-”。
2703
2712
  */
2704
- TransferPayAmount: string;
2713
+ TotalCost: string;
2705
2714
  }
2706
2715
  /**
2707
2716
  * DescribeCostSummaryByRegion返回参数结构体