查詢分賬賬單。
介面說明
分賬賬單當月資料查詢結果僅供參考,不作為對賬依據。當月最終賬單在次月 4 日 12 點後查詢,當月分賬賬單資料中不包含未結算(未出賬,累賬中)的後付費資料。
分賬賬單資料支援最近 12 個月資料。
分賬賬單資料相對於實際費用消耗延遲 48 小時更新,其中分拆型雲產品(例如:CDN、OSS、共用頻寬等)各個分拆項(例如:網域名稱、Bucket、EIP 等)的具體費用延遲 72 小時更新。
分賬賬單資料需要使用者在控制台分賬賬單頁面開通後才可提供,自開通後延遲 24 小時可使用。
單使用者限流 10 筆/秒,如遇逾時,請重試。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
bssapi:DescribeSplitItemBill |
get |
*全部資源
|
bssapi:ProductCode
bssapi:ProductType
|
無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| BillingCycle |
string |
是 |
賬單日期,YYYY-MM。 |
2020-03 |
| ProductCode |
string |
否 |
產品代碼。 |
rds |
| ProductType |
string |
否 |
產品類型。 |
rds |
| SubscriptionType |
string |
否 |
訂閱類型。取值:
說明
必須和 ProductCode 參數一起使用。 |
PayAsYouGo |
| NextToken |
string |
否 |
用來表示當前調用開始讀取的位置,參數值必須為空白或者使用返回結果中的 NextToken 設值,否則會報錯。空代表從頭開始讀取。 |
CAESEgoQCg4KCmd |
| MaxResults |
integer |
否 |
本次讀取的最巨量資料記錄數量。預設值:20,最大值:300。 |
20 |
| BillOwnerId |
integer |
否 |
資源歸屬帳號的 ID,資源歸屬帳號是實際使用資源的帳號。 |
123 |
| InstanceID |
string |
否 |
執行個體 ID。 |
i-kjhdskjgshfdlkjfdh |
| SplitItemID |
string |
否 |
分拆項 ID。 |
i-kjhdskjgshfdlkjfdh |
| Granularity |
string |
否 |
查詢賬單的顆粒度。取值:
說明
選擇 DAILY 需指定 BillingDate。 |
Monthly |
| BillingDate |
string |
否 |
賬單日期,僅當 Granularity 為 DAILY 時必填,格式為 YYYY-MM-DD。 |
2020-03-02 |
| TagFilter |
array<object> |
否 |
標籤過濾條件,支援多組標籤查詢條件 TagValues。多組 TagValues 條件之間為或關係。 |
|
|
object |
否 |
標籤過濾條件。 |
||
| TagValues |
array |
否 |
TagValues.N 用於尋找符合指定標籤值的賬單,由字串列表組成。標籤值長度的取值範圍:1~128。N 的取值範圍:1~20。
|
TestValue |
|
string |
否 |
標籤值。 |
TestValue |
|
| TagKey |
string |
否 |
TagFilter.N 用於尋找符合指定標籤的賬單,由一個索引值對組成。標籤鍵長度的取值範圍:1~128。N 的取值範圍:1~20
|
TestKey |
| IsHideZeroCharge |
boolean |
否 |
根據原價(PretaxGrossAmount)和應付(PretaxAmount)是否都為 0 做過濾。取值:
|
false |
| PipCode |
string |
否 |
產品 Code,與費用中心賬單產品 Code 一致。 |
rds |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| Code |
string |
狀態代碼。 |
Success |
| Message |
string |
錯誤資訊。 |
Successful! |
| RequestId |
string |
請求 ID。 |
79EE7556-0CFD-44EB-9CD6-B3B526E3A85F |
| Success |
boolean |
是否成功。 |
true |
| Data |
object |
返回資料。 |
|
| NextToken |
string |
用來表示當前調用返回讀取到的位置,空代表資料已經讀取完畢。下次調用時,需要將此設定到入參 NextToken 中。 |
CAESEgoQCg4K |
| BillingCycle |
string |
賬單日期,格式:YYYY-MM。 |
2020-03 |
| MaxResults |
integer |
本次請求所返回的最大記錄條數。 |
20 |
| AccountID |
string |
帳號 ID。 |
185xxxx3489 |
| TotalCount |
integer |
總記錄數。 |
20 |
| AccountName |
string |
使用者帳號。 |
test@test.aliyunid.com |
| Items |
array<object> |
賬單詳情。 |
|
|
object |
|||
| SplitAccountID |
string |
分拆項所屬帳號 AccountID |
12**122 |
| BillAccountName |
string |
賬單所屬帳號名稱。 |
test@test.aliyunid.com |
| SubscriptionType |
string |
訂閱類型,取值: Subscription:預付費。 PayAsYouGo:後付費。 |
PayAsYouGo |
| InstanceSpec |
string |
執行個體規格。 |
ecs.sn1ne.3xlarge |
| DeductedByCoupons |
number |
優惠券優惠金額。 |
0 |
| Region |
string |
地區。 |
杭州 |
| OutstandingAmount |
number |
未結清金額。 |
0.1 |
| PipCode |
string |
產品 Code,與費用中心賬單產品 Code 一致 |
rds |
| CommodityCode |
string |
商品 Code,與費用中心產品明細 Code 一致。 |
rds |
| NickName |
string |
執行個體暱稱。 |
nick |
| ProductDetail |
string |
產品明細。 |
雲資料庫RDS |
| Usage |
string |
用量。 |
100 |
| IntranetIP |
string |
內網 IP。 |
192.xx.xx.xx |
| UsageUnit |
string |
用量單位。 |
GB |
| SplitCommodityCode |
string |
分拆項商品 code。 |
rds |
| BillAccountID |
string |
賬單所屬帳號 ID。 |
185xxxx3489 |
| ProductType |
string |
產品類型。 |
rds |
| DeductedByResourcePackage |
string |
資源套件抵扣。 |
0 |
| PaymentAmount |
number |
現金支付(含信用額度退款抵扣)。 |
0 |
| SplitBillingCycle |
string |
分賬月。 |
2021-06 |
| ServicePeriod |
string |
服務時間長度。 |
20 |
| SplitItemName |
string |
分拆項名稱。 |
iZ28bycvyb4Z |
| ListPrice |
string |
單價。 |
0.12 |
| Zone |
string |
可用性區域。 |
華北1 |
| PretaxGrossAmount |
number |
原始金額。 |
0 |
| CashAmount |
number |
現金支付(不包含信用額度退款抵扣)。 |
0 |
| InstanceConfig |
string |
執行個體詳細配置。 |
CPU:12 |
| BillingDate |
string |
賬單日期,格式 YYYY-MM-DD。暫未支援。 |
2020-01-20 |
| InternetIP |
string |
公網 IP。 |
34.xx.x.x |
| Item |
string |
賬單類型: SubscriptionOrder(預付訂單)。 PayAsYouGoBill (後付賬單)。 Refund (退款)。 Adjustment (調賬)。 |
PayAsYouGoBill |
| SplitItemID |
string |
分拆項 ID。 |
i-28bycvyb4 |
| InstanceID |
string |
執行個體 ID。 |
i-kjhdskjgshfdlkjfdh |
| Tag |
string |
資源標籤。資源上標籤變更時,則存續期間產生的賬單會有此標籤。 |
key:testKey value:testValue; key:testKey1 value:testValues1 |
| Currency |
string |
幣種,取值: CNY。 USD。 JPY。 |
CNY |
| DeductedByCashCoupons |
number |
代金券抵扣。 |
0 |
| BizType |
string |
業務類型 |
trusteeship |
| BillingItem |
string |
計費項目。 |
頻寬 |
| BillingItemCode |
string |
計費項目代碼。 |
disk |
| CostUnit |
string |
財務單元。 |
未分配 |
| ListPriceUnit |
string |
單價單位。 |
元/GB |
| ResourceGroup |
string |
資源群組。 |
預設資源群組 |
| PretaxAmount |
number |
應付金額。 |
0 |
| ServicePeriodUnit |
string |
服務時間長度單位。 |
小時 |
| SplitBillingDate |
string |
分賬天。 |
2021-06-01 |
| ProductName |
string |
產品名稱。 |
雲資料庫RDS |
| SplitProductDetail |
string |
分拆項產品明細名稱。 |
雲資料庫 |
| AdjustAmount |
number |
信用額度退款抵扣。 |
0 |
| OwnerID |
string |
資源 Owner 帳號 AccountID(多帳號代付情境)。 |
169***013 |
| DeductedByPrepaidCard |
number |
儲值卡抵扣。 |
0 |
| InvoiceDiscount |
number |
優惠金額。 |
0 |
| SplitAccountName |
string |
分拆項所屬帳號名稱。 |
test**1122 |
| BillingType |
string |
計費方式。 |
其它 |
| ProductCode |
string |
產品代碼。 |
rds |
| ItemName |
string |
專案名稱。 |
iZ28bycvyb4Z |
| AfterDiscountAmount |
number |
優惠後金額(包含券抵扣的應付金額資料。計算規則為:優惠後金額=官網目錄價-優惠金額) |
樣本
正常返回樣本
JSON格式
{
"Code": "Success",
"Message": "Successful!",
"RequestId": "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
"Success": true,
"Data": {
"NextToken": "CAESEgoQCg4K",
"BillingCycle": "2020-03",
"MaxResults": 20,
"AccountID": "185xxxx3489",
"TotalCount": 20,
"AccountName": "test@test.aliyunid.com",
"Items": [
{
"SplitAccountID": "12**122",
"BillAccountName": "test@test.aliyunid.com",
"SubscriptionType": "PayAsYouGo",
"InstanceSpec": "ecs.sn1ne.3xlarge",
"DeductedByCoupons": 0,
"Region": "杭州",
"OutstandingAmount": 0.1,
"PipCode": "rds",
"CommodityCode": "rds",
"NickName": "nick",
"ProductDetail": "雲資料庫RDS",
"Usage": "100",
"IntranetIP": "192.xx.xx.xx",
"UsageUnit": "GB",
"SplitCommodityCode": "rds",
"BillAccountID": "185xxxx3489",
"ProductType": "rds",
"DeductedByResourcePackage": "0",
"PaymentAmount": 0,
"SplitBillingCycle": "2021-06",
"ServicePeriod": "20",
"SplitItemName": "iZ28bycvyb4Z",
"ListPrice": "0.12",
"Zone": "華北1",
"PretaxGrossAmount": 0,
"CashAmount": 0,
"InstanceConfig": "CPU:12",
"BillingDate": "2020-01-20",
"InternetIP": "34.xx.x.x",
"Item": "PayAsYouGoBill",
"SplitItemID": "i-28bycvyb4",
"InstanceID": "i-kjhdskjgshfdlkjfdh",
"Tag": "key:testKey value:testValue; key:testKey1 value:testValues1",
"Currency": "CNY",
"DeductedByCashCoupons": 0,
"BizType": "trusteeship",
"BillingItem": "頻寬",
"BillingItemCode": "disk",
"CostUnit": "未分配",
"ListPriceUnit": "元/GB",
"ResourceGroup": "預設資源群組",
"PretaxAmount": 0,
"ServicePeriodUnit": "小時",
"SplitBillingDate": "2021-06-01",
"ProductName": "雲資料庫RDS",
"SplitProductDetail": "雲資料庫",
"AdjustAmount": 0,
"OwnerID": "169***013",
"DeductedByPrepaidCard": 0,
"InvoiceDiscount": 0,
"SplitAccountName": "test**1122",
"BillingType": "其它",
"ProductCode": "rds",
"ItemName": "iZ28bycvyb4Z",
"AfterDiscountAmount": 0
}
]
}
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。