Skip to Content

List Unpaid Order Summary - ListUnpaidOrderSummary

Overview

Query aggregated unpaid order statistics by specified dimensions

Definition

Public Parameters

Parameter NameTypeDescription InformationRequired
ActionstringCorresponding API command name, the current API is ListUnpaidOrderSummary.Yes
PublicKeystringThe user’s public key can be obtained from Console Yes
SignaturestringUser signature generated based on public key and API command, see Signature AlgorithmYes

Request Parameters

Parameter NameTypeDescription InformationRequired
StartTimeintQuery start time (Unix timestamp, seconds), requiredYes
EndTimeintQuery end time (Unix timestamp, seconds), required; must be greater than StartTimeYes
ResourceIds.NstringAPI Key ID list (optional)No
OrderTypesintOrder type list (optional)No
ModelIds.NstringModel ID list (optional)No
PricingUnits.NintPricing unit list (optional)No
ChargeTypes.NintCharge type list (optional)No
PricingSkus.NstringBilling unit SKU list (optional)No
Regions.NstringRegion list (optional). See Region and Zone ListNo
OrganizationIds.NintOrganization ID list (optional)No

Response Field

Field NameTypeDescription InformationRequired
RetCodeintReturn status code. If it is 0, it means successful return. If it is not 0, it means failure.Yes
ActionstringOperation command name.Yes
MessagestringReturns an error message, providing detailed description when RetCode is non-zero.No
Summariesarray[OrderSummaryItem]Unpaid order summary listYes

Data Model

OrderSummaryItem

Field NameTypeDescription InformationRequired
ResourceIdstringResource IDNo
PricingSKUstringBilling unit SKUNo
ModelIDstringModel IDNo
ModelNamestringModel nameNo
PricingUnitintPricing unit (measurement unit)No
PricingUnitNamestringPricing unit nameNo
OrderTypeintOrder typeNo
OrderTypeDisplaystringOrder type display nameNo
ChargeTypeintChargeTypeNo
StatusintOrder status (2=Paid; 3=Cancelled)No
StatusDisplaystringOrder status display nameNo
ListPricestring
List price (original unit price)
No
DiscountPricestringDiscounted unit priceNo
SumQuantityintTotal usage quantity (raw value)No
SumQuantityDisplaystringTotal usage display (formatted, K tokens etc. are converted)No
SumOrderPricestringTotal order amountNo
SumOriginalPricestringTotal original priceNo
SumCashAccountstringTotal cash account deduction (only returned for paid orders)No
SumStarCardAccountstringTotal Star Card deduction amount (only returned for paid orders)No
SumBonusAccountstringTotal bonus account deduction (only returned for paid orders)No
SumCouponstringTotal coupon deduction (only returned for paid orders)No

Example

Request Example

https://api.surfercloud.com/?Action=ListUnpaidOrderSummary &Region=cn-zj &Zone=cn-zj-01 &ProjectId=cnSiQiol &ResourceIds.N=AglVXrhh &ModelIds.N=BQVSAjLU &PricingUnits.N=3 &OrderTypes=1 &ChargeTypes.N=9 &StartTime=1 &EndTime=3 &PricingSkus.N=NFswTmQW &Regions.N=uzZjhWLQ &OrganizationIds.N=1

Response Example

{ "Action": "ListUnpaidOrderSummaryResponse", "Data": {}, "RetCode": 0 }