tencentcloud-sdk-svp 3.0.1017 → 3.0.1019

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3829979808f76794052998ebfd730ea24c02d5e0
-  data.tar.gz: bdeaef98fe2991146473323c7934fd6dbcd59b77
+  metadata.gz: 3a6a71ab5ae761238a6d275a5c4fd63bfabba945
+  data.tar.gz: 2b7ed6eac125ae65f2c8799381a3f19a50f1f864
 SHA512:
-  metadata.gz: 9f101d1d18247e01e7bce005fb920a49c8095be6fbd08165e37eda9f6051d6548c8543a1690cfe21be4d07febc29301d656d5ae08fa23fd8f6bcc46a25da4bdd
-  data.tar.gz: 95c8578fddb5652996ddb4b414b53b6558d9e9a1dcb7eccf3ebdc503eef7d06425927d613db454b3596a1153aa9609d7e9d5db75fbed01c62726396ca65fbce5
+  metadata.gz: d9255d57c0bb25ab57810860f87c5dd9317bf244ebda7d012a2eabb43aca93ea27267998bc81a268c9bc0a380246513339510976cb2796922e65a53d973a4516
+  data.tar.gz: 4cb72a0b484729dc8415481afa027d15598a75b562a153e429eb4961cdd31fdf68c5f9b0b004a411ba419cedc2dbeb589d9dcf611a9bf7c2d4880412bee092a5

data/lib/VERSION

@@ -1 +1 @@
-3.0.1017
+3.0.1019

data/lib/v20240125/client.rb

