tencentcloud-sdk-billing 3.0.566 → 3.0.568

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 3db7346ed8ac1da41002bd5e9e588ca66c71b4b3
4
- data.tar.gz: b4c5a4690f61ece0696aceee3eb6258aa825e805
3
+ metadata.gz: afd71c574049ad1eb2816df178f74cd09181aa95
4
+ data.tar.gz: 84282a1afa7c4864fbb8fca43e77b2266f3aceb8
5
5
  SHA512:
6
- metadata.gz: e86eb4f244ec1a4e372b55cafbc56c3ca8ae6f1ef83f298e79133a88f056eedf25b9effbf13f1c4206514c329a4bc6db9d1872233b80abfc261aacec04f49cd8
7
- data.tar.gz: d234c4a451a4976959f20c7395ad32779eb7860ac331a2626c63bd05ea5ee0b7a32a9b6aa452f5970592ab8e92aa8a347bfa13c5f847658ce2ef15f67c9e07ae
6
+ metadata.gz: 1f426e4364cf3d6671fb80bbd400de57f3735c09206d8558376f1746120f923d2531318b92b3858658f0063ec34d16dbd820e11e3e60e186a840b08b3b64240f
7
+ data.tar.gz: f508448d3c00a55a26cd95a6f1b3615c8068d7578f6c07c746b29500c865e8515391965e614d4fdb541a9aaecefa1cdf9bd4e014989664e3244c965f46d61a04
data/lib/VERSION CHANGED
@@ -1 +1 @@
1
- 3.0.566
1
+ 3.0.568
@@ -53,7 +53,10 @@ module TencentCloud
53
53
  raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
54
54
  end
55
55
 
56
- # 查询账单明细数据
56
+ # 查询账单明细数据。
57
+ # 注意事项:
58
+ # 1.在请求接口时,由于网络不稳定或其它异常,可能会导致请求失败。如果您遇到这种情况,我们建议您在接口请求失败时,手动发起重试操作,这样可以更好地确保您的接口请求能够成功执行。
59
+ # 2.对于账单明细数据量级很大(例如每月账单明细量级超过20w)的客户,通过 API 调用账单数据效率较低,建议您开通账单数据存储功能,通过存储桶中获取账单文件进行分析。[账单存储至COS桶](https://cloud.tencent.com/document/product/555/61275)
57
60
 
58
61
  # @param request: Request instance for DescribeBillDetail.
59
62
  # @type request: :class:`Tencentcloud::billing::V20180709::DescribeBillDetailRequest`
@@ -244,7 +244,7 @@ module TencentCloud
244
244
  # @type TimeUnitName: String
245
245
  # @param Cost: 组件原价
246
246
  # @type Cost: String
247
- # @param Discount: 折扣率
247
+ # @param Discount: 折扣率,本资源享受的折扣率(如果客户享受一口价/合同价则默认不展示,退费场景也默认不展示)
248
248
  # @type Discount: String
249
249
  # @param ReduceType: 优惠类型
250
250
  # @type ReduceType: String
@@ -262,7 +262,7 @@ module TencentCloud
262
262
  # @param ComponentCode: 组件名称代码
263
263
  # 注意:此字段可能返回 null,表示取不到有效值。
264
264
  # @type ComponentCode: String
265
- # @param ContractPrice: 合同价
265
+ # @param ContractPrice: 组件单价
266
266
  # 注意:此字段可能返回 null,表示取不到有效值。
267
267
  # @type ContractPrice: String
268
268
  # @param InstanceType: 资源包、预留实例、节省计划、竞价实例这四类特殊实例本身的扣费行为,此字段体现对应的实例类型。枚举值如下:
@@ -271,19 +271,19 @@ module TencentCloud
271
271
  # @param RiTimeSpan: 预留实例抵扣的使用时长,时长单位与被抵扣的时长单位保持一致
272
272
  # 注意:此字段可能返回 null,表示取不到有效值。
273
273
  # @type RiTimeSpan: String
274
- # @param OriginalCostWithRI: 按组件原价的口径换算的预留实例抵扣金额
274
+ # @param OriginalCostWithRI: 预留实例抵扣组件原价,本产品或服务使用预留实例抵扣的组件原价金额
275
275
  # 注意:此字段可能返回 null,表示取不到有效值。
276
276
  # @type OriginalCostWithRI: String
