全部產品
Search
文件中心

Expenses and Costs:DescribeSplitItemBill - 分賬賬單服務

更新時間:Aug 11, 2025

查詢分賬賬單。

介面說明

  • 分賬賬單當月資料查詢結果僅供參考,不作為對賬依據。當月最終賬單在次月 4 日 12 點後查詢,當月分賬賬單資料中不包含未結算(未出賬,累賬中)的後付費資料。

  • 分賬賬單資料支援最近 12 個月資料。

  • 分賬賬單資料相對於實際費用消耗延遲 48 小時更新,其中分拆型雲產品(例如:CDN、OSS、共用頻寬等)各個分拆項(例如:網域名稱、Bucket、EIP 等)的具體費用延遲 72 小時更新。

  • 分賬賬單資料需要使用者在控制台分賬賬單頁面開通後才可提供,自開通後延遲 24 小時可使用。

  • 單使用者限流 10 筆/秒,如遇逾時,請重試。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

bssapi:DescribeSplitItemBill

get

*全部資源

*

bssapi:ProductCode
bssapi:ProductType

請求參數

名稱

類型

必填

描述

樣本值

BillingCycle

string

賬單日期,YYYY-MM。

2020-03

ProductCode

string

產品代碼。

rds

ProductType

string

產品類型。

rds

SubscriptionType

string

訂閱類型。取值:

  • Subscription:預付費。

  • PayAsYouGo:後付費。

說明

必須和 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

查詢賬單的顆粒度。取值:

  • MONTHLY:月。與使用者中心-分賬賬單-賬期賬單一致。

  • DAILY:日。與使用者中心-分賬賬單-按天賬單一致。

說明

選擇 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。

  • 指定 TagValues.N 時,需同時指定 TagFilter.N.TagKey,否則報錯 InvalidParameter.TagValues。

  • 指定多個標籤值時,則滿足任一標籤值的賬單都會被查詢到。

TestValue

string

標籤值。

TestValue

TagKey

string

TagFilter.N 用於尋找符合指定標籤的賬單,由一個索引值對組成。標籤鍵長度的取值範圍:1~128。N 的取值範圍:1~20

  • 僅指定 TagFilter.N.TagKey 時,則返回關聯該標籤鍵的所有賬單。

  • 同時指定多個標籤索引值對時,滿足任一標籤索引值對的賬單被尋找到。

  • 如果資源上的標籤發生變動,僅能查詢標籤存續期間的賬單。

TestKey

IsHideZeroCharge

boolean

根據原價(PretaxGrossAmount)和應付(PretaxAmount)是否都為 0 做過濾。取值:

  • false。

  • true。

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
      }
    ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情