forked from docs/doc-exports
Li, Qiao
6c7c1c9d99
Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com> Co-authored-by: Li, Qiao <qiaoli@huawei.com> Co-committed-by: Li, Qiao <qiaoli@huawei.com>
242 lines
15 KiB
HTML
242 lines
15 KiB
HTML
<a name="antiddos_02_0027"></a><a name="antiddos_02_0027"></a>
|
|
|
|
<h1 class="topictitle1">Querying Weekly Defense Statistics</h1>
|
|
<div id="body42538710"><div class="section" id="antiddos_02_0027__section63597034"><h4 class="sectiontitle">Functions</h4><p class="MsoNormal" id="antiddos_02_0027__p23083503">This API allows you to query weekly defense statistics about all your IP addresses, including the number of intercepted DDoS attacks, number of attacks, and ranking by the number of attacks. Currently, you can query weekly statistics up to four weeks before the current time. Data older than four weeks cannot be queried.</p>
|
|
</div>
|
|
<div class="section" id="antiddos_02_0027__section35502400"><h4 class="sectiontitle">URI</h4><ul id="antiddos_02_0027__ul57824424"><li id="antiddos_02_0027__li50657768">URI format<p id="antiddos_02_0027__p37428884152022"><a name="antiddos_02_0027__li50657768"></a><a name="li50657768"></a>GET /v1/{project_id}/antiddos/weekly</p>
|
|
<div class="note" id="antiddos_02_0027__note9638516"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="antiddos_02_0027__en-us_topic_0037365554_p1004464">You can use <span class="parmvalue" id="antiddos_02_0027__parmvalue174132342487"><b>?</b></span> and <span class="parmvalue" id="antiddos_02_0027__parmvalue341423410483"><b>&</b></span> behind the URI to add query conditions, as shown in the request example.</p>
|
|
</div></div>
|
|
</li></ul>
|
|
<ul id="antiddos_02_0027__ul42522357"><li id="antiddos_02_0027__li47156901">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0027__table21758931" frame="border" border="1" rules="all"><thead align="left"><tr id="antiddos_02_0027__row3371364"><th align="left" class="cellrowborder" valign="top" width="22.68%" id="mcps1.3.2.3.1.1.1.5.1.1"><p id="antiddos_02_0027__p4645057">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.689999999999998%" id="mcps1.3.2.3.1.1.1.5.1.2"><p id="antiddos_02_0027__p40705318">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="13.309999999999999%" id="mcps1.3.2.3.1.1.1.5.1.3"><p id="antiddos_02_0027__p8796476">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="44.32%" id="mcps1.3.2.3.1.1.1.5.1.4"><p id="antiddos_02_0027__p41425962">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="antiddos_02_0027__row62092003153657"><td class="cellrowborder" valign="top" width="22.68%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="antiddos_02_0027__p312432915377">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.689999999999998%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="antiddos_02_0027__p5174406715377">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="13.309999999999999%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="antiddos_02_0027__p3051988115377">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="44.32%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="antiddos_02_0027__p5619133315377">User ID</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="antiddos_02_0027__section51086148"><h4 class="sectiontitle">Request</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0027__table4679845412" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="antiddos_02_0027__row468410444120"><th align="left" class="cellrowborder" valign="top" width="22.682268226822682%" id="mcps1.3.3.2.2.5.1.1"><p id="antiddos_02_0027__p2685164124115">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.18181818181818%" id="mcps1.3.3.2.2.5.1.2"><p id="antiddos_02_0027__p26879419416">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.13161316131613%" id="mcps1.3.3.2.2.5.1.3"><p id="antiddos_02_0027__p176891647414">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="43.004300430043%" id="mcps1.3.3.2.2.5.1.4"><p id="antiddos_02_0027__p126913434120">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="antiddos_02_0027__row1169917434116"><td class="cellrowborder" valign="top" width="22.682268226822682%" headers="mcps1.3.3.2.2.5.1.1 "><p id="antiddos_02_0027__p1769954144120">period_start_date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.18181818181818%" headers="mcps1.3.3.2.2.5.1.2 "><p id="antiddos_02_0027__p870114164120">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.13161316131613%" headers="mcps1.3.3.2.2.5.1.3 "><p id="antiddos_02_0027__p970212464115">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.004300430043%" headers="mcps1.3.3.2.2.5.1.4 "><p id="antiddos_02_0027__p8703164124118">Start date of a seven-day period</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="antiddos_02_0027__section57122151"><h4 class="sectiontitle">Response</h4><ul id="antiddos_02_0027__ul36643426"><li id="antiddos_02_0027__li61355386">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0027__table15327568" frame="border" border="1" rules="all"><thead align="left"><tr id="antiddos_02_0027__row24486356"><th align="left" class="cellrowborder" valign="top" width="28.599999999999998%" id="mcps1.3.4.2.1.1.1.4.1.1"><p id="antiddos_02_0027__p37237828">Name</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="22.42%" id="mcps1.3.4.2.1.1.1.4.1.2"><p id="antiddos_02_0027__p63474072">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="48.980000000000004%" id="mcps1.3.4.2.1.1.1.4.1.3"><p id="antiddos_02_0027__p41126201">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="antiddos_02_0027__row42887950"><td class="cellrowborder" valign="top" width="28.599999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0027__p51371903">ddos_intercept_times</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="22.42%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0027__p2142367152712">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.980000000000004%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0027__p30346328">Number of DDoS attacks blocked in a week</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0027__row4681502"><td class="cellrowborder" valign="top" width="28.599999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0027__p43657358">weekdata</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="22.42%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0027__p46585119">Data structure</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.980000000000004%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0027__p15298296">Number of attacks in a week</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0027__row3466944"><td class="cellrowborder" valign="top" width="28.599999999999998%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0027__p12387033">top10</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="22.42%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0027__p63825615">Data structure</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.980000000000004%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0027__p2492297">Top 10 attacked IP addresses</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="antiddos_02_0027__ul549487"><li id="antiddos_02_0027__li4945391">Data structure description of <strong id="antiddos_02_0027__b84235270695528">weekdata</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0027__table44508523" frame="border" border="1" rules="all"><thead align="left"><tr id="antiddos_02_0027__row13604004"><th align="left" class="cellrowborder" valign="top" width="37.34%" id="mcps1.3.4.3.1.2.1.4.1.1"><p id="antiddos_02_0027__p28182506">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25.540000000000003%" id="mcps1.3.4.3.1.2.1.4.1.2"><p id="antiddos_02_0027__p20504736">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="37.12%" id="mcps1.3.4.3.1.2.1.4.1.3"><p id="antiddos_02_0027__p50270944">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="antiddos_02_0027__row45414681"><td class="cellrowborder" valign="top" width="37.34%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0027__p54710514">ddos_intercept_times</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.540000000000003%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0027__p53636340152723">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37.12%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0027__p25189967">Number of DDoS attacks blocked</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0027__row25383117"><td class="cellrowborder" valign="top" width="37.34%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0027__p42766607">ddos_blackhole_times</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.540000000000003%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0027__p65381003152726">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37.12%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0027__p35618305">Number of DDoS black holes</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0027__row52129291"><td class="cellrowborder" valign="top" width="37.34%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0027__p61723024">max_attack_bps</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.540000000000003%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0027__p53706368152730">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37.12%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0027__p4321123">Maximum attack traffic</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0027__row38890115"><td class="cellrowborder" valign="top" width="37.34%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0027__p63091573">max_attack_conns</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.540000000000003%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0027__p58619775152733">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37.12%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0027__p48619368">Maximum number of attack connections</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0027__row34921133"><td class="cellrowborder" valign="top" width="37.34%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0027__p10039559">period_start_date</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25.540000000000003%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0027__p35756461">Long integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="37.12%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0027__p10592200">Start time</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="antiddos_02_0027__ul52661876"><li id="antiddos_02_0027__li4194840">Data structure description of <strong id="antiddos_02_0027__b1759975797">top10</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0027__table37753560" frame="border" border="1" rules="all"><thead align="left"><tr id="antiddos_02_0027__row63016113"><th align="left" class="cellrowborder" valign="top" width="33.12331233123312%" id="mcps1.3.4.4.1.2.1.4.1.1"><p id="antiddos_02_0027__p4031547">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.561856185618563%" id="mcps1.3.4.4.1.2.1.4.1.2"><p id="antiddos_02_0027__p10089924">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="48.31483148314832%" id="mcps1.3.4.4.1.2.1.4.1.3"><p id="antiddos_02_0027__p11977491">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="antiddos_02_0027__row30652703"><td class="cellrowborder" valign="top" width="33.12331233123312%" headers="mcps1.3.4.4.1.2.1.4.1.1 "><p id="antiddos_02_0027__p66949839">floating_ip_address</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.561856185618563%" headers="mcps1.3.4.4.1.2.1.4.1.2 "><p id="antiddos_02_0027__p30379836">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.31483148314832%" headers="mcps1.3.4.4.1.2.1.4.1.3 "><p id="antiddos_02_0027__p44847690">EIP</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0027__row976031"><td class="cellrowborder" valign="top" width="33.12331233123312%" headers="mcps1.3.4.4.1.2.1.4.1.1 "><p id="antiddos_02_0027__p11949699">times</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.561856185618563%" headers="mcps1.3.4.4.1.2.1.4.1.2 "><p id="antiddos_02_0027__p40695790152738">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.31483148314832%" headers="mcps1.3.4.4.1.2.1.4.1.3 "><p id="antiddos_02_0027__p48211888">Number of DDoS attacks intercepted, including cleaning operations and black holes</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="antiddos_02_0027__section13582258553"><h4 class="sectiontitle">Example</h4><ul id="antiddos_02_0027__ul178811332182913"><li id="antiddos_02_0027__li966416362293">Example request<pre class="codeblock" id="antiddos_02_0027__codeblock13342439152134">GET /v1/67641fe6886f43fcb78edbbf0ad0b99f/antiddos/weekly?period_start_date=1006510306</pre>
|
|
</li></ul>
|
|
</div>
|
|
<ul id="antiddos_02_0027__ul18002514557"><li id="antiddos_02_0027__li5801425155511">Example response<pre class="screen" id="antiddos_02_0027__screen78052515514">{
|
|
"ddos_intercept_times": 23,
|
|
"weekdata": [
|
|
{
|
|
"ddos_intercept_times": 0,
|
|
"ddos_blackhole_times": 0,
|
|
"max_attack_bps": 0,
|
|
"max_attack_conns": 0,
|
|
"period_start_date": 1474214461651
|
|
},
|
|
{
|
|
"ddos_intercept_times": 0,
|
|
"ddos_blackhole_times": 0,
|
|
"max_attack_bps": 0,
|
|
"max_attack_conns": 0,
|
|
"period_start_date": 1474300861651
|
|
},
|
|
{
|
|
"ddos_intercept_times": 0,
|
|
"ddos_blackhole_times": 0,
|
|
"max_attack_bps": 0,
|
|
"max_attack_conns": 0,
|
|
"period_start_date": 1474387261651
|
|
},
|
|
{
|
|
"ddos_intercept_times": 0,
|
|
"ddos_blackhole_times": 0,
|
|
"max_attack_bps": 0,
|
|
"max_attack_conns": 0,
|
|
"period_start_date": 1474473661651
|
|
},
|
|
{
|
|
"ddos_intercept_times": 0,
|
|
"ddos_blackhole_times": 0,
|
|
"max_attack_bps": 0,
|
|
"max_attack_conns": 0,
|
|
"period_start_date": 1474560061651
|
|
},
|
|
{
|
|
"ddos_intercept_times": 2,
|
|
"ddos_blackhole_times": 0,
|
|
"max_attack_bps": 16375,
|
|
"max_attack_conns": 0,
|
|
"period_start_date": 1474646461651
|
|
},
|
|
{
|
|
"ddos_intercept_times": 1,
|
|
"ddos_blackhole_times": 0,
|
|
"max_attack_bps": 0,
|
|
"max_attack_conns": 0,
|
|
"period_start_date": 1474732861651
|
|
}
|
|
],
|
|
"top10": [
|
|
{
|
|
"floating_ip_address": "192.168.44.69",
|
|
"times": 23
|
|
}
|
|
]
|
|
}</pre>
|
|
</li></ul>
|
|
<div class="section" id="antiddos_02_0027__section44337314"><h4 class="sectiontitle">Status Code</h4><p class="MsoNormal" id="antiddos_02_0027__p1824493">See <a href="antiddos_02_0031.html">Status Code</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="antiddos_02_0016.html">Anti-DDoS APIs</a></div>
|
|
</div>
|
|
</div>
|
|
|