金山云-文档中心-获取实时账单

DescribeBills(获取实时账单)

本文档描述如何获取实时账单数据。注意：只支持查询相同月份的数据。

请求参数

名称	类型	必须	长度限制(字符)	参数格式	描述
Action	String	是	确定值		操作接口名，系统规定参数，取值：`DescribeBills`
Version	String	是	确定值		API版本，固定为`2019-07-19`
BillStartTime	String	是		`yyyy-MM-dd HH:mm:ss`	必选参数，账单开始时间，(查询结果包含该时间)
BillEndTime	String	是		`yyyy-MM-dd HH:mm:ss`	必选参数，账单结束时间，(查询结果不包含该时间，必须和BillStartTime是同一个月)
ProductCode	String	否			可选参数，产品线对应的Code。eg. `KEC`，不传获取所有产品类型的账单,取值可以参考产品线映射关系
Page	Integer	否			页码，默认值为1
Size	Integer	否			每页数量，默认值：20，最大值：1000

返回元素（调用成功）

名称	类型	描述
RequestId	String	当前请求的RequestId
PageNum	Integer	页码
PageSize	Integer	每页数量
TotalCount	Integer	总记录数
BillSet	DescribeBills 数组	账单汇总数据

错误码（调用不成功）

错误代码(Code)	错误消息(Message)	HTTP 状态码	中文描述（语义）
InvalidParameter	There is one or more invalid parameter(%s).	400	参数%s错误,具体参数名在%s说明
MissingParameter	A required parameter for the specified action is not supplied.	400	忘记必选参数%s,具体参数名在%s说明

示例（调用成功）

请求示例

http://krtpay.api.ksyun.com/?Action=DescribeBills
&Version=2019-07-19
&BillStartTime=2019-07-12 20:00:00
&BillEndTime=2019-07-16 00:00:00
&ProductCode=VM_GROUP
&公共请求参数

返回示例

XML格式

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DescribeBillsResponse>
    	<RequestId>976e913d-1db9-42d1-8251-cdad4f7c1005</RequestId>
    	<PageNum>1</PageNum>
    	<PageSize>1</PageSize>
    	<TotalCount>88</TotalCount>
    	<BillSet>
        	<Item>
            	<AccountPeriod>2019071523</AccountPeriod>
            	<BillsNo>ZD20000747601002782019071523300000000000</BillsNo>
            	<CustomerId>2000074760</CustomerId>
            	<BillsType>3</BillsType>
            	<BillsTypeName>按小时</BillsTypeName>
            	<ProductCode>VM_GROUP</ProductCode>
            	<ProductName>云主机</ProductName>
            	<Project>278</Project>
            	<ProjectName>hanziguoproject</ProjectName>
            	<BillStartTime>2019-07-15 23:00:00</BillStartTime>
            	<BillEndTime>2019-07-16 00:00:00</BillEndTime>
            	<Cost>0.45</Cost>
            	<RealCost>0.45</RealCost>
        	</Item>
    	</BillSet>
</DescribeBillsResponse>

JSON格式

{
    	"RequestId": "60a9f62e-51b3-4ec5-8e9d-12cb78343014",
    	"PageNum": 1,
    	"PageSize": 1,
    	"TotalCount": 88,
    	"BillSet": [
        	{
            	"BillsNo": "ZD20000747601002782019071523300000000000",
            	"BillsType": 3,
            	"BillsTypeName": "按小时",
            	"Project": 278,
            	"ProjectName": "hanziguoproject",
            	"ProductName": "云主机",
            	"ProductCode": "VM_GROUP",
            	"Cost": "0.45",
            	"RealCost": "0.45",
            	"BillStartTime": "2019-07-15 23:00:00",
            	"BillEndTime": "2019-07-16 00:00:00", 
            	"CustomerId": 2000074760,
            	"AccountPeriod": "2019071523"
        	}
    	]
}