DescribePrepayBillTotal - 查询包年包月账单总览-云防火墙(Cloud Firewall)-阿里云帮助中心

查询包年包月2.0账单概览

接口说明

统计范围为该用户当前云防火墙实例，包括自购买之日起的所有数据。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-cloudfirewall:DescribePrepayBillTotal

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	语言, 枚举值。默认值: zh 可选值: en	zh
PageSize	integer	否	分页参数：每页显示条数，默认值 10。	10
CurrentPage	integer	否	分页查询时的页码。默认值为 1。	1
StartTime	string	是	查询开始时间，使用秒级时间戳。说明由于账单数据按日粒度聚合，该时间戳必须对应 CST (UTC+8) 时区的当日 00:00:00。若时间未对齐日界零点，可能无法查询到数据。	1656750960
EndTime	string	是	结束时间。使用秒级时间戳格式。说明由于账单数据按日粒度聚合，该时间戳必须对应 CST (UTC+8) 时区的当日 00:00:00。若时间未对齐日界零点，可能无法查询到数据。	1646063922
BillType	string	是	用户账单类型。本参数实际为必填项，未传时返回错误。取值如下所示： elastic_traffic:弹性流量 sdl:敏感数据泄漏检测流量枚举值： sdl : 敏感数据泄漏检测流量 elastic_traffic : 弹性流量	sdl

返回参数

名称	类型	描述	示例值
	object
TotalCount	integer	总数。	132
RequestId	string	请求 ID。	450D47F5-956E-543E-8502-***********
BillList	array<object>	账单列表，以天为维度。
	object
InternetTrafficBandwidth	number	互联网流量带宽，单位 Gbps。	10
NatTrafficBandwidth	number	Nat 流量带宽，单位 Gbps。	10
VpcTrafficBandwidth	number	Vpc 流量带宽，单位 Gbps。	10
OverflowTime	integer	当天带宽最大（互联网+Vpc+Nat）时对应的时间戳。	1761588300
DefaultBandwidth	integer	版本默认带宽，单位：Mbps。	200
ExtensionBandwidth	integer	拓展带宽，单位：Mbps。	10
TemporaryBandwidth	integer	临时升级带宽，单位：Mbps。	0
ElasticBandwidth	integer	弹性带宽值，单位：Mbps。	200
MonthlyRemainingFreeTraffic	number	月度敏感数据免费检测流量，单位 GB。	10
DailyDetectionTraffic	number	当日敏感数据检测流量。	8
BilledDetectionTraffic	number	敏感数据泄漏检测实际出账流量。	5
StartTime	integer	当天开始时间。使用秒级时间戳格式表示。	1761580800
EndTime	integer	当天结束时间。使用秒级时间戳格式表示。	1761667200
DailyOverflowTraffic	number	当日弹性总流量，单位 GB。	10

示例

正常返回示例

JSON格式

{
  "TotalCount": 132,
  "RequestId": "450D47F5-956E-543E-8502-***********",
  "BillList": [
    {
      "InternetTrafficBandwidth": 10,
      "NatTrafficBandwidth": 10,
      "VpcTrafficBandwidth": 10,
      "OverflowTime": 1761588300,
      "DefaultBandwidth": 200,
      "ExtensionBandwidth": 10,
      "TemporaryBandwidth": 0,
      "ElasticBandwidth": 200,
      "MonthlyRemainingFreeTraffic": 10,
      "DailyDetectionTraffic": 8,
      "BilledDetectionTraffic": 5,
      "StartTime": 1761580800,
      "EndTime": 1761667200,
      "DailyOverflowTraffic": 10
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	ErrorAliUid	The aliuid is invalid.	无效的用户id
400	ErrorNotPostpayUser	not Postpay User.	非按量付费用户。
400	ErrorTimeError	The time is invalid.	时间选择错误
400	ErrorPageNo	Either page number or page size is invalid.	无效的page number 或者 page size
400	ErrorDBSelectError	A database select error occurred.	内部错误：数据库查询错误
400	ErrorMarshalJSON	internal error.	内部错误。
400	ErrorParamsInvalid	Invalid Params	无效的参数
400	ErrorDbFailed	Query db failed.	DB访问错误。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。