Detailed summary of costs by transaction type
Used by actions: DescribeBillSummaryByPayMode.
Name | Type | Description |
---|---|---|
ActionType | String | Transaction type code |
ActionTypeName | String | Transaction type, which can be monthly subscription purchase, monthly subscription renewal, or pay-as-you-go deduction. |
RealTotalCostRatio | String | Cost ratio, to two decimal points |
RealTotalCost | String | Total amount after discount |
CashPayAmount | String | Cash credit: The amount paid from the user’s cash account |
IncentivePayAmount | String | Free credit: The amount paid with the user’s free credit |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount |
TransferPayAmount | String | Commission credit: The amount paid with the user’s commission credit. Note: This field may return null, indicating that no valid values can be obtained. |
BillMonth | String | Billing month, e.g. 2019-08 |
TotalCost | String | The original cost in USD. This parameter has become valid since v3.0 bills took effect in May 2021, and before that - was returned for this parameter. If a customer uses a contract price different from the published price, - will also be returned for this parameter. |
This API is used to view UIN exception adjustment details.
Used by actions: DescribeBillAdjustInfo.
Name | Type | Required | Description |
---|---|---|---|
PayerUin | String | No | Payer UIN, namely the account ID of the payer. The account ID is the user's unique account identifier on Tencent Cloud. Note: This field may return null, indicating that no valid values can be obtained. Example value: 909619400. |
Month | String | No | Bill month. Format: yyyy-MM. Note: This field may return null, indicating that no valid value can be obtained. Example value: 2024-10. |
AdjustType | String | No | Adjustment type. Adjustment: manualAdjustment. Supplementary settlement: supplementarySettlement. Re-settlement: reSettlement. Note: This field may return null, indicating that no valid value can be obtained. Example value: manualAdjustment. |
AdjustNum | String | No | Adjustment order number. Note: This field may return null, indicating that no valid value can be obtained. Example value: 2220726096135. |
AdjustCompletionTime | String | No | Completion time of exception adjustment. Format: yyyy-MM-dd HH:mm:ss. Note: This field may return null, indicating that no valid value can be obtained. Example value: 2022-12-02 12:39:04. |
AdjustAmount | Float | No | Adjustment amount. Note: This field may return null, indicating that no valid value can be obtained. Example value: 333.00000000. |
Cost analysis transaction type complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Required | Description |
---|---|---|---|
ActionType | String | No | Transaction type codeNote: This field may return null, indicating that no valid values can be obtained. |
ActionTypeName | String | No | Transaction type nameNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis amount return data model
Used by actions: DescribeCostExplorerSummary.
Name | Type | Required | Description |
---|---|---|---|
Key | String | No | Fee typeNote: This field may return null, indicating that no valid values can be obtained. |
Display | Integer | No | Whether to displayNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis product return complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Description |
---|---|---|
BusinessCode | String | Product codeNote: This field may return null, indicating that no valid values can be obtained. |
BusinessCodeName | String | Product nameNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis filter box complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Description |
---|---|---|
Business | Array of AnalyseBusinessDetail | ProductNote: This field may return null, indicating that no valid values can be obtained. |
Project | Array of AnalyseProjectDetail | ItemNote: This field may return null, indicating that no valid values can be obtained. |
Region | Array of AnalyseRegionDetail | RegionNote: This field may return null, indicating that no valid values can be obtained. |
PayMode | Array of AnalysePayModeDetail | Billing modeNote: This field may return null, indicating that no valid values can be obtained. |
ActionType | Array of AnalyseActionTypeDetail | Transaction typeNote: This field may return null, indicating that no valid values can be obtained. |
Zone | Array of AnalyseZoneDetail | Availability zoneNote: This field may return null, indicating that no valid values can be obtained. |
OwnerUin | Array of AnalyseOwnerUinDetail | Resource owner UINNote: This field may return null, indicating that no valid values can be obtained. |
Amount | Array of AnalyseAmountDetail | Fee typeNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis query conditions
Used by actions: DescribeCostExplorerSummary.
Name | Type | Required | Description |
---|---|---|---|
BusinessCodes | String | No | Product name codeNote: This field may return null, indicating that no valid values can be obtained. |
ProductCodes | String | No | Sub-product name codeNote: This field may return null, indicating that no valid values can be obtained. |
ComponentCode | String | No | Component type codeNote: This field may return null, indicating that no valid values can be obtained. |
ZoneIds | String | No | Availability zone ID: The availability zone ID to which the resource belongsNote: This field may return null, indicating that no valid values can be obtained. |
RegionIds | String | No | Region ID: The region ID to which the resource belongsNote: This field may return null, indicating that no valid values can be obtained. |
ProjectIds | String | No | Project ID: The project ID to which the resource belongsNote: This field may return null, indicating that no valid values can be obtained. |
PayModes | String | No | Billing mode prePay (indicates monthly subscription)/postPay (indicates pay-as-you-go billing)Note: This field may return null, indicating that no valid values can be obtained. |
ActionTypes | String | No | Transaction type. Query transaction type. (Use transaction type code input parameter.)Note: This field may return null, indicating that no valid values can be obtained. |
Tags | String | No | Cost allocation tag keyNote: This field may return null, indicating that no valid values can be obtained. |
FeeType | String | No | Fee type. Query fee type. (Use fee type code input parameter.) The input parameter enumeration is as follows:cashPayAmount: cash incentivePayAmount: free credits voucherPayAmount: coupons tax:taxes costBeforeTax: price before taxNote: This field may return null, indicating that no valid values can be obtained. |
PayerUins | String | No | User UIN for querying cost analysis dataNote: This field may return null, indicating that no valid values can be obtained. |
OwnerUins | String | No | User UIN for using resourcesNote: This field may return null, indicating that no valid values can be obtained. |
ConsumptionTypes | String | No | Consumption type. Query consumption type. (Use consumption type code input parameter.)Note: This field may return null, indicating that no valid values can be obtained. |
Cost analysis data complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Description |
---|---|---|
Name | String | Time |
Total | String | Amount |
TimeDetail | Array of AnalyseTimeDetail | Date detailed amountNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis header data complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Description |
---|---|---|
HeadDetail | Array of AnalyseHeaderTimeDetail | Header dateNote: This field may return null, indicating that no valid values can be obtained. |
Name | String | TimeNote: This field may return null, indicating that no valid values can be obtained. |
Total | String | TotalNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis header data
Used by actions: DescribeCostExplorerSummary.
Name | Type | Required | Description |
---|---|---|---|
Name | String | No | DateNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis user UIN complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Required | Description |
---|---|---|---|
OwnerUin | String | No | User UIN Note: This field may return null, indicating that no valid values can be obtained. |
Cost analysis payment method complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Required | Description |
---|---|---|---|
PayMode | String | No | Billing mode codeNote: This field may return null, indicating that no valid values can be obtained. |
PayModeName | String | No | Billing mode nameNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis project return complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Required | Description |
---|---|---|---|
ProjectId | String | No | Project ID Note: This field may return null, indicating that no valid values can be obtained. |
ProjectName | String | No | Default projectNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis region return complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Required | Description |
---|---|---|---|
RegionId | String | No | Region ID Note: This field may return null, indicating that no valid values can be obtained. |
RegionName | String | No | Region nameNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis return value complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Description |
---|---|---|
Time | String | DateNote: This field may return null, indicating that no valid values can be obtained. |
Money | String | AmountNote: This field may return null, indicating that no valid values can be obtained. |
Cost analysis availability zone complex type
Used by actions: DescribeCostExplorerSummary.
Name | Type | Required | Description |
---|---|---|---|
ZoneId | String | No | Availability zone IDNote: This field may return null, indicating that no valid values can be obtained. |
ZoneName | String | No | Availability zone nameNote: This field may return null, indicating that no valid values can be obtained. |
The products that are applicable.
Used by actions: DescribeVoucherInfo.
Name | Type | Description |
---|---|---|
GoodsName | String | Valid values: all products or names of the applicable products (string). Multiple names are separated by commas. |
PayMode | String | Valid values: postPay : pay-as-you-go; prePay : prepaid; riPay : reserved instance; empty or * : all. If GoodsName contains multiple product names and PayMode is * , it indicates that the voucher can be used in all billing modes for each of the products. |
Bill details
Used by actions: DescribeBillDetail.
Name | Type | Description |
---|---|---|
BusinessCodeName | String | Product name: The name of a Tencent Cloud product purchased by the user, such as CVM. |
ProductCodeName | String | Subproduct name: The subcategory of a Tencent Cloud product purchased by the user, such as CVM – Standard S1. |
PayModeName | String | Billing mode, which can be monthly subscription or pay-as-you-go. |
ProjectName | String | Project name: The project to which a resource belongs, which is user-designated. If a resource has not been assigned to a project, it will automatically belong to the default project. |
RegionName | String | Region: The region to which a resource belongs, such as South China (Guangzhou). |
ZoneName | String | Availability zone: availability zone of a resource, e.g. Guangzhou Zone 3 |
ResourceId | String | Instance ID: The object ID of a billed resource, such as a CVM instance ID. This object ID may vary due to various forms and contents of resources in different products. |
ResourceName | String | Instance name: The resource name set by the user in the console. If it is not set, it will be empty by default. |
ActionTypeName | String | Transaction type, which can be monthly subscription purchase, monthly subscription renewal, or pay-as-you-go deduction. |
OrderId | String | Order ID: The order number for a monthly subscription purchase |
BillId | String | Transaction ID: The bill number for a deducted payment |
PayTime | Timestamp | Transaction time: The time at which a payment was deducted |
FeeBeginTime | Timestamp | Usage start time: The time at which product or service usage starts |
FeeEndTime | Timestamp | Usage end time: The time at which product or service usage ends |
ComponentSet | Array of BillDetailComponent | Component list |
PayerUin | String | Payer account ID: The account ID of the payer, which is the unique identifier of a Tencent Cloud user. |
OwnerUin | String | Owner account ID: The account ID of the actual resource user |
OperateUin | String | Operator account ID: The account or role ID of the operator who purchases or activates a resource |
Tags | Array of BillTagInfo | Tag information. Note: This field may return null, indicating that no valid values can be obtained. |
BusinessCode | String | Product code. Note: This field may return null, indicating that no valid values can be obtained. |
ProductCode | String | Subproduct code. Note: This field may return null, indicating that no valid values can be obtained. |
ActionType | String | Transaction type code. Note: This field may return null, indicating that no valid values can be obtained. |
RegionId | String | Region ID. Note: This field may return null, indicating that no valid values can be obtained. |
ProjectId | Integer | Project ID |
PriceInfo | Array of String | Price attribute: A set of attributes which will determine the price of a component, apart from unit price and usage duration. Note: This field may return null, indicating that no valid values can be obtained. |
AssociatedOrder | BillDetailAssociatedOrder | Associated transaction document ID: The ID of the document associated with a transaction, such as a write-off order, the original order showing a deduction error during first settlement, a restructured order, or the original purchase order corresponding to a refund order. Note: This field may return null, indicating that no valid values can be obtained. |
Formula | String | Calculation formula: The detailed calculation formula for a specific transaction type, such as refund or configuration change. Note: This field may return null, indicating that no valid values can be obtained. |
FormulaUrl | String | Billing rules: Official website links for detailed billing rules of each product. Note: This field may return null, indicating that no valid values can be obtained. |
BillDay | String | Billing dayNote: This field may return null, indicating that no valid values can be obtained. |
BillMonth | String | Billing monthNote: This field may return null, indicating that no valid values can be obtained. |
Id | String | Billing record IDNote: This field may return null, indicating that no valid values can be obtained. |
RegionType | String | Domestic and international codesNote: This field may return null, indicating that no valid values can be obtained. |
RegionTypeName | String | Domestic and International: The region type to which the resource belongs (domestic, international)Note: This field may return null, indicating that no valid values can be obtained. |
ReserveDetail | String | Note attributes (instance configuration): Other note information, such as the reserved instance, the reserved instance type, the transaction type, and the region information on both ends of the CCN product.Note: This field may return null, indicating that no valid values can be obtained. |
Information of the document associated with bill details
Used by actions: DescribeBillDetail, DescribeBillDetailForOrganization.
Name | Type | Description |
---|---|---|
PrepayPurchase | String | Purchase order. Note: This field may return null, indicating that no valid values can be obtained. |
PrepayRenew | String | Renewal order. Note: This field may return null, indicating that no valid values can be obtained. |
PrepayModifyUp | String | Upgrade order. Note: This field may return null, indicating that no valid values can be obtained. |
ReverseOrder | String | Write-off order. Note: This field may return null, indicating that no valid values can be obtained. |
NewOrder | String | The order after discount. Note: This field may return null, indicating that no valid values can be obtained. |
Original | String | The original order before discount. Note: This field may return null, indicating that no valid values can be obtained. |
Information about components charged in the bill
Used by actions: DescribeBillDetail, DescribeBillDetailForOrganization.
Name | Type | Description |
---|---|---|
ComponentCodeName | String | Component type: The component type of a product or service purchased, such as CVM instance components including CPU and memory. |
ItemCodeName | String | Component name: The specific component of a product or service purchased |
SinglePrice | String | Component list price: The listed unit price of a component. If a customer has applied for a fixed preferential price or contract price, this parameter will not be displayed by default. |
PriceUnit | String | Component price measurement unit: The unit of measurement for a component price, which is composed of USD, usage unit, and duration unit. |
UsedAmount | String | Component usage: The actually settled usage of a component, which is "Raw usage - Deducted usage (including packages)". |
UsedAmountUnit | String | Component usage unit: The unit of measurement for component usage |
RealTotalMeasure | String | Raw usage/duration: The raw usage/duration of a component before deduction. Note: This field may return null, indicating that no valid values can be obtained. |
DeductedMeasure | String | Deducted usage/duration (including packages): The usage/duration deducted with a package. Note: This field may return null, indicating that no valid values can be obtained. |
TimeSpan | String | Usage duration: The resource usage duration |
TimeUnitName | String | Duration unit: The unit of measurement for usage duration |
Cost | String | Original cost: The original cost of a resource, which is "List price x Usage x Usage duration". If a customer has applied for a fixed preferential price or contract price or is in a refund scenario, this parameter will not be displayed by default. |
Discount | String | Discount multiplier: The discount multiplier applied to the cost of the resource. If a customer has applied for a fixed preferential price or contract price or is in a refund scenario, this parameter will not be displayed by default. |
ReduceType | String | Offer type |
RealCost | String | Total amount after discount: Total amount after discount = (Original cost - RI deduction (cost) - SP deduction (cost)) x Discount multiplier |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount |
CashPayAmount | String | Cash credit: The amount paid from the user's cash account |
IncentivePayAmount | String | Free credit: The amount paid with the user's free credit |
TransferPayAmount | String | Commission credit: The amount paid with the user's commission credit. Note: This field may return null, indicating that no valid values can be obtained. |
ItemCode | String | Component type code. Note: This field may return null, indicating that no valid values can be obtained. |
ComponentCode | String | Component name code. Note: This field may return null, indicating that no valid values can be obtained. |
ContractPrice | String | Component contracted price: The contracted unit price of a component, which is "List price x Discount". Note: This field may return null, indicating that no valid values can be obtained. |
InstanceType | String | Instance type: The instance type of a product or service purchased, which can be resource package, RI, SP, or spot instance. Other instance types are not displayed by default. Note: This field may return null, indicating that no valid values can be obtained. |
RiTimeSpan | String | RI deduction (duration): The usage duration deducted by RI. Note: This field may return null, indicating that no valid values can be obtained. |
OriginalCostWithRI | String | RI deduction (cost): The amount deducted from the original cost by RI. Note: This field may return null, indicating that no valid values can be obtained. |
SPDeductionRate | String | Savings plan deduction rate: The discount multiplier that applies to the component based on the remaining commitment of the savings plan. Note: This field may return null, indicating that no valid values can be obtained. |
OriginalCostWithSP | String | SP deduction (cost): SP deduction (cost) = Cost deduction by SP / SP deduction rate. Note: This field may return null, indicating that no valid values can be obtained. |
BlendedDiscount | String | Blended discount multiplier: The final discount multiplier that is applied after combining multiple discount types, which is "Total amount after discount / Original cost". Note: This field may return null, indicating that no valid values can be obtained. |
ComponentConfig | Array of BillDetailComponentConfig | Configuration description: The specification configuration of an instance. Note: This field may return null, indicating that no valid values can be obtained. |
TaxRate | String | The tax rate. |
TaxAmount | String | The tax amount. |
Currency | String | The currency used for the settlement of a component. |
Bill details configuration descriptions
Used by actions: DescribeBillDetail, DescribeBillDetailForOrganization.
Name | Type | Description |
---|---|---|
Name | String | Configuration description name Note: This field may return null, indicating that no valid values can be obtained. |
Value | String | Configuration description value Note: This field may return null, indicating that no valid values can be obtained. |
Summary objects for a reseller bill
Used by actions: DescribeBillResourceSummaryForOrganization.
Name | Type | Description |
---|---|---|
BusinessCodeName | String | Product name: The name of a Tencent Cloud product purchased by the user, such as CVM. |
ProductCodeName | String | Subproduct name: The subcategory of a Tencent Cloud product purchased by the user, such as CVM - Standard S1. |
PayModeName | String | Billing mode: The billing mode, which can be monthly subscription or pay-as-you-go. |
ProjectName | String | Project Name: The project to which a resource belongs, which is user-designated. If a resource has not been assigned to a project, it will automatically belong to the default project. |
RegionName | String | Region: The region of a resource, e.g. South China (Guangzhou). |
ZoneName | String | Availability zone: The availability zone of a resource, e.g. Guangzhou Zone 3. |
ResourceId | String | Instance ID: The object ID of a billed resource, such as a CVM instance ID. This object ID may vary due to various forms and contents of resources in different products. |
ResourceName | String | Instance name: The resource name set by the user in the console. If it is not set, it will be empty by default. |
ActionTypeName | String | Transaction type, which can be monthly subscription purchase, monthly subscription renewal, pay-as-you-go deduction, etc. |
OrderId | String | Order ID: The ID of a monthly subscription order. |
PayTime | Timestamp | Deduction time: The settlement cost deduction time. |
FeeBeginTime | Timestamp | Usage start time: The time at which product or service usage starts. |
FeeEndTime | Timestamp | Usage end time: The time at which product or service usage ends. |
ConfigDesc | String | Configuration description: The billable item names and usage of a resource, which are displayed on the resource bill only. |
ExtendField1 | String | Extended Field 1: The extended attribute information of a product, which is displayed on the resource bill only. |
ExtendField2 | String | Extended field 2: The extended attribute information of a product, which is displayed on the resource bill only. |
TotalCost | String | Original cost. The original cost of a component = Component price x Usage x Usage duration. If a customer has applied for a fixed preferential price or contract price or if a customer is in a refund scenario, this parameter will not be displayed by default. |
Discount | String | Discount multiplier: The discount multiplier that applies to the component. If a customer has applied for a fixed preferential price or contract price or if a customer is in a refund scenario, this parameter will not be displayed by default. |
ReduceType | String | Offer type. |
RealTotalCost | String | Total amount after discount. |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount. |
CashPayAmount | String | Cash credit payment: The amount paid through the user's cash account. |
IncentivePayAmount | String | Free credit payment: The amount paid with the user's free credit. |
TransferPayAmount | String | Commission credit payment: The amount paid with the user's commission credit. Note: This field may return null, indicating that no valid values can be obtained. |
ExtendField3 | String | Extended field 3: The extended attribute information of a product, which is displayed on the resource bill only. |
ExtendField4 | String | Extended field 4: The extended attribute information of a product, which is displayed on the resource bill only. |
ExtendField5 | String | Extended field 5: The extended attribute information of a product, which is displayed on the resource bill only. |
Tags | Array of BillTagInfo | Tag information. Note: This field may return null, indicating that no valid values can be obtained. |
OwnerUin | String | Owner account ID: The account ID of the actual resource user. |
OperateUin | String | Operator account ID: The account or role ID of the operator who purchases or activates a resource. |
BusinessCode | String | Product code. |
ProductCode | String | Subproduct code. |
RegionId | Integer | Region ID. |
InstanceType | String | Instance type: The instance type of a product or service purchased, which can be resource package, RI, SP, or spot instance. Other instance types are not displayed by default. |
OriginalCostWithRI | String | RI deduction (cost): The amount deducted from the original cost by RI. |
OriginalCostWithSP | String | SP deduction (cost): The amount of cost deducted by a savings plan based on the component's original cost. SP deduction (cost) = Cost deduction by SP / SP deduction rate |
BillMonth | String | Billing monthNote: This field may return null, indicating that no valid values can be obtained. |
Information about resources charged in the bill
Used by actions: DescribeBillResourceSummary.
Name | Type | Description |
---|---|---|
BusinessCodeName | String | Product name: The name of a Tencent Cloud product purchased by the user, such as CVM. |
ProductCodeName | String | Subproduct name: The subcategory of a Tencent Cloud product purchased by the user, such as CVM Computing C5t. |
PayModeName | String | Billing mode, which can be monthly subscription or pay-as-you-go. |
ProjectName | String | Project name: The project to which a resource belongs, which is user-designated. If a resource has not been assigned to a project, it will automatically belong to the default project. |
RegionName | String | Region: The region to which a resource belongs, such as South China (Guangzhou). |
ZoneName | String | Availability zone: The availability zone to which a resource belongs, such as Guangzhou Zone 3. |
ResourceId | String | Instance ID: The object ID of a billed resource, such as a CVM instance ID. This object ID may vary due to various forms and contents of resources in different products. |
ResourceName | String | Instance name: The resource name set by the user in the console. If it is not set, it will be empty by default. |
ActionTypeName | String | Transaction type, which can be monthly subscription purchase, monthly subscription renewal, or pay-as-you-go deduction. |
OrderId | String | Order ID: The order number for a monthly subscription purchase |
PayTime | Timestamp | Transaction time: The time at which a payment was deducted |
FeeBeginTime | Timestamp | Usage start time: The time at which product or service usage starts |
FeeEndTime | Timestamp | Usage end time: The time at which product or service usage ends |
ConfigDesc | String | Configuration description: The billable item names and usage of a resource, which are displayed on the resource bill only. |
ExtendField1 | String | Extended field 1: Extended attribute information of a product, which is displayed on the resource bill only. |
ExtendField2 | String | Extended field 2: Extended attribute information of a product, which is displayed on the resource bill only. |
TotalCost | String | Original cost: The original cost of a resource, which is "List price x Usage x Usage duration". If a customer has applied for a fixed preferential price or contract price or applied for a refund, this parameter will not be displayed by default. |
Discount | String | Discount multiplier: The discount multiplier applied to the cost of the resource. If a customer has applied for a fixed preferential price or contract price or applied for a refund, this parameter will not be displayed by default. |
ReduceType | String | Offer type |
RealTotalCost | String | Total amount after discount (Including Tax): = Total Amount After Discount (Excluding Tax) + TaxAmount |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount |
CashPayAmount | String | Cash credit: The amount paid from the user's cash account |
IncentivePayAmount | String | Free credit: The amount paid with the user's free credit |
TransferPayAmount | String | Commission credit: The amount paid with the user's commission credit. Note: This field may return null, indicating that no valid values can be obtained. |
ExtendField3 | String | Extended field 3: Extended attribute information of a product, which is displayed on the resource bill only. |
ExtendField4 | String | Extended field 4: Extended attribute information of a product, which is displayed on the resource bill only. |
ExtendField5 | String | Extended field 5: Extended attribute information of a product, which is displayed on the resource bill only. |
Tags | Array of BillTagInfo | Tag information. Note: This field may return null, indicating that no valid values can be obtained. |
PayerUin | String | Payer account ID: The account ID of the payer, which is the unique identifier of a Tencent Cloud user. |
OwnerUin | String | Owner account ID: The account ID of the actual resource user |
OperateUin | String | Operator account ID: The account or role ID of the operator who purchases or activates a resource. |
BusinessCode | String | Product code |
ProductCode | String | Subproduct code |
RegionId | Integer | Region ID |
InstanceType | String | Instance type: The instance type of a product or service purchased, which can be resource package, RI, SP, or spot instance. Other instance types are not displayed by default. |
OriginalCostWithRI | String | RI deduction (cost): The amount deducted from the original cost by RI |
OriginalCostWithSP | String | SP deduction (cost): SP deduction (cost) = Cost deduction by SP / SP deduction rate |
BillMonth | String | Billing monthNote: This field may return null, indicating that no valid values can be obtained. |
Bill tag information.
Used by actions: DescribeBillDetail, DescribeBillDetailForOrganization, DescribeBillResourceSummary, DescribeBillResourceSummaryForOrganization.
Name | Type | Description |
---|---|---|
TagKey | String | Cost allocation tag key |
TagValue | String | Tag value |
Detailed summary of products
Used by actions: DescribeBillSummary, DescribeBillSummaryForOrganization.
Name | Type | Description |
---|---|---|
BusinessCode | String | Product code |
BusinessCodeName | String | Product name: The name of a Tencent Cloud product purchased by the user, such as CVM. |
TotalCost | String | Original cost in USD. This parameter became valid when Bill 3.0 took effect in May 2021. Before that, - was returned for this parameter. If a customer has applied for a contract price different from the prices listed on the official website, - will also be returned for this parameter. Note: This field may return null, indicating that no valid values can be obtained. |
RealTotalCost | String | Total amount after discount |
CashPayAmount | String | Cash credit: The amount paid from the user’s cash account |
IncentivePayAmount | String | Free credit: The amount paid with the user’s free credit |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount |
TransferPayAmount | String | Commission credit: The amount paid with the user’s commission credit. Note: This field may return null, indicating that no valid values can be obtained. |
Summarize product details by product
Used by actions: DescribeBillSummaryByProduct.
Name | Type | Description |
---|---|---|
BusinessCode | String | Product code. Note: This field may return null, indicating that no valid values can be obtained. |
BusinessCodeName | String | Product name: The name of a Tencent Cloud product purchased by the user, such as CVM. |
RealTotalCostRatio | String | Cost ratio, to two decimal points |
RealTotalCost | String | Total amount after discount |
CashPayAmount | String | Cash credit: The amount paid from the user’s cash account |
IncentivePayAmount | String | Free credit: The amount paid with the user’s free credit |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount |
TransferPayAmount | String | Commission credit: The amount paid with the user’s commission credit. |
BillMonth | String | Billing month, e.g. 2019-08 |
TotalCost | String | The original cost in USD. This parameter has become valid since v3.0 bills took effect in May 2021, and before that - was returned for this parameter. If a customer uses a contract price different from the published price, - will also be returned for this parameter. |
Summarize total cost by product
Used by actions: DescribeBillSummaryByProduct.
Name | Type | Description |
---|---|---|
RealTotalCost | String | Total amount after discount |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount |
IncentivePayAmount | String | Free credit: The amount paid with the user’s free credit |
CashPayAmount | String | Cash credit: The amount paid from the user’s cash account |
TransferPayAmount | String | Commission credit: The amount paid with the user’s commission credit. |
TotalCost | String | The original cost in USD. This parameter has become valid since v3.0 bills took effect in May 2021, and before that - was returned for this parameter. If a customer uses a contract price different from the published price, - will also be returned for this parameter. |
Product filter criteria
Used by actions: DescribeCostSummaryByResource.
Name | Type | Description |
---|---|---|
BusinessCode | String | Product name code |
BusinessCodeName | String | Product name |
Payment mode filter criteria
Used by actions: DescribeCostSummaryByResource.
Name | Type | Description |
---|---|---|
PayMode | String | Payment mode |
PayModeName | String | Payment mode name |
Project filter criteria
Used by actions: DescribeCostSummaryByResource.
Name | Type | Description |
---|---|---|
ProjectId | String | Project ID |
ProjectName | String | Project name |
Regional filter criteria
Used by actions: DescribeCostSummaryByResource.
Name | Type | Description |
---|---|---|
RegionId | String | Region ID |
RegionName | String | Region name |
Billing filter criteria object
Used by actions: DescribeCostSummaryByResource.
Name | Type | Required | Description |
---|---|---|---|
TimeRange | Integer | No | Only supports two values: 6 and 12. |
BusinessCode | String | No | Product name code |
ProjectId | Integer | No | Project ID |
RegionId | Integer | No | Region ID |
PayMode | String | No | Payment mode. Options include prePay and postPay. |
ResourceKeyword | String | No | Resource keyword |
BusinessCodes | Array of String | No | Product name code |
ProductCodes | Array of String | No | Subproduct name code |
RegionIds | Array of Integer | No | Region ID |
ProjectIds | Array of Integer | No | Project ID |
PayModes | Array of String | No | Payment mode. Options include prePay and postPay. |
ActionTypes | Array of String | No | Transaction type |
HideFreeCost | Integer | No | Whether to hide zero-amount transactions |
OrderByCost | String | No | Sorting rule. Options include desc and asc. |
BillIds | Array of String | No | Transaction ID |
ComponentCodes | Array of String | No | Component code |
FileIds | Array of String | No | File ID |
FileTypes | Array of String | No | File type |
Status | Array of Integer | No | Status |
Consumption details summarized by product
Used by actions: DescribeCostSummaryByProduct, DescribeCostSummaryByProject, DescribeCostSummaryByRegion.
Name | Type | Description |
---|---|---|
BusinessCode | String | Product name code |
BusinessCodeName | String | Product name |
RealTotalCost | String | Discounted total price |
Trend | ConsumptionSummaryTrend | Cost trend |
CashPayAmount | String | Cash Note: This field may return null, indicating that no valid values can be obtained. |
IncentivePayAmount | String | Bonus Note: This field may return null, indicating that no valid values can be obtained. |
VoucherPayAmount | String | VoucherNote: This field may return null, indicating that no valid values can be obtained. |
TransferPayAmount | String | Share revenueNote: This field may return null, indicating that no valid values can be obtained. |
RegionName | String | Region name (only shown in regional summary) Note: This field may return null, indicating that no valid values can be obtained. |
Consumption details summarized by project
Used by actions: DescribeCostSummaryByProject.
Name | Type | Description |
---|---|---|
ProjectId | String | Project ID |
ProjectName | String | Project name |
RealTotalCost | String | Discounted total price |
Trend | ConsumptionSummaryTrend | Trend |
Business | Array of ConsumptionBusinessSummaryDataItem | Product consumption details |
CashPayAmount | String | Cash Note: This field may return null, indicating that no valid values can be obtained. |
IncentivePayAmount | String | Bonus Note: This field may return null, indicating that no valid values can be obtained. |
VoucherPayAmount | String | VoucherNote: This field may return null, indicating that no valid values can be obtained. |
TransferPayAmount | String | Share revenueNote: This field may return null, indicating that no valid values can be obtained. |
Consumption details summarized by region
Used by actions: DescribeCostSummaryByRegion.
Name | Type | Description |
---|---|---|
RegionId | String | Region ID |
RegionName | String | Region name |
RealTotalCost | String | Discounted total price |
Trend | ConsumptionSummaryTrend | Trend |
Business | Array of ConsumptionBusinessSummaryDataItem | Product consumption details |
CashPayAmount | String | Cash Note: This field may return null, indicating that no valid values can be obtained. |
VoucherPayAmount | String | VoucherNote: This field may return null, indicating that no valid values can be obtained. |
IncentivePayAmount | String | Bonus Note: This field may return null, indicating that no valid values can be obtained. |
TransferPayAmount | String | Share revenueNote: This field may return null, indicating that no valid values can be obtained. |
Filter criteria of consumption details summarized by resource
Used by actions: DescribeCostSummaryByResource.
Name | Type | Description |
---|---|---|
Business | Array of ConditionBusiness | Product list |
Project | Array of ConditionProject | Project list |
Region | Array of ConditionRegion | Region list |
PayMode | Array of ConditionPayMode | Payment mode list |
Consumption details summarized by resource
Used by actions: DescribeCostSummaryByResource.
Name | Type | Description |
---|---|---|
ResourceId | String | Resource ID |
ResourceName | String | Resource name |
RealTotalCost | String | Discounted total price |
CashPayAmount | String | Cash expenditure |
ProjectId | String | Project ID |
ProjectName | String | Project name |
RegionId | String | Region ID |
RegionName | String | Region name |
PayMode | String | Payment mode |
PayModeName | String | Payment mode name |
BusinessCode | String | Product name code |
BusinessCodeName | String | Product name |
ConsumptionTypeName | String | Consumption type |
RealCost | String | Pre-discount priceNote: This field may return null, indicating that no valid values can be obtained. |
FeeBeginTime | String | Start time of feesNote: This field may return null, indicating that no valid values can be obtained. |
FeeEndTime | String | End time of feesNote: This field may return null, indicating that no valid values can be obtained. |
DayDiff | String | Days Note: This field may return null, indicating that no valid values can be obtained. |
DailyTotalCost | String | Daily consumptionNote: This field may return null, indicating that no valid values can be obtained. |
OrderId | String | Order numberNote: This field may return null, indicating that no valid values can be obtained. |
VoucherPayAmount | String | VoucherNote: This field may return null, indicating that no valid values can be obtained. |
IncentivePayAmount | String | Bonus Note: This field may return null, indicating that no valid values can be obtained. |
TransferPayAmount | String | Share revenueNote: This field may return null, indicating that no valid values can be obtained. |
PayerUin | String | Payer UIN: the account ID of the payer, which is the unique identifier of a Tencent Cloud userNote: This field may return null, indicating that no valid values can be obtained. |
OwnerUin | String | User UIN: the account ID of the actual resource userNote: This field may return null, indicating that no valid values can be obtained. |
OperateUin | String | Operator UIN: the account ID or role ID of the operator who places orders for prepaid resources or activates postpaid resourcesNote: This field may return null, indicating that no valid values can be obtained. |
ProductCode | String | Subproduct codeNote: This field may return null, indicating that no valid values can be obtained. |
ProductCodeName | String | Subproduct name: the subcategory of a product purchased by the user, such as CVM – Standard S1Note: This field may return null, indicating that no valid values can be obtained. |
RegionType | String | Region typeNote: This field may return null, indicating that no valid values can be obtained. |
RegionTypeName | String | Region type nameNote: This field may return null, indicating that no valid values can be obtained. |
Extend1 | String | Extended field 1Note: This field may return null, indicating that no valid values can be obtained. |
Extend2 | String | Extended field 2Note: This field may return null, indicating that no valid values can be obtained. |
Extend3 | String | Extended field 3Note: This field may return null, indicating that no valid values can be obtained. |
Extend4 | String | Extended field 4Note: This field may return null, indicating that no valid values can be obtained. |
Extend5 | String | Extended field 5Note: This field may return null, indicating that no valid values can be obtained. |
InstanceType | String | Instance typeNote: This field may return null, indicating that no valid values can be obtained. |
InstanceTypeName | String | Instance type nameNote: This field may return null, indicating that no valid values can be obtained. |
PayTime | String | Deduction time: the time at which a payment is deductedNote: This field may return null, indicating that no valid values can be obtained. |
ZoneName | String | Availability zone: availability zone of a resource, e.g. Guangzhou Zone 3Note: This field may return null, indicating that no valid values can be obtained. |
ComponentConfig | String | Configuration descriptionNote: This field may return null, indicating that no valid values can be obtained. |
Tags | String | Tag information.Note: This field may return null, indicating that no valid values can be obtained. |
Consumption summary details
Used by actions: DescribeCostSummaryByProduct, DescribeCostSummaryByProject, DescribeCostSummaryByRegion, DescribeCostSummaryByResource.
Name | Type | Description |
---|---|---|
RealTotalCost | String | Discounted total price |
Consumption cost trend
Used by actions: DescribeCostSummaryByProduct, DescribeCostSummaryByProject, DescribeCostSummaryByRegion.
Name | Type | Description |
---|---|---|
Type | String | Trend type, upward for rising, downward for falling, none for no change |
Value | String | Trend value. The value is null when Type is none.Note: This field may return null, indicating that no valid values can be obtained. |
Information about the data structure of the returned COS usage details
Used by actions: DescribeDosageCosDetailByDate.
Name | Type | Description |
---|---|---|
BucketName | String | Bucket name |
DosageBeginTime | String | The start time of the usage |
DosageEndTime | String | The end time of the usage |
SubProductCodeName | String | Subproduct name |
BillingItemCodeName | String | Billable item name |
DosageValue | String | Usage |
Unit | String | Unit of the billable item |
Consumption component details
Used by actions: DescribeCostDetail.
Name | Type | Description |
---|---|---|
ComponentCodeName | String | Component type name |
ItemCodeName | String | Component name |
SinglePrice | String | List price |
PriceUnit | String | List price unit |
UsedAmount | String | Usage |
UsedAmountUnit | String | Usage unit |
Cost | String | Original price |
Discount | String | Discount |
RealCost | String | Discounted price |
VoucherPayAmount | String | Voucher payment amount |
CashPayAmount | String | Cash payment amount |
IncentivePayAmount | String | Bonus payment amount |
Consumption details data type
Used by actions: DescribeCostDetail.
Name | Type | Description |
---|---|---|
PayerUin | String | Payer UIN |
BusinessCodeName | String | Product name |
ProductCodeName | String | Subproduct name |
PayModeName | String | Billing mode name |
ProjectName | String | Project name |
RegionName | String | Region Name |
ZoneName | String | Zone name |
ResourceId | String | Resource ID |
ResourceName | String | Resource name |
ActionTypeName | String | Type nameNote: This field may return null, indicating that no valid values can be obtained. |
OrderId | String | Order ID |
BillId | String | Transaction ID |
FeeBeginTime | String | Start time of fees |
FeeEndTime | String | End time of fees |
ComponentSet | Array of CostComponentSet | Component details |
ProductCode | String | Subproduct name code |
Objects of reseller bill details
Used by actions: DescribeBillDetailForOrganization.
Name | Type | Description |
---|---|---|
BusinessCodeName | String | Product name: The name of a Tencent Cloud product purchased by the user, such as CVM. |
ProductCodeName | String | Subproduct name: The subcategory of a Tencent Cloud product purchased by the user, such as CVM - Standard S1. |
PayModeName | String | Billing mode: The billing mode, which can be monthly subscription or pay-as-you-go. |
ProjectName | String | Project Name: The project to which a resource belongs, which is user-designated. If a resource has not been assigned to a project, it will automatically belong to the default project. |
RegionName | String | Region: The region of a resource, e.g. South China (Guangzhou). |
ZoneName | String | Availability zone: availability zone of a resource, e.g. Guangzhou Zone 3. |
ResourceId | String | Instance ID: The object ID of a billed resource, such as a CVM instance ID. This object ID may vary due to various forms and contents of resources in different products. |
ResourceName | String | Instance name: The resource name set by the user in the console. If it is not set, it will be empty by default. |
ActionTypeName | String | Transaction type, which can be monthly subscription purchase, monthly subscription renewal, pay-as-you-go deduction, etc. |
OrderId | String | Order ID: The ID of a monthly subscription order. |
BillId | String | Transaction ID: The ID of a settlement bill. |
PayTime | Timestamp | Deduction time: The settlement cost deduction time. |
FeeBeginTime | Timestamp | Usage start time: The time at which product or service usage starts. |
FeeEndTime | Timestamp | Usage end time: The time at which product or service usage ends. |
ComponentSet | Array of BillDetailComponent | List of components. |
OwnerUin | String | Owner account ID: The account ID of the actual resource user. |
OperateUin | String | Operator account ID: The account or role ID of the operator who purchases or activates a resource. |
Tags | Array of BillTagInfo | Tag information. Note: This field may return null, indicating that no valid values can be obtained. |
BusinessCode | String | Product code. Note: This field may return null, indicating that no valid values can be obtained. |
ProductCode | String | Subproduct code. Note: This field may return null, indicating that no valid values can be obtained. |
ActionType | String | Transaction type code. Note: This field may return null, indicating that no valid values can be obtained. |
RegionId | String | Region ID. Note: This field may return null, indicating that no valid values can be obtained. |
ProjectId | Integer | Project ID. |
PriceInfo | Array of String | Price attribute: A set of attributes which will determine the price of a component, apart from unit price and usage duration. Note: This field may return null, indicating that no valid values can be obtained. |
AssociatedOrder | BillDetailAssociatedOrder | Associated transaction document ID: The ID of the document associated with a transaction, such as a write-off order, the original order showing a deduction error during first settlement, a restructured order, or the original purchase order corresponding to a refund order. Note: This field may return null, indicating that no valid values can be obtained. |
Formula | String | Calculation formula: The detailed calculation formula for a specific transaction type, such as refund or configuration change. Note: This field may return null, indicating that no valid values can be obtained. |
FormulaUrl | String | Billing rules: Official website links for detailed billing rules of each product. Note: This field may return null, indicating that no valid values can be obtained. |
BillMonth | String | Billing monthNote: This field may return null, indicating that no valid values can be obtained. |
BillDay | String | Billing dayNote: This field may return null, indicating that no valid values can be obtained. |
The products that are not applicable.
Used by actions: DescribeVoucherInfo.
Name | Type | Description |
---|---|---|
GoodsName | String | The names of non-applicable products. |
PayMode | String | postPay : pay-as-you-go; prePay : prepaid; riPay : reserved instance; empty or * : all. |
Detailed summary of costs by billing mode
Used by actions: DescribeBillSummaryByPayMode.
Name | Type | Description |
---|---|---|
PayMode | String | Billing mode code |
PayModeName | String | Billing mode, which can be monthly subscription or pay-as-you-go. |
RealTotalCostRatio | String | Cost ratio, to two decimal points |
RealTotalCost | String | Total amount after discount |
CashPayAmount | String | Cash credit: The amount paid from the user’s cash balance |
IncentivePayAmount | String | Free credit: The amount paid with the user’s free credit |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount |
TransferPayAmount | String | Commission credit: The amount paid with the user’s commission credit. |
TotalCost | String | The original cost in USD. This parameter has become valid since v3.0 bills took effect in May 2021, and before that - was returned for this parameter. If a customer uses a contract price different from the published price, - will also be returned for this parameter. |
Detail | Array of ActionSummaryOverviewItem | Detailed summary of costs by transaction type |
Detailed summary of purchases by project
Used by actions: DescribeBillSummaryByProject.
Name | Type | Description |
---|---|---|
ProjectId | String | Project ID |
ProjectName | String | Project name: The project to which a resource belongs, which is user-designated. If a resource has not been assigned to a project, it will automatically belong to the default project. |
RealTotalCostRatio | String | Cost ratio, to two decimal points |
RealTotalCost | String | Total amount after discount |
CashPayAmount | String | Cash credit: The amount paid from the user’s cash account |
IncentivePayAmount | String | Free credit: The amount paid with the user’s free credit |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount |
TransferPayAmount | String | Commission credit: The amount paid with the user’s commission credit. |
BillMonth | String | Billing month, e.g. 2019-08 |
TotalCost | String | The original cost in USD. This parameter has become valid since v3.0 bills took effect in May 2021, and before that - was returned for this parameter. If a customer uses a contract price different from the published price, - will also be returned for this parameter. |
Detailed summary of purchases by region
Used by actions: DescribeBillSummaryByRegion.
Name | Type | Description |
---|---|---|
RegionId | String | Region ID Note: This field may return null, indicating that no valid value was found. |
RegionName | String | Region: The region to which a resource belongs, such as South China (Guangzhou). |
RealTotalCostRatio | String | Cost ratio, to two decimal points |
RealTotalCost | String | Total amount after discount |
CashPayAmount | String | Cash credit: The amount paid from the user’s cash account |
IncentivePayAmount | String | Free credit: The amount paid with the user’s free credit |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount |
TransferPayAmount | String | Commission credit: The amount paid with the user’s commission credit. |
BillMonth | String | Billing month, e.g. 2019-08 |
TotalCost | String | The original cost in USD. This parameter has become valid since v3.0 bills took effect in May 2021, and before that - was returned for this parameter. If a customer uses a contract price different from the published price, - will also be returned for this parameter. |
Detailed summary of costs by multiple dimensions
Used by actions: DescribeBillSummary, DescribeBillSummaryForOrganization.
Name | Type | Description |
---|---|---|
GroupKey | String | Bill dimension code. Note: This field may return null, indicating that no valid values can be obtained. |
GroupValue | String | Bill dimension value. Note: This field may return null, indicating that no valid values can be obtained. |
TotalCost | String | Original cost in USD. This parameter has become valid since Bill 3.0 took effect in May 2021, and before that - was returned for this parameter. If a customer has applied for a contract price different from the prices listed on the official website, - will also be returned for this parameter. |
RealTotalCost | String | Total amount after discount |
CashPayAmount | String | Cash credit: The amount paid from the user’s cash account |
IncentivePayAmount | String | Free credit: The amount paid with the user’s free credit |
VoucherPayAmount | String | Voucher payment: The voucher deduction amount |
TransferPayAmount | String | Commission credit: The amount paid with the user’s commission credit. Note: This field may return null, indicating that no valid values can be obtained. |
Business | Array of BusinessSummaryInfo | Detailed summary of products. Note: This field may return null, indicating that no valid values can be obtained. |
Total cost
Used by actions: DescribeBillSummaryByTag.
Name | Type | Description |
---|---|---|
RealTotalCost | String | Total amount after discount. Note: This field may return null, indicating that no valid values can be obtained. |
TotalCost | String | The original cost in USD. This parameter has become valid since v3.0 bills took effect in May 2021, and before that - was returned for this parameter. If a customer uses a contract price different from the published price, - will also be returned for this parameter.Note: this field may return null , indicating that no valid values can be obtained. |
Tag information.
Used by actions: DescribeTagList.
Name | Type | Description |
---|---|---|
TagKey | String | Cost allocation tag key. |
Status | Integer | Tag type. Valid values: 0 (general tags), 1 (cost allocation tags). |
UpdateTime | String | Time to set the cost allocation tag. It will not be returned if Status is 0 .Note: This field may return null, indicating that no valid values can be obtained. |
Details about cost distribution over different tags.
Used by actions: DescribeBillSummaryByTag.
Name | Type | Description |
---|---|---|
TagValue | String | Tag value Note: This field may return null, indicating that no valid values can be obtained. |
RealTotalCostRatio | String | Cost percentage rounded to two decimal places Note: This field may return null, indicating that no valid values can be obtained. |
RealTotalCost | String | Total amount after discount. Note: This field may return null, indicating that no valid values can be obtained. |
CashPayAmount | String | Cash credit: The amount paid from the user’s cash account. Note: This field may return null, indicating that no valid values can be obtained. |
IncentivePayAmount | String | Free credit: The amount paid with the user’s free credit. Note: This field may return null, indicating that no valid values can be obtained. |
VoucherPayAmount | String | Voucher payment: The amount deducted by using vouchers. Note: This field may return null, indicating that no valid values can be obtained. |
TransferPayAmount | String | Commission credit: The amount paid with the user’s commission credit. Note: This field may return null, indicating that no valid values can be obtained. |
TotalCost | String | The original cost in USD. This parameter has become valid since v3.0 bills took effect in May 2021, and before that - was returned for this parameter. If a customer uses a contract price different from the published price, - will also be returned for this parameter.Note: this field may return null , indicating that no valid values can be obtained. |
The product purchased.
Used by actions: DescribeVoucherUsageDetails.
Name | Type | Description |
---|---|---|
ProductName | String | The name of the product. Note: This field may return null , indicating that no valid value was found. |
SubProductName | String |
The usage records.
Used by actions: DescribeVoucherUsageDetails.
Name | Type | Description |
---|---|---|
UsedAmount | Integer | The amount used. The value of this parameter is the amount used (USD, rounded to 8 decimal places) multiplied by 100,000,000. |
UsedTime | String | The time when the voucher was used. |
UsageDetails | Array of UsageDetails | The details of the product purchased. Note: This field may return null , indicating that no valid value was found. |
Voucher information.
Used by actions: DescribeVoucherInfo.
Name | Type | Description |
---|---|---|
OwnerUin | String | The owner of the voucher. |
Status | String | The status of the voucher: unUsed , used , delivered , cancel , overdue |
NominalValue | Integer | The value of the voucher. The value of this parameter is the voucher value (USD, rounded to 8 decimal places) multiplied by 100,000,000. |
Balance | Integer | The balance left. The value of this parameter is the balance left (USD, rounded to 8 decimal places) multiplied by 100,000,000. |
VoucherId | String | The voucher ID. |
PayMode | String | postPay : pay-as-you-go; prePay : prepaid; riPay : reserved instance; empty or * : all. |
PayScene | String | If PayMode is postPay , this parameter may be spotpay (spot instance) or settle account (regular pay-as-you-go). If PayMode is prePay , this parameter may be purchase , renew , or modify (downgrade/upgrade). If PayMode is riPay , this parameter may be oneOffFee (prepayment of reserved instance) or hourlyFee (hourly billing of reserved instance). * means to query vouchers that support all billing scenarios. |
BeginTime | String | The start time of the validity period. |
EndTime | String | The end time of the validity period. |
ApplicableProducts | ApplicableProducts | The products that are applicable. Note: This field may return null , indicating that no valid value was found. |
ExcludedProducts | Array of ExcludedProducts | The products that are not applicable. Note: This field may return null , indicating that no valid value was found. |
Was this page helpful?