查询实例账单汇总

最近更新时间:2022-06-22 19:53:21

查看PDF

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": "勿动"
                }
            ]
        }
    ]
}

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