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>
199 lines
15 KiB
HTML
199 lines
15 KiB
HTML
<a name="antiddos_02_0026"></a><a name="antiddos_02_0026"></a>
|
|
|
|
<h1 class="topictitle1">Querying Events of a Specified EIP</h1>
|
|
<div id="body32398645"><div class="section" id="antiddos_02_0026__section8942221"><h4 class="sectiontitle">Functions</h4><p id="antiddos_02_0026__p7044574">This API allows you to query events of a specified EIP in the last 24 hours. Events include cleaning and blackhole events, and the query delay is within five minutes.</p>
|
|
</div>
|
|
<div class="section" id="antiddos_02_0026__section13371131"><h4 class="sectiontitle">URI</h4><ul id="antiddos_02_0026__ul33739620"><li id="antiddos_02_0026__li35221125">URI format<p id="antiddos_02_0026__p66918637151611"><a name="antiddos_02_0026__li35221125"></a><a name="li35221125"></a>GET /v1/{project_id}/antiddos/{floating_ip_id}/logs</p>
|
|
<div class="note" id="antiddos_02_0026__note34338848"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="antiddos_02_0026__en-us_topic_0037365554_p1004464">You can use <span class="parmvalue" id="antiddos_02_0026__parmvalue174132342487"><b>?</b></span> and <span class="parmvalue" id="antiddos_02_0026__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_0026__ul29983308"><li id="antiddos_02_0026__li1414320">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0026__table12728880" frame="border" border="1" rules="all"><thead align="left"><tr id="antiddos_02_0026__row10054985"><th align="left" class="cellrowborder" valign="top" width="16.16%" id="mcps1.3.2.3.1.1.1.5.1.1"><p id="antiddos_02_0026__p9147475">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="18.23%" id="mcps1.3.2.3.1.1.1.5.1.2"><p id="antiddos_02_0026__p2748001">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="11.93%" id="mcps1.3.2.3.1.1.1.5.1.3"><p id="antiddos_02_0026__p21261532">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="53.68000000000001%" id="mcps1.3.2.3.1.1.1.5.1.4"><p id="antiddos_02_0026__p44462507">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="antiddos_02_0026__row4777932153447"><td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="antiddos_02_0026__p5325329815351">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.23%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="antiddos_02_0026__p1854992115351">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.93%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="antiddos_02_0026__p2614866515351">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.68000000000001%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="antiddos_02_0026__p3766710515351">User ID</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0026__row58945129153451"><td class="cellrowborder" valign="top" width="16.16%" headers="mcps1.3.2.3.1.1.1.5.1.1 "><p id="antiddos_02_0026__p1179431815351">floating_ip_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="18.23%" headers="mcps1.3.2.3.1.1.1.5.1.2 "><p id="antiddos_02_0026__p1581570215351">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="11.93%" headers="mcps1.3.2.3.1.1.1.5.1.3 "><p id="antiddos_02_0026__p600349915351">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="53.68000000000001%" headers="mcps1.3.2.3.1.1.1.5.1.4 "><p id="antiddos_02_0026__p1652139615351">ID corresponding to the EIP of a user</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="antiddos_02_0026__section9319803"><h4 class="sectiontitle">Request</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0026__table29941125133911" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="antiddos_02_0026__row1599716259399"><th align="left" class="cellrowborder" valign="top" width="24.80751924807519%" id="mcps1.3.3.2.2.5.1.1"><p id="antiddos_02_0026__p899972514398">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="16.348365163483653%" id="mcps1.3.3.2.2.5.1.2"><p id="antiddos_02_0026__p81162683919">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="15.508449155084492%" id="mcps1.3.3.2.2.5.1.3"><p id="antiddos_02_0026__p142192673917">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="43.335666433356664%" id="mcps1.3.3.2.2.5.1.4"><p id="antiddos_02_0026__p15411266392">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="antiddos_02_0026__row315126183915"><td class="cellrowborder" valign="top" width="24.80751924807519%" headers="mcps1.3.3.2.2.5.1.1 "><p id="antiddos_02_0026__p191614268395">limit</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.348365163483653%" headers="mcps1.3.3.2.2.5.1.2 "><p id="antiddos_02_0026__p141722613918">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.508449155084492%" headers="mcps1.3.3.2.2.5.1.3 "><p id="antiddos_02_0026__p181813267392">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.335666433356664%" headers="mcps1.3.3.2.2.5.1.4 "><p id="antiddos_02_0026__p112052610392">Limit of number of returned results or the maximum number of returned results of a query. The value ranges from 1 to 100, and this parameter is used together with the <span class="parmname" id="antiddos_02_0026__parmname769647905144327"><b>offset</b></span> parameter.</p>
|
|
<p id="antiddos_02_0026__p15201026193916">If neither <span class="parmname" id="antiddos_02_0026__parmname1938148844144344"><b>limit</b></span> nor <span class="parmname" id="antiddos_02_0026__parmname1749591609144344"><b>offset</b></span> is used, query results of all ECSs are returned.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0026__row1722192643912"><td class="cellrowborder" valign="top" width="24.80751924807519%" headers="mcps1.3.3.2.2.5.1.1 "><p id="antiddos_02_0026__p1223126183917">offset</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.348365163483653%" headers="mcps1.3.3.2.2.5.1.2 "><p id="antiddos_02_0026__p1024426113918">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.508449155084492%" headers="mcps1.3.3.2.2.5.1.3 "><p id="antiddos_02_0026__p152542616395">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.335666433356664%" headers="mcps1.3.3.2.2.5.1.4 "><p id="antiddos_02_0026__p122672614393">Offset. This parameter is valid only when used together with the <span class="parmname" id="antiddos_02_0026__parmname528723325144828"><b>limit</b></span> parameter.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0026__row19271126113914"><td class="cellrowborder" valign="top" width="24.80751924807519%" headers="mcps1.3.3.2.2.5.1.1 "><p id="antiddos_02_0026__p152811266391">sort_dir</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="16.348365163483653%" headers="mcps1.3.3.2.2.5.1.2 "><p id="antiddos_02_0026__p10305264390">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="15.508449155084492%" headers="mcps1.3.3.2.2.5.1.3 "><p id="antiddos_02_0026__p43118268396">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="43.335666433356664%" headers="mcps1.3.3.2.2.5.1.4 "><div class="p" id="antiddos_02_0026__p163112616393">Possible values:<ul id="antiddos_02_0026__ul15321626123912"><li id="antiddos_02_0026__li932926113910"><span class="parmvalue" id="antiddos_02_0026__parmvalue55512574414498"><b>desc</b></span>: indicates that query results are given and sorted by time in descending order.</li><li id="antiddos_02_0026__li17331026143918"><span class="parmvalue" id="antiddos_02_0026__parmvalue981466981144937"><b>asc</b></span>: indicates that query results are given and sorted by time in ascending order.</li></ul>
|
|
</div>
|
|
<p id="antiddos_02_0026__p23522617395">The default value is <span class="parmvalue" id="antiddos_02_0026__parmvalue103515263397"><b>desc</b></span>.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="antiddos_02_0026__section16769368"><h4 class="sectiontitle">Response</h4><ul id="antiddos_02_0026__ul11327425"><li id="antiddos_02_0026__li34837968">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0026__table45106256" frame="border" border="1" rules="all"><thead align="left"><tr id="antiddos_02_0026__row27807639"><th align="left" class="cellrowborder" valign="top" width="20.202020202020204%" id="mcps1.3.4.2.1.1.1.4.1.1"><p id="antiddos_02_0026__p37826280">Name</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="31.313131313131308%" id="mcps1.3.4.2.1.1.1.4.1.2"><p id="antiddos_02_0026__p44029805">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="48.484848484848484%" id="mcps1.3.4.2.1.1.1.4.1.3"><p id="antiddos_02_0026__p9644430">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="antiddos_02_0026__row43001397"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0026__p60561095">total</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="31.313131313131308%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0026__p43167711152327">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0026__p56873938">Total number of EIPs</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0026__row42103398"><td class="cellrowborder" valign="top" width="20.202020202020204%" headers="mcps1.3.4.2.1.1.1.4.1.1 "><p id="antiddos_02_0026__p54932079">logs</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="31.313131313131308%" headers="mcps1.3.4.2.1.1.1.4.1.2 "><p id="antiddos_02_0026__p20313449">Data structure</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="48.484848484848484%" headers="mcps1.3.4.2.1.1.1.4.1.3 "><p id="antiddos_02_0026__p34776700">List of events</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
<ul id="antiddos_02_0026__ul65449295"><li id="antiddos_02_0026__li52172744">Data structure description of <strong id="antiddos_02_0026__b84235270695528">logs</strong>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="antiddos_02_0026__table66901514" frame="border" border="1" rules="all"><thead align="left"><tr id="antiddos_02_0026__row55903933"><th align="left" class="cellrowborder" valign="top" width="29.79%" id="mcps1.3.4.3.1.2.1.4.1.1"><p id="antiddos_02_0026__p31924758">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="28.560000000000002%" id="mcps1.3.4.3.1.2.1.4.1.2"><p id="antiddos_02_0026__p11576397">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="41.65%" id="mcps1.3.4.3.1.2.1.4.1.3"><p id="antiddos_02_0026__p65272955">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="antiddos_02_0026__row52618006"><td class="cellrowborder" valign="top" width="29.79%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0026__p34200069">start_time</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.560000000000002%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0026__p41722625">Long integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="41.65%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0026__p24089437">Start time</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0026__row15478348"><td class="cellrowborder" valign="top" width="29.79%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0026__p45786662">end_time</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.560000000000002%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0026__p27018949">Long integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="41.65%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0026__p41051224">End time</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0026__row33916704"><td class="cellrowborder" valign="top" width="29.79%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0026__p62898512">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.560000000000002%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0026__p44557253152337">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="41.65%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><div class="p" id="antiddos_02_0026__p57309018">Defense status, the possible value of which is one of the following:<ul id="antiddos_02_0026__ul46019115"><li id="antiddos_02_0026__li11518859"><span class="parmvalue" id="antiddos_02_0026__parmvalue1506354986114925"><b>1</b></span>: indicates that traffic cleaning is underway.</li><li id="antiddos_02_0026__li36560874"><span class="parmvalue" id="antiddos_02_0026__parmvalue1400332350143613"><b>2</b></span>: indicates that traffic is discarded.</li></ul>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0026__row60612418"><td class="cellrowborder" valign="top" width="29.79%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0026__p10658788">trigger_bps</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.560000000000002%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0026__p15266258152342">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="41.65%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0026__p59436263">Traffic at the triggering point</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0026__row65164324"><td class="cellrowborder" valign="top" width="29.79%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0026__p43818926">trigger_pps</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.560000000000002%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0026__p57307436152346">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="41.65%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0026__p62941183">Packet rate at the triggering point</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="antiddos_02_0026__row29599739"><td class="cellrowborder" valign="top" width="29.79%" headers="mcps1.3.4.3.1.2.1.4.1.1 "><p id="antiddos_02_0026__p48768695">trigger_http_pps</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="28.560000000000002%" headers="mcps1.3.4.3.1.2.1.4.1.2 "><p id="antiddos_02_0026__p51299491152351">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="41.65%" headers="mcps1.3.4.3.1.2.1.4.1.3 "><p id="antiddos_02_0026__p39486963">HTTP request rate at the triggering point</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="antiddos_02_0026__section651413316549"><h4 class="sectiontitle">Example</h4><ul id="antiddos_02_0026__ul178811332182913"><li id="antiddos_02_0026__li966416362293">Example request<pre class="codeblock" id="antiddos_02_0026__codeblock7276728151829">GET /v1/67641fe6886f43fcb78edbbf0ad0b99f/antiddos/1df977c2-fdc6-4483-bc1c-ba46829f57b8/logs</pre>
|
|
</li></ul>
|
|
</div>
|
|
<ul id="antiddos_02_0026__ul155325313545"><li id="antiddos_02_0026__li3532163112542">Example response<pre class="screen" id="antiddos_02_0026__screen0532131205417">{
|
|
"total": 1,
|
|
"logs": [
|
|
{
|
|
"start_time": 1473217200000,
|
|
"end_time": 1473242400000,
|
|
"status": 1,
|
|
"trigger_bps": 51106,
|
|
"trigger_pps": 2600,
|
|
"trigger_http_pps": 3589
|
|
}
|
|
]
|
|
}</pre>
|
|
</li></ul>
|
|
<div class="section" id="antiddos_02_0026__section16706588"><h4 class="sectiontitle">Status Code</h4><p id="antiddos_02_0026__p16632209">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>
|
|
|