查询实例账单汇总

最近更新时间:2021-04-21 16:51:06

查看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 String 客户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>0442ae95-223e-47e7-b8fa-3ecb940082f8</RequestId>
    <Email>[email protected]</Email>
    <PageNum>1</PageNum>
    <PageSize>1</PageSize>
    <TotalCount>43</TotalCount>
    <CustomerId>123456</CustomerId>
    <SummaryOverview>
        <SummaryOverview>
            <BillsNo>000000000552791</BillsNo>
            <CustomerBillMonth>2020-06</CustomerBillMonth>
            <BillMonth>2020-06</BillMonth>
            <ProductName>云服务器</ProductName>
            <ProductSubTyeName>通用型N3</ProductSubTyeName>
            <InstanceId>32ee9517-6ef5-4f3c-b702-219e712a3608</InstanceId>
            <InstanceName>KscPlatformQa</InstanceName>
            <Currency>CNY</Currency>
            <DetailBillStartTime>2020-06-01 00:00:00</DetailBillStartTime>
            <DetailBillEndTime>2020-06-30 23:59:59</DetailBillEndTime>
            <ServiceBillStartTime>2019-02-26 10:50:45</ServiceBillStartTime>
            <PayMode>后付费</PayMode>
            <BillTypeName>按量付费(按日月结)</BillTypeName>
            <RegionName>华东1(上海)</RegionName>
            <ZoneName>可用区A</ZoneName>
            <ProjectName>kvmProject</ProjectName>
            <Duration>2592000</Duration>
            <Remark></Remark>
            <Cost>856.000000</Cost>
            <RealCost>642.000000</RealCost>
            <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>kvm_fixed_ip</Key>
                    <Value>10.0.32.13</Value>
                </ExtraSet>
                <ExtraSet>
                    <Key>kvm_floating_ip</Key>
                    <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": "000000000552791",
            "CustomerBillMonth": "2020-06",
            "BillMonth": "2020-06",
            "ProductName": "云服务器",
            "ProductSubTyeName": "通用型N3",
            "InstanceId": "32ee9517-6ef5-4f3c-b702-219e712a3608",
            "InstanceName": "KscPlatformQa",
            "Currency": "CNY",
            "DetailBillStartTime": "2020-06-01 00:00:00",
            "DetailBillEndTime": "2020-06-30 23:59:59",
            "ServiceBillStartTime": "2019-02-26 10:50:45",
            "PayMode": "后付费",
            "BillTypeName": "按量付费(按日月结)",
            "RegionName": "华东1(上海)",
            "ZoneName": "可用区A",
            "ProjectName": "kvmProject",
            "Duration": "2592000",
            "Remark": "",
            "Cost": "856.000000",
            "RealCost": "642.000000",
            "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": "kvm_fixed_ip",
                    "Value": "10.0.32.13"
                },
                {
                    "Key": "kvm_floating_ip",
                    "Value": "10.100.59.104"
                }
            ],
            "TagSet": [
                {
                    "Key": "Qa自动化机器",
                    "Value": "勿动"
                }
            ]
        }
    ]
}

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

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

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

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

更多建议

0/200

评价建议不能为空

提交成功!

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

问题反馈