全部文档
当前文档
最近更新时间：2024-02-26 15:54:10
本文档描述如何获取实时账单数据。注意：只支持查询相同月份的数据。名称 | 类型 | 必须 | 长度限制(字符) | 参数格式 | 描述 |
|---|---|---|---|---|---|
Action | String | 是 | 确定值 | 操作接口名，系统规定参数，取值： | |
Version | String | 是 | 确定值 | API版本，固定为 | |
BillStartTime | String | 是 |
| 必选参数，账单开始时间，(查询结果包含该时间) | |
BillEndTime | String | 是 |
| 必选参数，账单结束时间，(查询结果不包含该时间，必须和BillStartTime是同一个月) | |
ProductCode | String | 否 | 可选参数，产品线对应的Code。eg. | ||
Page | Integer | 否 | 页码，默认值为1 | ||
Size | Integer | 否 | 每页数量，默认值：20，最大值：1000 |
名称 | 类型 | 描述 |
|---|---|---|
RequestId | String | 当前请求的RequestId |
PageNum | Integer | 页码 |
PageSize | Integer | 每页数量 |
TotalCount | Integer | 总记录数 |
BillSet | 账单汇总数据 |
错误代码(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"
}
]
}纯净模式