调用DescribeSplitItemBill查询分账账单

  • 与费用中心-分账账单 账期数据一致
  • 分账账单提供12月内账期数据查询
  • 本数据需要用户在控制台分账账单页面开通后才可提供

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeSplitItemBill

系统规定参数。取值:DescribeSplitItemBill

BillingCycle String 2020-03

账单日期,YYYY-MM。

ProductCode String rds

产品代码。

ProductType String rds

产品类型。

SubscriptionType String PayAsYouGo

订阅类型。取值:

Subscription:预付费。

PayAsYouGo:后付费。

说明 必须和ProductCode参数一起使用。

NextToken String CAESEgoQCg4KCmdtdF9jcmVhdGUEARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U

用来表示当前调用开始读取的位置,参数值必须为空或者使用返回结果中的NextToken设值,否则会报错。空代表从头开始读取。

MaxResults Integer 20

本次读取的最大数据记录数量。默认值:20,最大值:300。

BillOwnerId Long 123

子账号ID。设置可查看财务云子账号账单,不填默认查看当前调用账号。

InstanceID String i-kjhdskjgshfdlkjfdh

实例ID。

SplitItemID String i-kjhdskjgshfdlkjfdh

分拆项ID。

Granularity String Monthly

查询账单的颗粒度。取值:

  • MONTHLY:月。与用户中心-分账账单-账期 账单一致。
  • DAILY:日。与用户中心-分账账单-按天 账单一致。

    选择DAILY需指定BillingDate。

BillingDate String 2020-03-02

账单日期,仅当Granularity为DAILY时必填,格式为YYYY-MM-DD。

TagFilter.N.TagKey String TestKey

TagFilter.N用于查找符合指定标签的账单,由一个键值对组成。标签键长度的取值范围:1~128。N的取值范围:1~20

  • 仅指定TagFilter.N.TagKey时,则返回关联该标签键的所有账单。
  • 同时指定多个标签键值对时,满足任一标签键值对的账单被查找到。
  • 如果资源上的标签发生变动,仅能查询标签存续期间的账单。

返回数据

名称 类型 示例值 描述
Code String Success

状态码。

Message String Successful!

错误信息。

RequestId String 79EE7556-0CFD-44EB-9CD6-B3B526E3A85F

请求ID。

Success Boolean true

是否成功。

Data Object

返回数据。

NextToken String CAESEgoQCg4KCmdtdF9jcmVhdGUQARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U

用来表示当前调用返回读取到的位置,空代表数据已经读取完毕。下次调用时,需要将此设置到入参NextToken中。

BillingCycle String 2020-03

账单日期,格式:YYYY-MM。

MaxResults Integer 20

本次请求所返回的最大记录条数。

AccountID String 185xxxx3489

账号ID。

TotalCount Integer 20

总记录数。

AccountName String test@test.aliyunid.com

用户账号。

Items Array of Item

账单详情。

SplitAccountID String 12**122

分拆项所属账号AccountID

BillAccountName String test@test.aliyunid.com

账单所属账号名称。

SubscriptionType String PayAsYouGo

订阅类型,取值:

Subscription:预付费。

PayAsYouGo:后付费。

InstanceSpec String ecs.sn1ne.3xlarge

实例规格。

DeductedByCoupons Float 0

优惠券优惠金额。

Region String 杭州

地域。

OutstandingAmount Float 0.1

未结清金额。

PipCode String rds

产品Code,与费用中心账单产品Code一致

CommodityCode String rds

商品Code,与费用中心产品明细Code一致。

NickName String nick

实例昵称。

ProductDetail String 云数据库RDS

产品明细。

Usage String 100

用量。

IntranetIP String 192.xx.xx.xx

内网IP。

UsageUnit String GB

用量单位。

SplitCommodityCode String rds

分拆项商品code。

BillAccountID String 185xxxx3489

账单所属账号ID。

ProductType String rds

产品类型。

DeductedByResourcePackage String 0

资源包抵扣。

PaymentAmount Float 0

现金支付(含信用额度退款抵扣)。

SplitBillingCycle String 2021-06

分账月。

ServicePeriod String 20

服务时长。

SplitItemName String iZ28bycvyb4Z

分拆项名称。

ListPrice String 0.12

单价。

Zone String 华北1

可用区。