277
- # @param SPDeductionRate: 节省计划可用余额额度范围内,节省计划对于此组件打的折扣率
277
+ # @param SPDeductionRate: 节省计划抵扣率,节省计划可用余额额度范围内,节省计划对于此组件打的折扣率
278
278
  # 注意:此字段可能返回 null,表示取不到有效值。
279
279
  # @type SPDeductionRate: String
280
- # @param SPDeduction: 节省计划抵扣的SP包面值
280
+ # @param SPDeduction: 节省计划抵扣金额,节省计划抵扣的SP包面值
281
281
  # 注意:此字段可能返回 null,表示取不到有效值。
282
282
  # @type SPDeduction: String
283
- # @param OriginalCostWithSP: 按组件原价的口径换算的节省计划抵扣金额
283
+ # @param OriginalCostWithSP: 节省计划抵扣组件原价,节省计划抵扣原价=节省计划包抵扣金额/节省计划抵扣率
284
284
  # 注意:此字段可能返回 null,表示取不到有效值。
285
285
  # @type OriginalCostWithSP: String
286
- # @param BlendedDiscount: 综合了官网折扣、预留实例抵扣、节省计划抵扣的混合折扣率。若没有预留实例抵扣、节省计划抵扣,混合折扣率等于折扣率
286
+ # @param BlendedDiscount: 混合折扣率,综合各类折扣抵扣信息后的最终折扣率,混合折扣率 = 优惠后总价 / 组件原价
287
287
  # 注意:此字段可能返回 null,表示取不到有效值。
288
288
  # @type BlendedDiscount: String
289
289
 
@@ -1537,17 +1537,17 @@ module TencentCloud
1537
1537
 
1538
1538
  # DescribeBillDetail请求参数结构体
1539
1539
  class DescribeBillDetailRequest < TencentCloud::Common::AbstractModel
1540
- # @param Offset: 偏移量
1540
+ # @param Offset: 分页偏移量,Offset=0表示第一页,如果Limit=100,则Offset=100表示第二页,Offset=200表示第三页,依次类推
1541
1541
  # @type Offset: Integer
1542
1542
  # @param Limit: 数量,最大值为100
1543
1543
  # @type Limit: Integer
1544
1544
  # @param PeriodType: 周期类型,byUsedTime按计费周期/byPayTime按扣费周期。需要与费用中心该月份账单的周期保持一致。您可前往[账单概览](https://console.cloud.tencent.com/expense/bill/overview)页面顶部查看确认您的账单统计周期类型。
1545
1545
  # @type PeriodType: String
1546
- # @param Month: 月份,格式为yyyy-mm,Month和BeginTime&EndTime必传一个,如果有传BeginTime&EndTime则Month字段无效。不能早于开通账单2.0的月份,最多可拉取24个月内的数据。
1546
+ # @param Month: 月份,格式为yyyy-mm,Month和BeginTime&EndTime必传一个,如果有传BeginTime&EndTime则Month字段无效。不能早于开通账单2.0的月份,最多可拉取18个月内的数据。
1547
1547
  # @type Month: String
1548
- # @param BeginTime: 周期开始时间,格式为Y-m-d H:i:s,Month和BeginTime&EndTime必传一个,如果有该字段则Month字段无效。BeginTime和EndTime必须一起传。不能早于开通账单2.0的月份,最多可拉取24个月内的数据。(不支持跨月查询)
1548
+ # @param BeginTime: 周期开始时间,格式为yyyy-mm-dd hh:ii:ss,Month和BeginTime&EndTime必传一个,如果有该字段则Month字段无效。BeginTime和EndTime必须一起传。不能早于开通账单2.0的月份,最多可拉取18个月内的数据。(不支持跨月查询)
1549
1549
  # @type BeginTime: String
1550
- # @param EndTime: 周期结束时间,格式为Y-m-d H:i:s,Month和BeginTime&EndTime必传一个,如果有该字段则Month字段无效。BeginTime和EndTime必须一起传。不能早于开通账单2.0的月份,最多可拉取24个月内的数据。(不支持跨月查询)
1550
+ # @param EndTime: 周期结束时间,格式为yyyy-mm-dd hh:ii:ss,Month和BeginTime&EndTime必传一个,如果有该字段则Month字段无效。BeginTime和EndTime必须一起传。不能早于开通账单2.0的月份,最多可拉取18个月内的数据。(不支持跨月查询)
1551
1551
  # @type EndTime: String
1552
1552
  # @param NeedRecordNum: 是否需要访问列表的总记录数,用于前端分页
1553
1553
  # 1-表示需要, 0-表示不需要
