查询分节点计费方案用户的带宽用量
更新时间：2021-08-02
接口描述
本接口用于查询分节点计费方案用户的带宽用量数据。
请求结构
Plain Text
1GET /v1/usage/traffic/region HTTP/1.1
2Host: bec.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| beginDate | String | 是 | Query参数 | 查询开始日期，格式“2020-10-01”。月结方案用户应设置为查询月份的第一天。 |
| endDate | String | 是 | Query参数 | 查询结束日期，格式“2020-10-31”。月结方案用户应设置为查询月份的最后一天，最长时间跨度31天。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| accountId | String | 账户ID |
| chargeScheme | String | 计费方案类型 |
| timeSpan | Map<String,String> | 查询时间，包含beginDate和endDate |
| queryTime | Long | 接口调用时间 |
| graphData | Map<String,Map<String,GraphData> | 带宽用量数据 |
| topBandwidth | Map<String,List<DataUnit> | 带宽峰值数据 |
| monthly95Bandwidth | Map<String,List<DataUnit> | 月95峰带宽数据，适用于月95峰-分节点计费方案用户 |
| monthlyTop4Bandwidth | Map<String,List<DataUnit> | 月第四峰带宽数据，适用于月第四峰-分节点计费方案用户 |
错误码
请参照错误返回章节的内容。
请求示例
Plain Text
1GET /v1/usage/traffic/sum HTTP/1.1
2Host: bec.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2021-06-08T03:28:09Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4{
5 "beginDate": "2020-10-01",
6 "endDate": "2020-10-31"
7}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3Date: Wed, 08 Jul 2021 03:28:11 GMT
4x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5Server: BWS
6{
7 "accountId": "accountId",
8 "chargeScheme": "PeakBandwidth_Percent_95_part",
9 "queryTime": 1605322615000,
10 "timeSpan": {
11 "beginDate": "2020-10-01",
12 "endDate": "2020-10-31"
13 },
14 "graphData": {
15 "EAST_CHINA": {
16 "EAST_CHINA-GUANGZHOU-CHINA_UNICOM": {
17 "count": 30,
18 "dataList": [{
19 "amount": 123431.21441232,
20 "unit": "bps",
21 "timestamp": 1602845549040
22 },
23 {
24 "amount": 21431.34133333,
25 "unit": "bps",
26 "timestamp": 1602845549040
27 },
28 {
29 "amount": 21431.34133333,
30 "unit": "bps",
31 "timestamp": 1602845549040
32 }
33 ]
34 }
35 },
36 "NORTH_CHINA": {
37 "NORTH_CHINA-BEIJING-CHINA_UNICOM": {
38 "count": 30,
39 "dataList": [{
40 "amount": 123431.21441232,
41 "unit": "bps",
42 "timestamp": 1602845549040
43 },
44 {
45 "amount": 21431.34133333,
46 "unit": "bps",
47 "timestamp": 1602845549040
48 },
49 {
50 "amount": 21431.34133333,
51 "unit": "bps",
52 "timestamp": 1602845549040
53 }
54 ]
55 },
56 "NORTH_CHINA-QINGDAO-TRIPLE_LINE": {
57 "count": 30,
58 "dataList": [{
59 "amount": 123431.21441232,
60 "unit": "bps",
61 "timestamp": 1602845549040
62 },
63 {
64 "amount": 21431.34133333,
65 "unit": "bps",
66 "timestamp": 1602845549040
67 },
68 {
69 "amount": 21431.34133333,
70 "unit": "bps",
71 "timestamp": 1602845549040
72 }
73 ]
74 }
75 },
76 "SOUTH_CHINA": {
77 "SOUTH_CHINA-GUANGZHOU-CHINA_MOBILE": {
78 "count": 30,
79 "dataList": [{
80 "amount": 123431.21441232,
81 "unit": "bps",
82 "timestamp": 1602845549040
83 },
84 {
85 "amount": 21431.34133333,
86 "unit": "bps",
87 "timestamp": 1602845549040
88 },
89 {
90 "amount": 21431.34133333,
91 "unit": "bps",
92 "timestamp": 1602845549040
93 }
94 ]
95 }
96 }
97 },
98 "topBandwidth": {
99 "EAST_CHINA-GUANGZHOU-CHINA_UNICOM": [{
100 "amount": 21431.34133333,
101 "unit": "bps",
102 "timestamp": 1602845549040
103 }],
104 "NORTH_CHINA-BEIJING-CHINA_UNICOM": [{
105 "amount": 21431.34133333,
106 "unit": "bps",
107 "timestamp": 1602845549040
108 }],
109 "SOUTH_CHINA-GUANGZHOU-CHINA_MOBILE": [{
110 "amount": 21431.34133333,
111 "unit": "bps",
112 "timestamp": 1602845549040
113 }],
114 "NORTH_CHINA-QINGDAO-TRIPLE_LINE": [{
115 "amount": 21431.34133333,
116 "unit": "bps",
117 "timestamp": 1602845549040
118 }]
119 },
120 "monthly95Bandwidth": {
121 "EAST_CHINA-GUANGZHOU-CHINA_UNICOM": [{
122 "amount": 21431.34133333,
123 "unit": "bps",
124 "timestamp": 1602845549040
125 }],
126 "NORTH_CHINA-BEIJING-CHINA_UNICOM": [{
127 "amount": 21431.34133333,
128 "unit": "bps",
129 "timestamp": 1602845549040
130 }],
131 "SOUTH_CHINA-GUANGZHOU-CHINA_MOBILE": [{
132 "amount": 21431.34133333,
133 "unit": "bps",
134 "timestamp": 1602845549040
135 }],
136 "NORTH_CHINA-QINGDAO-TRIPLE_LINE": [{
137 "amount": 21431.34133333,
138 "unit": "bps",
139 "timestamp": 1602845549040
140 }]
141 }
142
143}Model对象定义
GraphData
| 参数名称 | 类型 | 描述 |
|---|---|---|
| count | int | 数据点数量 |
| dataList | List<DataUnit> | 带宽数据 |
DataUnit
| 参数名称 | 类型 | 描述 |
|---|---|---|
| amount | BigDecimal | 带宽数值 |
| unit | String | 带宽单位 |
| timestamp | Long | 带宽时间点 |