@@ -53,6 +53,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 查询当前用户节省计划覆盖率明细数据，如无特别说明，金额单位均为元（国内站）或者美元（国际站）。
+
+        # @param request: Request instance for DescribeSavingPlanCoverage.
+        # @type request: :class:`Tencentcloud::svp::V20240125::DescribeSavingPlanCoverageRequest`
+        # @rtype: :class:`Tencentcloud::svp::V20240125::DescribeSavingPlanCoverageResponse`
+        def DescribeSavingPlanCoverage(request)
+          body = send_request('DescribeSavingPlanCoverage', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = DescribeSavingPlanCoverageResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 查询节省计划抵扣明细
 
         # @param request: Request instance for DescribeSavingPlanDeduct.

data/lib/v20240125/models.rb

@@ -85,6 +85,80 @@ module TencentCloud
         end
       end
 
+      # DescribeSavingPlanCoverage请求参数结构体
+      class DescribeSavingPlanCoverageRequest < TencentCloud::Common::AbstractModel
+        # @param StartDate: 费用起始日期，格式yyyy-MM-dd
+        # @type StartDate: String
+        # @param EndDate: 费用结束日期，格式yyyy-MM-dd
+        # @type EndDate: String
+        # @param Offset: 分页偏移量，Offset=0表示第一页，如果Limit=100，则Offset=100表示第二页，Offset=200表示第三页，以此类推
+        # @type Offset: Integer
+        # @param Limit: 数量，最大值为200
+        # @type Limit: Integer
+        # @param PeriodType: 取值包括1（缺省值）和2，1表示按天统计覆盖率，2表示按月统计覆盖率，此参数仅影响返回的RateSet聚合粒度，不影响返回的DetailSet
+        # @type PeriodType: Integer
+
+        attr_accessor :StartDate, :EndDate, :Offset, :Limit, :PeriodType
+
+        def initialize(startdate=nil, enddate=nil, offset=nil, limit=nil, periodtype=nil)
+          @StartDate = startdate
+          @EndDate = enddate
+          @Offset = offset
+          @Limit = limit
+          @PeriodType = periodtype
+        end
+
+        def deserialize(params)
+          @StartDate = params['StartDate']
+          @EndDate = params['EndDate']
+          @Offset = params['Offset']
+          @Limit = params['Limit']
+          @PeriodType = params['PeriodType']
+        end
+      end
+
+      # DescribeSavingPlanCoverage返回参数结构体
+      class DescribeSavingPlanCoverageResponse < TencentCloud::Common::AbstractModel
+        # @param DetailSet: 节省计划覆盖率明细数据
+        # @type DetailSet: Array
+        # @param RateSet: 节省计划覆盖率聚合数据
+        # @type RateSet: Array
+        # @param TotalCount: 查询命中的节省计划覆盖率明细数据总条数
+        # @type TotalCount: Integer
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :DetailSet, :RateSet, :TotalCount, :RequestId
+
+        def initialize(detailset=nil, rateset=nil, totalcount=nil, requestid=nil)
+          @DetailSet = detailset
+          @RateSet = rateset
+          @TotalCount = totalcount
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['DetailSet'].nil?
+            @DetailSet = []
+            params['DetailSet'].each do |i|
+              savingplancoveragedetail_tmp = SavingPlanCoverageDetail.new
+              savingplancoveragedetail_tmp.deserialize(i)
+              @DetailSet << savingplancoveragedetail_tmp
+            end
+          end
+          unless params['RateSet'].nil?
+            @RateSet = []
+            params['RateSet'].each do |i|
+              savingplancoveragerate_tmp = SavingPlanCoverageRate.new
+              savingplancoveragerate_tmp.deserialize(i)
+              @RateSet << savingplancoveragerate_tmp
+            end
+          end
+          @TotalCount = params['TotalCount']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # DescribeSavingPlanDeduct请求参数结构体
       class DescribeSavingPlanDeductRequest < TencentCloud::Common::AbstractModel
         # @param Offset: 分页偏移量
@@ -296,6 +370,106 @@ module TencentCloud
         end
       end
 
+      # 节省计划覆盖率数据
+      class SavingPlanCoverageDetail < TencentCloud::Common::AbstractModel
+        # @param ResourceId: 资源 ID：账单中出账对象 ID，不同产品因资源形态不同，资源内容不完全相同，如云服务器 CVM 为对应的实例 ID
+        # @type ResourceId: String
+        # @param RegionId: 地域ID
+        # @type RegionId: Integer
+        # @param ProductCode: 产品编码
+        # @type ProductCode: String
+        # @param SubProductCode: 子产品编码
+        # @type SubProductCode: String
+        # @param StartDate: 费用起始日期，格式yyyy-MM-dd
+        # @type StartDate: String
+        # @param EndDate: 费用结束日期，格式yyyy-MM-dd，目前与StartDate相等
+        # @type EndDate: String
+        # @param SpCoveredAmount: 节省计划覆盖金额（即节省计划支付金额）
+        # @type SpCoveredAmount: Float
+        # @param SpUncoveredAmount: 节省计划未覆盖金额（即优惠后总价）
+        # @type SpUncoveredAmount: Float
+        # @param TotalRealAmount: 总支出（即节省计划未覆盖金额 + 节省计划覆盖金额）
+        # @type TotalRealAmount: Float
+        # @param ExpectedAmount: 按量计费预期金额（即折前价 * 折扣）
+        # @type ExpectedAmount: Float
+        # @param SpCoverage: 覆盖率结果，取值[0, 100]
+        # @type SpCoverage: Float
+        # @param PayerUinName: 支付者昵称
+        # @type PayerUinName: String
+        # @param OwnerUinName: 使用者昵称
+        # @type OwnerUinName: String
+        # @param PayerUin: 支付者uin
+        # @type PayerUin: String
+        # @param SubBillingItemName: 计费项名称
+        # @type SubBillingItemName: String
+        # @param BillingItemName: 计费细项名称
+        # @type BillingItemName: String
+        # @param SubProductName: 子产品名称
+        # @type SubProductName: String
+
+        attr_accessor :ResourceId, :RegionId, :ProductCode, :SubProductCode, :StartDate, :EndDate, :SpCoveredAmount, :SpUncoveredAmount, :TotalRealAmount, :ExpectedAmount, :SpCoverage, :PayerUinName, :OwnerUinName, :PayerUin, :SubBillingItemName, :BillingItemName, :SubProductName
+
+        def initialize(resourceid=nil, regionid=nil, productcode=nil, subproductcode=nil, startdate=nil, enddate=nil, spcoveredamount=nil, spuncoveredamount=nil, totalrealamount=nil, expectedamount=nil, spcoverage=nil, payeruinname=nil, owneruinname=nil, payeruin=nil, subbillingitemname=nil, billingitemname=nil, subproductname=nil)
+          @ResourceId = resourceid
+          @RegionId = regionid
+          @ProductCode = productcode
+          @SubProductCode = subproductcode
+          @StartDate = startdate
+          @EndDate = enddate
+          @SpCoveredAmount = spcoveredamount
+          @SpUncoveredAmount = spuncoveredamount
+          @TotalRealAmount = totalrealamount
+          @ExpectedAmount = expectedamount
+          @SpCoverage = spcoverage
+          @PayerUinName = payeruinname
+          @OwnerUinName = owneruinname
+          @PayerUin = payeruin
+          @SubBillingItemName = subbillingitemname
+          @BillingItemName = billingitemname
+          @SubProductName = subproductname
+        end
+
+        def deserialize(params)
+          @ResourceId = params['ResourceId']
+          @RegionId = params['RegionId']
+          @ProductCode = params['ProductCode']
+          @SubProductCode = params['SubProductCode']
+          @StartDate = params['StartDate']
+          @EndDate = params['EndDate']
+          @SpCoveredAmount = params['SpCoveredAmount']
+          @SpUncoveredAmount = params['SpUncoveredAmount']
+          @TotalRealAmount = params['TotalRealAmount']
+          @ExpectedAmount = params['ExpectedAmount']
+          @SpCoverage = params['SpCoverage']
+          @PayerUinName = params['PayerUinName']
+          @OwnerUinName = params['OwnerUinName']
+          @PayerUin = params['PayerUin']
+          @SubBillingItemName = params['SubBillingItemName']
+          @BillingItemName = params['BillingItemName']
+          @SubProductName = params['SubProductName']
+        end
+      end
+
+      # 节省计划覆盖率聚合数据
+      class SavingPlanCoverageRate < TencentCloud::Common::AbstractModel
+        # @param DatePoint: 聚合时间维度，按天聚合格式为yyyy-MM-dd，按月聚合格式为yyyy-MM
+        # @type DatePoint: String
+        # @param Rate: 覆盖率结果，取值[0, 100]
+        # @type Rate: Float
+
+        attr_accessor :DatePoint, :Rate
+
+        def initialize(datepoint=nil, rate=nil)
+          @DatePoint = datepoint
+          @Rate = rate
+        end
+
+        def deserialize(params)
+          @DatePoint = params['DatePoint']
+          @Rate = params['Rate']
+        end
+      end
+
       # 节省计划抵扣明细
       class SavingPlanDeductDetail < TencentCloud::Common::AbstractModel
         # @param OwnerUin: 账号id

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-svp
 version: !ruby/object:Gem::Version
-  version: 3.0.1017
+  version: 3.0.1019
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-03-12 00:00:00.000000000 Z
+date: 2025-03-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common