PretaxGrossAmount Float 0

原始金额。

CashAmount Float 0

现金支付(不包含信用额度退款抵扣)。

InstanceConfig String CPU:12

实例详细配置。

BillingDate String 2020-01-20

账单日期,格式YYYY-MM-DD。暂未支持。

InternetIP String 34.xx.x.x

公网IP。

Item String PayAsYouGoBill

账单类型:

SubscriptionOrder(预付订单)。

PayAsYouGoBill (后付账单)。

Refund (退款)。

Adjustment (调账)。

SplitItemID String i-28bycvyb4

分拆项ID。

InstanceID String i-kjhdskjgshfdlkjfdh

实例ID。

Tag String key:testKey value:testValue; key:testKey1 value:testValues1

资源标签。资源上标签变更时,则存续期间产生的账单会有此标签。

Currency String CNY

币种,取值:

CNY。

USD。

JPY。

DeductedByCashCoupons Float 0

代金券抵扣。

BizType String trusteeship

业务类型

BillingItem String 带宽

计费项。

BillingItemCode String disk

计费项。

CostUnit String 未分配

财务单元。

ListPriceUnit String 元/GB

单价单位。

ResourceGroup String 默认资源组

资源组。

PretaxAmount Float 0

应付金额。

ServicePeriodUnit String 小时

服务时长单位。

SplitBillingDate String 2021-06-01

分账天。

ProductName String 云数据库RDS

产品名称。

SplitProductDetail String 云数据库

分拆项产品明细名称。

AdjustAmount Float 0

信用额度退款抵扣。

OwnerID String 169***013

资源Owner账号AccountID(多账号代付场景)。

DeductedByPrepaidCard Float 0

储值卡抵扣。

InvoiceDiscount Float 0

优惠金额。

SplitAccountName String test**1122

分拆项所属账号名称。

BillingType String 其它

计费方式。

ProductCode String rds

产品代码。

ItemName String iZ28bycvyb4Z

项目名称。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeSplitItemBill
&BillingCycle=2020-03
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>79EE7556-0CFD-44EB-9CD6-B3B526E3A85F</RequestId>
<Message>Successful!</Message>
<Data>
    <TotalCount>20</TotalCount>
    <BillingCycle>2020-03</BillingCycle>
    <AccountID>185xxxx3489</AccountID>
    <NextToken>CAESEgoQCg4KCmdtdF9jcmVhdGUQARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U</NextToken>
    <MaxResults>20</MaxResults>
    <AccountName>test@test.aliyunid.com</AccountName>
    <Items>
        <ProductName>云数据库RDS</ProductName>
        <InstanceID>i-kjhdskjgshfdlkjfdh</InstanceID>
        <BillAccountID>185xxxx3489</BillAccountID>
        <SplitCommodityCode>rds</SplitCommodityCode>
        <ListPrice>0.12</ListPrice>
        <PaymentAmount>0</PaymentAmount>
        <DeductedByPrepaidCard>0</DeductedByPrepaidCard>
        <SplitItemName>iZ28bycvyb4Z</SplitItemName>
        <Item>PayAsYouGoBill</Item>
        <SubscriptionType>PayAsYouGo</SubscriptionType>
        <InstanceConfig>CPU:12</InstanceConfig>
        <SplitBillingDate>2021-06-01</SplitBillingDate>
        <Currency>CNY</Currency>
        <CostUnit>未分配</CostUnit>
        <DeductedByCoupons>0</DeductedByCoupons>
        <ProductCode>rds</ProductCode>
        <ProductType>rds</ProductType>
        <OutstandingAmount>0.1</OutstandingAmount>
        <BizType>trusteeship</BizType>
        <NickName>nick</NickName>
        <IntranetIP>192.xx.xx.xx</IntranetIP>
        <ServicePeriodUnit>小时</ServicePeriodUnit>
        <ServicePeriod>20</ServicePeriod>
        <UsageUnit>GB</UsageUnit>
        <OwnerID>169***013</OwnerID>
        <InternetIP>34.xx.x.x</InternetIP>
        <Region>杭州</Region>
        <InstanceSpec>ecs.sn1ne.3xlarge</InstanceSpec>
        <DeductedByCashCoupons>0</DeductedByCashCoupons>
        <ListPriceUnit>元/GB</ListPriceUnit>
        <BillingDate>2020-01-20</BillingDate>
        <InvoiceDiscount>0</InvoiceDiscount>
        <SplitProductDetail>云数据库</SplitProductDetail>
        <PretaxGrossAmount>0</PretaxGrossAmount>
        <CommodityCode>rds</CommodityCode>
        <AdjustAmount>0</AdjustAmount>
        <ResourceGroup>默认资源组</ResourceGroup>
        <BillingType>其它</BillingType>
        <SplitAccountName>test**1122</SplitAccountName>
        <Usage>100</Usage>
        <SplitAccountID>12**122</SplitAccountID>
        <ProductDetail>云数据库RDS</ProductDetail>
        <Zone>华北1</Zone>
        <BillingItem>带宽</BillingItem>
        <PipCode>rds</PipCode>
        <SplitItemID>i-28bycvyb4</SplitItemID>
        <SplitBillingCycle>2021-06</SplitBillingCycle>
        <DeductedByResourcePackage>0</DeductedByResourcePackage>
        <PretaxAmount>0</PretaxAmount>
        <BillAccountName>test@test.aliyunid.com</BillAccountName>
        <Tag>key:testKey value:testValue; key:testKey1 value:testValues1</Tag>
        <CashAmount>0</CashAmount>
    </Items>
