tencentcloud-sdk-svp 3.0.1016 → 3.0.1018

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c42c1088414322e945958a47fa8a38e464a024cc
-  data.tar.gz: 68f677aafbd818667ff7819020ef21c74599b6cb
+  metadata.gz: c497446ed884be3c6761b1093a0167dd09cba97e
+  data.tar.gz: b71d6edb67e6b6bcfcd27e7a44316df9bc8002ea
 SHA512:
-  metadata.gz: a81088aa22b380942183d165402ae87a1e5cb35450fa9a3bcdc439b9199498f8e8bf5cc8677d64f82367dc614c3caf46eb4eecbac5b2660e6e2a5e44f9ca0609
-  data.tar.gz: 2fc32efe07d0cb15716db67c76acc93a5d476025e1b340865c7c2b4d0f3b7949b1152430a67bb39049ad21bab8c8263bf2a4044a3d620833b08e03c74931ca6c
+  metadata.gz: e5c33f0165fd1c7a2a64844b6b6ceb0b222a1631676bab46ec3e74c86bc9f76add73efe0e5f3e351200bdbffbd47ad5b39571ba0f5efd8343e911f552f6049c3
+  data.tar.gz: 58fba1c5320d14ba9e94072d62f5af71f779d0a7029273c79586c9b9e5ed00e0539897d7812aae4d2e3d93ed63a7c9f8dbc5638f0287b14937058071b932feff

data/lib/VERSION

@@ -1 +1 @@
-3.0.1016
+3.0.1018

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.1016
+  version: 3.0.1018
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-03-11 00:00:00.000000000 Z
+date: 2025-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common
@@ -33,9 +33,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- lib/tencentcloud-sdk-svp.rb
-- lib/v20240125/models.rb
 - lib/v20240125/client.rb
+- lib/v20240125/models.rb
+- lib/tencentcloud-sdk-svp.rb
 - lib/VERSION
 homepage: https://github.com/TencentCloud/tencentcloud-sdk-ruby
 licenses: