查询实例账单汇总

DescribeInstanceSummaryBills(查询实例账单汇总)

本文档为您介绍如何按实例ID获取账单汇总金额。注意：只支持查询相同月份的数据。

请求参数

名称	必选	类型	描述
Action	是	String	操作接口名，系统规定参数，取值：DescribeInstanceSummaryBills
Version	是	String	API版本，固定为2020-01-01
BillMonth	是	String	客户账单月份，YYYY-MM。不支持跨月查询
ProductCode	否	String	可选参数，产品线对应的Code。eg. KEC，默认获取所有产品线的账单，取值可以参考 获取产品线列表
Page	否	Integer	页码，默认值为1
Size	否	Integer	每页数量，默认值：20，最大值：1000

返回数据（调用成功）

名称	类型	描述
CustomerId	Long	客户UID
Email	String	登录邮箱
SummaryOverview	InstanceSummaryBills 数组	实例账单汇总详情
PageNum	Integer	页码
PageSize	Integer	每页数量
TotalCount	Integer	总记录数
RequestId	String	当前请求的RequestId

示例（调用成功）

请求示例

https://bill-union.api.ksyun.com?Action=DescribeInstanceSummaryBills&Version=2020-01-01&BillMonth=2020-06&Page=1&Size=1&公共参数

返回示例

• XML格式

<InstanceSummaryResponse>
    <RequestId>0d333ab1-ce89-43bc-96f1-afa606b69284</RequestId>
    <Email></Email>
    <PageNum>1</PageNum>
    <PageSize>1</PageSize>
    <TotalCount>14</TotalCount>
    <CustomerId>2000102768</CustomerId>
    <CustomerName>pt代理商555</CustomerName>
    <SummaryOverview>
        <SummaryOverview>
            <BillsNo>000000000020091</BillsNo>
            <CustomerBillMonth>2021-12</CustomerBillMonth>
            <BillMonth>2021-12</BillMonth>
            <ProductName>云服务器</ProductName>
            <ProductSubTyeName>IO优化型I2</ProductSubTyeName>
            <InstanceId>01f867ae-bab1-4be7-a307-d3498313b216</InstanceId>
            <InstanceName></InstanceName>
            <Currency>CNY</Currency>
            <DetailBillStartTime>2021-12-11 00:00:00</DetailBillStartTime>
            <DetailBillEndTime>2022-01-10 23:59:59</DetailBillEndTime>
            <ServiceBillStartTime></ServiceBillStartTime>
            <PayMode>预付费</PayMode>
            <BillTypeName>包年包月</BillTypeName>
            <RegionName>华东2（上海）</RegionName>
            <RegionCode>cn-shanghai-3</RegionCode>
            <ZoneName></ZoneName>
            <ZoneCode></ZoneCode>
            <ProjectId>0</ProjectId>
            <ProjectName>默认项目</ProjectName>
            <Duration></Duration>
            <Remark>续费</Remark>
            <Cost>88.00000000</Cost>
            <RealCost>88.00</RealCost>
            <Discount>1.00</Discount>
            <Reward>0.00</Reward>
            <Voucher>0.00</Voucher>
            <CloudTicketDenomination>0.00</CloudTicketDenomination>
            <Cash>88.00</Cash>
            <BillDetailTypeName>消费</BillDetailTypeName>
            <ConfigSet>
                <ConfigSet>
                    <Key>CPU(核)</Key>
                    <Code>CPU</Code>
                    <Value>8.0000</Value>
                </ConfigSet>
                <ConfigSet>
                    <Key>ebs_ssd3.0系统盘(G)</Key>
                    <Code>ebs_ssd3.0_systemDisks</Code>
                    <Value>200.0000</Value>
                </ConfigSet>
                <ConfigSet>
                    <Key>内存(G)</Key>
                    <Code>MEMORY</Code>
                    <Value>16.0000</Value>
                </ConfigSet>
                <ConfigSet>
                    <Key>套餐</Key>
                    <Code>pkg</Code>
                    <Value>N3.8B</Value>
                </ConfigSet>
            </ConfigSet>
            <ProviderSet>
                <ProviderSet>
                    <Key>操作系统</Key>
                    <Code>opstype</Code>
                    <Value>linux</Value>
                </ProviderSet>
            </ProviderSet>
            <ConsumeResources/>
            <ExtraSet>
                <ExtraSet>
		    <Key>内网IP</Key>
                    <Code>kvm_fixed_ip</Code>
                    <Value>10.0.32.13</Value>
                </ExtraSet>
                <ExtraSet>
		    <Key>公网IP</Key>
                    <Code>kvm_floating_ip</Code>
                    <Value>10.100.59.104</Value>
                </ExtraSet>
            </ExtraSet>
            <TagSet>
                <TagSet>
                    <Key>Qa自动化机器</Key>
                    <Value>勿动</Value>
                </TagSet>
            </TagSet>
        </SummaryOverview>
    </SummaryOverview>
</InstanceSummaryResponse>

• JSON格式

{
    "RequestId": "c5344294-9703-408d-9766-f8fa18faf6e2",
    "Email": "[email protected]",
    "PageNum": 1,
    "PageSize": 1,
    "TotalCount": 43,
    "CustomerId": 123456,
    "SummaryOverview": [
        {
             "BillsNo": "000000000020091",
            "CustomerBillMonth": "2021-12",
            "BillMonth": "2021-12",
            "ProductName": "云服务器",
            "ProductSubTyeName": "IO优化型I2",
            "InstanceId": "01f867ae-bab1-4be7-a307-d3498313b216",
            "InstanceName": "",
            "Currency": "CNY",
            "DetailBillStartTime": "2021-12-11 00:00:00",
            "DetailBillEndTime": "2022-01-10 23:59:59",
            "ServiceBillStartTime": "",
            "PayMode": "预付费",
            "BillTypeName": "包年包月",
            "RegionName": "华东2（上海）",
            "RegionCode": "cn-shanghai-3",
            "ZoneName": "",
            "ZoneCode": "",
            "ProjectId": 0,
            "ProjectName": "默认项目",
            "Duration": "",
            "Remark": "续费",
            "Cost": "88.00000000",
            "RealCost": "88.00",
            "Discount": "1.00",
            "Reward": "0.00",
            "Voucher": "0.00",
            "CloudTicketDenomination": "0.00",
            "Cash": "88.00",
            "BillDetailTypeName": "消费",
            "ConfigSet": [
                {
                    "Key": "CPU(核)",
                    "Code": "CPU",
                    "Value": "8.0000"
                },
                {
                    "Key": "ebs_ssd3.0系统盘(G)",
                    "Code": "ebs_ssd3.0_systemDisks",
                    "Value": "200.0000"
                },
                {
                    "Key": "内存(G)",
                    "Code": "MEMORY",
                    "Value": "16.0000"
                },
                {
                    "Key": "套餐",
                    "Code": "pkg",
                    "Value": "N3.8B"
                }
            ],
            "ProviderSet": [
                {
                    "Key": "操作系统",
                    "Code": "opstype",
                    "Value": "linux"
                }
            ],
            "ConsumeResources": [],
            "ExtraSet": [
                {
	 	    "Key": "内网IP",
                    "Code": "kvm_fixed_ip",
                    "Value": "10.0.32.13"
                },
                {
 		    "Key": "公网IP",
                    "Code": "kvm_floating_ip",
                    "Value": "10.100.59.104"
                }
            ],
            "TagSet": [
                {
                    "Key": "Qa自动化机器",
                    "Value": "勿动"
                }
            ]
        }
    ]
}