</Data>
<Code>Success</Code>
<Success>true</Success>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "79EE7556-0CFD-44EB-9CD6-B3B526E3A85F",
  "Message" : "Successful!",
  "Data" : {
    "TotalCount" : 20,
    "BillingCycle" : "2020-03",
    "AccountID" : "185xxxx3489",
    "NextToken" : "CAESEgoQCg4KCmdtdF9jcmVhdGUQARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U",
    "MaxResults" : 20,
    "AccountName" : "test@test.aliyunid.com",
    "Items" : {
      "ProductName" : "云数据库RDS",
      "InstanceID" : "i-kjhdskjgshfdlkjfdh",
      "BillAccountID" : "185xxxx3489",
      "SplitCommodityCode" : "rds",
      "ListPrice" : 0.12,
      "PaymentAmount" : 0,
      "DeductedByPrepaidCard" : 0,
      "SplitItemName" : "iZ28bycvyb4Z",
      "Item" : "PayAsYouGoBill",
      "SubscriptionType" : "PayAsYouGo",
      "InstanceConfig" : "CPU:12",
      "SplitBillingDate" : "2021-06-01",
      "Currency" : "CNY",
      "CostUnit" : "未分配",
      "DeductedByCoupons" : 0,
      "ProductCode" : "rds",
      "ProductType" : "rds",
      "OutstandingAmount" : 0.1,
      "BizType" : "trusteeship",
      "NickName" : "nick",
      "IntranetIP" : "192.xx.xx.xx",
      "ServicePeriodUnit" : "小时",
      "ServicePeriod" : 20,
      "UsageUnit" : "GB",
      "OwnerID" : "169***013",
      "InternetIP" : "34.xx.x.x",
      "Region" : "杭州",
      "InstanceSpec" : "ecs.sn1ne.3xlarge",
      "DeductedByCashCoupons" : 0,
      "ListPriceUnit" : "元/GB",
      "BillingDate" : "2020-01-20",
      "InvoiceDiscount" : 0,
      "SplitProductDetail" : "云数据库",
      "PretaxGrossAmount" : 0,
      "CommodityCode" : "rds",
      "AdjustAmount" : 0,
      "ResourceGroup" : "默认资源组",
      "BillingType" : "其它",
      "SplitAccountName" : "test**1122",
      "Usage" : 100,
      "SplitAccountID" : "12**122",
      "ProductDetail" : "云数据库RDS",
      "Zone" : "华北1",
      "BillingItem" : "带宽",
      "PipCode" : "rds",
      "SplitItemID" : "i-28bycvyb4",
      "SplitBillingCycle" : "2021-06",
      "DeductedByResourcePackage" : 0,
      "PretaxAmount" : 0,
      "BillAccountName" : "test@test.aliyunid.com",
      "Tag" : "key:testKey value:testValue; key:testKey1 value:testValues1",
      "CashAmount" : 0
    }
  },
  "Code" : "Success",
  "Success" : true
}

错误码

访问错误中心查看更多错误码。