查询流水账单列表
1. 接口描述
调用 DescribeFlowBills 查询资源的流水账单列表。
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：DescribeFlowBills |
| RegionCode | String | 否 | 账单资源所属的地域，您可以调用 DescribeRegionConfig 查看可选的地域列表 |
| ResourceUUID | String | 否 | 资源ID |
| ProductType | String | 否 | 产品类型， 取值参考枚举：产品类型 |
| BillStatus | String | 否 | 账单状态，取值参考枚举：账单状态 |
| BillBeginDate | String | 否 | 账单开始时间，格式为：yyyy-MM-dd HH:mm:ss。 |
| BillEndDate | String | 否 | 账单结束时间，格式为：yyyy-MM-dd HH:mm:ss。 |
| PageNumber | integer | 否 | 流水账单列表的页码， 起始值：1 默认值：1 |
| PageSize | integer | 否 | 分页查询时设置的每页行数， 最大值：50 默认值：10 |
3. 返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| Items | Array[ FlowBillInfo ] | 流水账单列表 |
| RequestId | String | 请求ID |
| Total | Integer | 流水账单总数 |
4. 示例
请求示例
https://openapi.kaopuyun.com/?AccessKeyId=sz0000ei53aw
&Action=DescribeFlowBills
&Format=JSON
&BillBeginDate=2023-02-01 00:00:00
&SignatureMethod=HMAC-SHA1
&SignatureNonce=76a5d5e7-0992-462d-9a26-916650eca00f
&SignatureVersion=1.0
&Timestamp=2023-03-09T07%3A33%3A56Z
&Version=2014-05-26
&Signature=LH5UYKO7k%2FeQlyLH3p169uyRKyU%3D
&ProductType=OWN_ECS
&PageNumber=1
&PageSize=10
正常返回示例
{
"Total":1227,
"Items":[
{
"PayPrice":21.45,
"BillType":"RENEW_PRODUCT",
"BillUUID":"s70000000rfm",
"BillBeginTime":"2022-10-25 10:15",
"TotalPrice":21.45,
"ProductType":"BWP",
"PaymentType":"PRE_PAID",
"PayTime":"2022-10-25 10:15",
"BillEndTime":"2022-10-31 23:59"
},{
"PayPrice":25.0,
"BillType":"RENEW_PRODUCT",
"BillUUID":"s70000000rfk",
"BillBeginTime":"2022-10-26 00:00",
"TotalPrice":25.0,
"ProductType":"OWN_EIP",
"PaymentType":"PRE_PAID",
"PayTime":"2022-10-25 10:00",
"BillEndTime":"2022-11-25 23:59"
},{
"PayPrice":25.0,
"BillType":"RENEW_PRODUCT",
"BillUUID":"s70000000rfi",
"BillBeginTime":"2022-10-26 00:00",
"TotalPrice":25.0,
"ProductType":"OWN_EIP",
"PaymentType":"PRE_PAID",
"PayTime":"2022-10-25 10:00",
"BillEndTime":"2022-11-25 23:59"
}
],
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| DescribeFlowBillsFail | 查询流水账单列表失败:xxx |
| ProductTypeIsInvalid | ProductType无效的产品类型 |
| ValueNotSupported | BillStatus参数不合法 |