调用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.TagValues.N RepeatList TestValue

TagValues.N用于查找符合指定标签值的账单,由字符串列表组成。标签值长度的取值范围:1~128。N的取值范围:1~20。

  • 指定TagValues.N时,需同时指定TagFilter.N.TagKey,否则报错InvalidParameter.TagValues。
  • 指定多个标签值时,则满足任一标签值的账单都会被查询到。
TagFilter.N.TagKey String TestKey

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

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

返回数据

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

状态码。

Data Struct

返回数据。

AccountID String 185xxxx3489

账号ID。

AccountName String test@test.aliyunid.com

用户账号。

BillingCycle String 2020-03

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

Items Array of Item

账单详情。

AdjustAmount Float 0

信用额度退款抵扣。

BillAccountID String 185xxxx3489

账单所属账号ID。

BillAccountName String test@test.aliyunid.com

账单所属账号名称。

BillingDate String 2020-01-20

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

BillingItem String 带宽

计费项。

BillingType String 其它

计费方式。

BizType String trusteeship

业务类型

CashAmount Float 0

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

CommodityCode String rds

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

CostUnit String 未分配

财务单元。

Currency String CNY

币种,取值:

CNY。

USD。

JPY。

DeductedByCashCoupons Float 0

代金券抵扣。

DeductedByCoupons Float 0

优惠券优惠金额。

DeductedByPrepaidCard Float 0

储值卡抵扣。

DeductedByResourcePackage String 0

资源包抵扣。

InstanceConfig String CPU:12

实例详细配置。

InstanceID String i-kjhdskjgshfdlkjfdh

实例ID。

InstanceSpec String ecs.sn1ne.3xlarge

实例规格。

InternetIP String 34.xx.x.x

公网IP。

IntranetIP String 192.xx.xx.xx

内网IP。

InvoiceDiscount Float 0

优惠金额。

Item String PayAsYouGoBill

账单类型:

SubscriptionOrder (预付订单)。

PayAsYouGoBill (后付账单)。

Refund (退款)。

Adjustment (调账)。

ListPrice String 0.12

单价。

ListPriceUnit String 元/GB

单价单位。

NickName String nick

实例昵称。

OutstandingAmount Float 0.1

未结清金额。

OwnerID String 169***013

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

PaymentAmount Float 0

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

PipCode String rds

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

PretaxAmount Float 0

应付金额。

PretaxGrossAmount Float 0

原始金额。

ProductCode String rds

产品代码。

ProductDetail String 云数据库RDS

产品明细。

ProductName String 云数据库RDS

产品名称。

ProductType String rds

产品类型。

Region String 杭州

地域。

ResourceGroup String 默认资源组

资源组。

ServicePeriod String 20

服务时长。

ServicePeriodUnit String 小时

服务时长单位。

SplitAccountID String 12**122

分拆项所属账号AccountID

SplitAccountName String test**1122

分拆项所属账号名称。

SplitBillingCycle String 2021-06

分账月。

SplitBillingDate String 2021-06-01

分账天。

SplitCommodityCode String rds

分拆项商品code。

SplitItemID String i-28bycvyb4

分拆项ID。

SplitItemName String iZ28bycvyb4Z

分拆项名称。

SplitProductDetail String 云数据库

分拆项产品明细名称。

SubscriptionType String PayAsYouGo

订阅类型,取值:

Subscription:预付费。

PayAsYouGo:后付费。

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

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

Usage String 100

用量。

UsageUnit String GB

用量单位。

Zone String 华北1

可用区。

MaxResults Integer 20

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

NextToken String CAESEgoQCg4KCmdtdF9jcmVhdGUQARgBIkgKCQBwhGmPcAEAAAo7AzYAAAAxTDgwMDcxMjg3ZDJhNmM3ZDguTDgwMDAwMDAwMDAwMzE1MTIuTDgwMDcyZDMyZTJkYzg3N2U

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

TotalCount Integer 20

总记录数。

Message String Successful!

错误信息。

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

请求ID。

Success Boolean true

是否成功。

示例

请求示例

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

正常返回示例

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格式

{
    "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
}

错误码

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