实例账单查询服务_账单域_阿里云交易和账单管理API-阿里云

接口名

QueryInstanceBill

描述

查询用户某个账期内所有商品实例或计费项的消费汇总。

请求参数

名称	类型	是否必填	说明
Action	String	是	要执行的操作，取值：QueryInstanceBill
BillingCycle	String	是	账期YYYY－MM。样例：2018-07
ProductCode	String	否	产品代码
ProductType	String	否	产品类型
SubscriptionType	String	否	订阅类型 Subscription／PayAsYouGo，必须和ProductCode参数一起使用
IsBillingItem	String	否	是否按照计费项维度拉取数据，默认否：False（即：实例维度）；是：True
IsHideZeroCharge	String	否	是：True，否：False。根据原价（PretaxGrossAmount）和应付（PretaxAmount）是否都为0做过滤，默认为否（兼容现有逻辑）
PageNum	Integer	否	页码，默认值为1
PageSize	Integer	否	每页数量，默认值：20，最大值：300
OwnerId	Long	否	资源所有者的阿里云账号ID，通常为16位的数字。BID场景／分销场景OwnerID必须指定

返回参数

名称	类型	说明
BillingCycle	String	账期，格式：YYYY－MM
AccountID	String	账号ID
AccountName	String	账号
TotalCount	String	总记录数
PageNum	Integer	页码
PageSize	Integer	每页数量
Items	Item	账单详情

Item:

名称	类型	说明
OwnerID	String	子账号AccountID(多账号代付场景)
CostUnit	String	财务单元
SubscriptionType	String	订阅类型 Subscription／PayAsYouGo
Item	String	账单类型：SubscriptionOrder／PayAsYouGoBill／Refund／Adjustment
ProductCode	String	产品代码
ProductName	String	产品名称
ProductType	String	产品类型
ProductDetail	String	产品明细
BillingType	String	计费方式，比如：月95，日均峰值
InstanceID	String	实例id
NickName	String	实例昵称
ResourceGroup	String	资源组
Tag	String	实例Tag，格式：key1:value1;key2:value2…
InstanceConfig	String	实例详细配置：亚太东南3 可用区A;实例规格名称:ecs.sn1ne.3xlarge;CPU:12;内存:24576;磁盘:100;带宽:-1;OS:1970324836975976;是否io优化:1 ecs.sn1ne.3xlarge
InstanceSpec	String	实例规格：ecs.sn1ne.3xlarge
InternetIP	String	公网IP
IntranetIP	String	内网IP
Region	String	地域
Zone	String	可用区
BillingItem	String	计费项
ListPrice	String	单价
ListPriceUnit	String	单价单位
Usage	String	用量
UsageUnit	String	用量单位
DeductedByResourcePackage	String	资源包抵扣
PretaxGrossAmount	Double	原始金额
InvoiceDiscount	Double	优惠金额
DeductedByCoupons	Double	优惠券优惠金额
PretaxAmount	Double	应付金额
DeductedByCashCoupons	Double	代金券抵扣
DeductedByPrepaidCard	Double	储值卡抵扣
PaymentAmount	Double	现金支付
OutstandingAmount	Double	未结清金额
Currency	String	币种 CNY／USD／JPY

注1：实例账单是根据账单数据拆分生成，一般会有一天延迟；

注2：实例信息在账期内会变化，月汇总的实例Config和Spec对应记录生成时间信息，如需详情可参考对应明细账单；

注3：实例和计费项账单不包含阿里通信和域名产品。

请求示例

&Action=QueryInstanceBill
&BillingCycle=2018-10
&其他参数

返回示例

{
    "Data": {
        "Items": {
            "Item": [
                {
                    "ListPrice": "",
                    "BillingItem": "",
                    "NickName": "",
                    "PretaxAmount": 208.32,
                    "Usage": "",
                    "Region": "华东2（上海）",
                    "InstanceConfig": "",
                    "Item": "PayAsYouGoBill",
                    "UsageUnit": "",
                    "IntranetIP": "",
                    "Tag": "",
                    "ProductType": "",
                    "ProductName": "共享带宽",
                    "Zone": "",
                    "PretaxGrossAmount": 208.32,
                    "Currency": "CNY",
                    "InvoiceDiscount": 0,
                    "ResourceGroup": "",
                    "SubscriptionType": "PayAsYouGo",
                    "ProductCode": "cbwp",
                    "InstanceID": "cbwp-uf***qop",
                    "ProductDetail": "共享带宽(后付费)",
                    "DeductedByPrepaidCard": 0,
                    "ListPriceUnit": "",
                    "CostUnit": "未分配",
                    "DeductedByResourcePackage": "",
                    "InternetIP": "",
                    "DeductedByCoupons": 0,
                    "PaymentAmount": 0,
                    "OutstandingAmount": 208.32,
                    "InstanceSpec": "",
                    "DeductedByCashCoupons": 0,
                    "OwnerID": "169***013",
                    "BillingType": "其它"
                },
                {
                    "ListPrice": "",
                    "BillingItem": "",
                    "NickName": "",
                    "PretaxAmount": 14.88,
                    "Usage": "",
                    "Region": "华东2（上海）",
                    "InstanceConfig": "",
                    "Item": "PayAsYouGoBill",
                    "UsageUnit": "",
                    "IntranetIP": "",
                    "Tag": "",
                    "ProductType": "",
                    "ProductName": "弹性公网IP",
                    "Zone": "",
                    "PretaxGrossAmount": 14.88,
                    "Currency": "CNY",
                    "InvoiceDiscount": 0,
                    "ResourceGroup": "默认资源组",
                    "SubscriptionType": "PayAsYouGo",
                    "ProductCode": "eip",
                    "InstanceID": "eip-uf***da",
                    "ProductDetail": "弹性公网IP",
                    "DeductedByPrepaidCard": 0,
                    "ListPriceUnit": "",
                    "CostUnit": "未分配",
                    "DeductedByResourcePackage": "",
                    "InternetIP": "",
                    "DeductedByCoupons": 0,
                    "PaymentAmount": 0,
                    "OutstandingAmount": 14.88,
                    "InstanceSpec": "",
                    "DeductedByCashCoupons": 0,
                    "OwnerID": "169***013",
                    "BillingType": "其它"
                }
            ]
        },
        "TotalCount": 55,
        "BillingCycle": "2019-07",
        "AccountID": "169***013",
        "PageSize": 20,
        "AccountName": "zho***18",
        "PageNum": 1
    },
    "Message": "Successful!",
    "RequestId": "8E3E3111-B1D1-48FB-A388-A02D**7600",
    "Success": true,
    "Code": "Success"
}