@@ -1591,10 +1591,12 @@ module TencentCloud
1591
1591
  # @param BusinessCode: 产品名称代码
1592
1592
  # 备注:如需获取当月使用过的BusinessCode,请调用API:<a href="https://cloud.tencent.com/document/product/555/35761">获取产品汇总费用分布</a>
1593
1593
  # @type BusinessCode: String
1594
+ # @param Context: 上一次请求返回的上下文信息,翻页查询Month>=2023-05的月份的数据可加快查询速度,数据量10万级别以上的用户建议使用,查询速度可提升2~10倍
1595
+ # @type Context: String
1594
1596
 
1595
- attr_accessor :Offset, :Limit, :PeriodType, :Month, :BeginTime, :EndTime, :NeedRecordNum, :ProductCode, :PayMode, :ResourceId, :ActionType, :ProjectId, :BusinessCode
1597
+ attr_accessor :Offset, :Limit, :PeriodType, :Month, :BeginTime, :EndTime, :NeedRecordNum, :ProductCode, :PayMode, :ResourceId, :ActionType, :ProjectId, :BusinessCode, :Context
1596
1598
 
1597
- def initialize(offset=nil, limit=nil, periodtype=nil, month=nil, begintime=nil, endtime=nil, needrecordnum=nil, productcode=nil, paymode=nil, resourceid=nil, actiontype=nil, projectid=nil, businesscode=nil)
1599
+ def initialize(offset=nil, limit=nil, periodtype=nil, month=nil, begintime=nil, endtime=nil, needrecordnum=nil, productcode=nil, paymode=nil, resourceid=nil, actiontype=nil, projectid=nil, businesscode=nil, context=nil)
1598
1600
  @Offset = offset
1599
1601
  @Limit = limit
1600
1602
  @PeriodType = periodtype
@@ -1608,6 +1610,7 @@ module TencentCloud
1608
1610
  @ActionType = actiontype
1609
1611
  @ProjectId = projectid
1610
1612
  @BusinessCode = businesscode
1613
+ @Context = context
1611
1614
  end
1612
1615
 
1613
1616
  def deserialize(params)
@@ -1624,6 +1627,7 @@ module TencentCloud
1624
1627
  @ActionType = params['ActionType']
1625
1628
  @ProjectId = params['ProjectId']
1626
1629
  @BusinessCode = params['BusinessCode']
1630
+ @Context = params['Context']
1627
1631
  end
1628
1632
  end
1629
1633
 
@@ -1631,17 +1635,21 @@ module TencentCloud
1631
1635
  class DescribeBillDetailResponse < TencentCloud::Common::AbstractModel
1632
1636
  # @param DetailSet: 详情列表
1633
1637
  # @type DetailSet: Array
1634
- # @param Total: 总记录数
1638
+ # @param Total: 总记录数,24小时缓存一次,可能比实际总记录数少
1635
1639
  # 注意:此字段可能返回 null,表示取不到有效值。
1636
1640
  # @type Total: Integer
1641
+ # @param Context: 本次请求的上下文信息,可用于下一次请求的请求参数中,加快查询速度
1642
+ # 注意:此字段可能返回 null,表示取不到有效值。
1643
+ # @type Context: String
1637
1644
  # @param RequestId: 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
1638
1645
  # @type RequestId: String
1639
1646
 
1640
- attr_accessor :DetailSet, :Total, :RequestId
1647
+ attr_accessor :DetailSet, :Total, :Context, :RequestId
1641
1648
 
1642
- def initialize(detailset=nil, total=nil, requestid=nil)
1649
+ def initialize(detailset=nil, total=nil, context=nil, requestid=nil)
1643
1650
  @DetailSet = detailset
1644
1651
  @Total = total
1652
+ @Context = context
1645
1653
  @RequestId = requestid
1646
1654
  end
1647
1655
 
@@ -1655,6 +1663,7 @@ module TencentCloud
1655
1663
  end
1656
1664
  end
1657
1665
  @Total = params['Total']
1666
+ @Context = params['Context']
1658
1667
  @RequestId = params['RequestId']
1659
1668
  end
1660
1669
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: tencentcloud-sdk-billing
3
3
  version: !ruby/object:Gem::Version
4
- version: 3.0.566
4
+ version: 3.0.568
5
5
  platform: ruby
6
6
  authors:
7
7
  - Tencent Cloud
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-05-10 00:00:00.000000000 Z
11
+ date: 2023-05-12 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: tencentcloud-sdk-common