forked from docs/doc-exports
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: Li, Qiao <qiaoli@huawei.com> Co-committed-by: Li, Qiao <qiaoli@huawei.com>
277 lines
22 KiB
HTML
277 lines
22 KiB
HTML
<a name="waf_02_0051"></a><a name="waf_02_0051"></a>
|
|
|
|
<h1 class="topictitle1">Querying a Precise Protection Rule</h1>
|
|
<div id="body55300286"><div class="section" id="waf_02_0051__section21481960"><h4 class="sectiontitle">Function Description</h4><p class="msonormal" id="waf_02_0051__p50138143">This API is used to query details about a precise protection rule.</p>
|
|
</div>
|
|
<div class="section" id="waf_02_0051__section59119916"><h4 class="sectiontitle">URI</h4><ul id="waf_02_0051__ul34657777"><li id="waf_02_0051__li43484539">URI format<p id="waf_02_0051__p55816539"><a name="waf_02_0051__li43484539"></a><a name="li43484539"></a>GET /v1/{project_id}/waf/policy/{policy_id}/custom/{custom_rule_id}</p>
|
|
</li><li id="waf_02_0051__li32586809">Parameter description
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="waf_02_0051__table24845830" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path parameters</caption><thead align="left"><tr id="waf_02_0051__row58718317"><th align="left" class="cellrowborder" valign="top" width="30.91%" id="mcps1.3.2.2.2.1.2.5.1.1"><p id="waf_02_0051__p58563217"><strong id="waf_02_0051__b84917498919">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20.62%" id="mcps1.3.2.2.2.1.2.5.1.2"><p id="waf_02_0051__p46000130"><strong id="waf_02_0051__b14704105013917">Mandatory</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="14.45%" id="mcps1.3.2.2.2.1.2.5.1.3"><p id="waf_02_0051__p35023015"><strong id="waf_02_0051__b196881652391">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="34.02%" id="mcps1.3.2.2.2.1.2.5.1.4"><p id="waf_02_0051__p18291944"><strong id="waf_02_0051__b5487135415915">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="waf_02_0051__row5252527"><td class="cellrowborder" valign="top" width="30.91%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="waf_02_0051__p22801505">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="waf_02_0051__p34982632">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.45%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="waf_02_0051__p15020972">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="34.02%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="waf_02_0051__p8739220">Specifies the project ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row11544121"><td class="cellrowborder" valign="top" width="30.91%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="waf_02_0051__p62658643">policy_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="waf_02_0051__p42185350">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.45%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="waf_02_0051__p61570169">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="34.02%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="waf_02_0051__p21127764">Specifies the policy ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row55932152"><td class="cellrowborder" valign="top" width="30.91%" headers="mcps1.3.2.2.2.1.2.5.1.1 "><p id="waf_02_0051__p34210500">custom_rule_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20.62%" headers="mcps1.3.2.2.2.1.2.5.1.2 "><p id="waf_02_0051__p19587083">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="14.45%" headers="mcps1.3.2.2.2.1.2.5.1.3 "><p id="waf_02_0051__p43049911">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="34.02%" headers="mcps1.3.2.2.2.1.2.5.1.4 "><p id="waf_02_0051__p64490800">Specifies the ID of a precise protection rule.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li></ul>
|
|
</div>
|
|
<div class="section" id="waf_02_0051__section62317203"><h4 class="sectiontitle">Request</h4><p id="waf_02_0051__p210411286553">Request parameters</p>
|
|
<p class="msonormal" id="waf_02_0051__p56372317">None</p>
|
|
</div>
|
|
<div class="section" id="waf_02_0051__section23983916"><h4 class="sectiontitle">Response</h4><div class="p" id="waf_02_0051__p15205643145516">Response parameters
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="waf_02_0051__table21827061" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="waf_02_0051__row28265867"><th align="left" class="cellrowborder" valign="top" width="42.85571442855714%" id="mcps1.3.4.2.1.2.4.1.1"><p id="waf_02_0051__p7833851"><strong id="waf_02_0051__b7961684177">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="17.348265173482652%" id="mcps1.3.4.2.1.2.4.1.2"><p id="waf_02_0051__p30562167"><strong id="waf_02_0051__b15625111091710">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="39.796020397960206%" id="mcps1.3.4.2.1.2.4.1.3"><p id="waf_02_0051__p59616488"><strong id="waf_02_0051__b4657121220172">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="waf_02_0051__row66786352"><td class="cellrowborder" valign="top" width="42.85571442855714%" headers="mcps1.3.4.2.1.2.4.1.1 "><p id="waf_02_0051__p40985451">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.2.4.1.2 "><p id="waf_02_0051__p31487247">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.796020397960206%" headers="mcps1.3.4.2.1.2.4.1.3 "><p id="waf_02_0051__p330178">Specifies the ID of a precise protection rule.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row2971610"><td class="cellrowborder" valign="top" width="42.85571442855714%" headers="mcps1.3.4.2.1.2.4.1.1 "><p id="waf_02_0051__p39373866">policy_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.2.4.1.2 "><p id="waf_02_0051__p35166558">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.796020397960206%" headers="mcps1.3.4.2.1.2.4.1.3 "><p id="waf_02_0051__p29918943">Specifies the policy ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row835031"><td class="cellrowborder" valign="top" width="42.85571442855714%" headers="mcps1.3.4.2.1.2.4.1.1 "><p id="waf_02_0051__p528693">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.2.4.1.2 "><p id="waf_02_0051__p42824212">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.796020397960206%" headers="mcps1.3.4.2.1.2.4.1.3 "><p id="waf_02_0051__p46209180">Specifies the rule name.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row13229438"><td class="cellrowborder" valign="top" width="42.85571442855714%" headers="mcps1.3.4.2.1.2.4.1.1 "><p id="waf_02_0051__p64951573">time</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.2.4.1.2 "><p id="waf_02_0051__p26586089">Boolean</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.796020397960206%" headers="mcps1.3.4.2.1.2.4.1.3 "><p id="waf_02_0051__p126191914204">Specifies the effect time of the precise protection rule.</p>
|
|
<ul id="waf_02_0051__ul52563885311"><li id="waf_02_0051__li1525183805313"><span class="parmvalue" id="waf_02_0051__parmvalue19835124515359"><b>false</b></span>: The rule takes effect immediately.</li><li id="waf_02_0051__li179493215549"><span class="parmvalue" id="waf_02_0051__parmvalue1981124853520"><b>true</b></span>: The rule takes effect at the scheduled time.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row53906414"><td class="cellrowborder" valign="top" width="42.85571442855714%" headers="mcps1.3.4.2.1.2.4.1.1 "><p id="waf_02_0051__p4343448">start</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.2.4.1.2 "><p id="waf_02_0051__p16275035">Long</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.796020397960206%" headers="mcps1.3.4.2.1.2.4.1.3 "><p id="waf_02_0051__p43209438">Specifies the time when the precise protection rule takes effect.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row53340623"><td class="cellrowborder" valign="top" width="42.85571442855714%" headers="mcps1.3.4.2.1.2.4.1.1 "><p id="waf_02_0051__p25623189">end</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.2.4.1.2 "><p id="waf_02_0051__p62212465">Long</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.796020397960206%" headers="mcps1.3.4.2.1.2.4.1.3 "><p id="waf_02_0051__p6044872">Specifies the time when the precise protection rule expires.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row54403854"><td class="cellrowborder" valign="top" width="42.85571442855714%" headers="mcps1.3.4.2.1.2.4.1.1 "><p id="waf_02_0051__p44636076">conditions</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.2.4.1.2 "><p id="waf_02_0051__p58752378"><a href="#waf_02_0051__table15795105212399">Table 3</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.796020397960206%" headers="mcps1.3.4.2.1.2.4.1.3 "><p id="waf_02_0051__p61322144">Specifies the condition parameters.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row5087387"><td class="cellrowborder" valign="top" width="42.85571442855714%" headers="mcps1.3.4.2.1.2.4.1.1 "><p id="waf_02_0051__p9425218">action</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.2.4.1.2 "><p id="waf_02_0051__p25245222"><a href="#waf_02_0051__table11869252183917">Table 4</a></p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.796020397960206%" headers="mcps1.3.4.2.1.2.4.1.3 "><p id="waf_02_0051__p31597102">Specifies the protective action after the precise protection rule is matched.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row11511132"><td class="cellrowborder" valign="top" width="42.85571442855714%" headers="mcps1.3.4.2.1.2.4.1.1 "><p id="waf_02_0051__p59986482">priority</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.2.4.1.2 "><p id="waf_02_0051__p27066910">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.796020397960206%" headers="mcps1.3.4.2.1.2.4.1.3 "><p id="waf_02_0051__p44936069">Specifies the priority of a rule being executed. Smaller values correspond to higher priorities. If two rules are assigned with the same priority, the rule added earlier has higher priority. The value ranges from <strong id="waf_02_0051__b5870577417">0</strong> to <strong id="waf_02_0051__b1587657542">65535</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row1771443"><td class="cellrowborder" valign="top" width="42.85571442855714%" headers="mcps1.3.4.2.1.2.4.1.1 "><p id="waf_02_0051__p9269217">timestamp</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="17.348265173482652%" headers="mcps1.3.4.2.1.2.4.1.2 "><p id="waf_02_0051__p12609087">Long</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.796020397960206%" headers="mcps1.3.4.2.1.2.4.1.3 "><p id="waf_02_0051__p48098095">Specifies the time when a precise protection rule is added.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="waf_02_0051__table15795105212399"></a><a name="table15795105212399"></a><table cellpadding="4" cellspacing="0" summary="" id="waf_02_0051__table15795105212399" frame="border" border="1" rules="all"><caption><b>Table 3 </b><strong id="waf_02_0051__b4124110286">conditions</strong></caption><thead align="left"><tr id="waf_02_0051__row18801155273910"><th align="left" class="cellrowborder" valign="top" width="33.086691330866906%" id="mcps1.3.4.3.2.4.1.1"><p id="waf_02_0051__p680445263913"><strong id="waf_02_0051__b5232102016189">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="27.117288271172878%" id="mcps1.3.4.3.2.4.1.2"><p id="waf_02_0051__p8807552173910"><strong id="waf_02_0051__b1635554336">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="39.7960203979602%" id="mcps1.3.4.3.2.4.1.3"><p id="waf_02_0051__p11809552173910"><strong id="waf_02_0051__b1979232191810">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="waf_02_0051__row1981275223913"><td class="cellrowborder" valign="top" width="33.086691330866906%" headers="mcps1.3.4.3.2.4.1.1 "><p id="waf_02_0051__p1481416526399">category</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.117288271172878%" headers="mcps1.3.4.3.2.4.1.2 "><p id="waf_02_0051__p181717528397">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.7960203979602%" headers="mcps1.3.4.3.2.4.1.3 "><p id="waf_02_0051__p78191552193916">Specifies the condition type. The value can be <strong id="waf_02_0051__b26761226175110">path</strong>, <strong id="waf_02_0051__b967632612519">user-agent</strong>, <strong id="waf_02_0051__b16677026195111">ip</strong>, <strong id="waf_02_0051__b8677226135117">params</strong>, <strong id="waf_02_0051__b1567817267516">cookie</strong>, <strong id="waf_02_0051__b267812615512">referer</strong>, or <strong id="waf_02_0051__b206783265515">header</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row198208522393"><td class="cellrowborder" valign="top" width="33.086691330866906%" headers="mcps1.3.4.3.2.4.1.1 "><p id="waf_02_0051__p6823135213395">index</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.117288271172878%" headers="mcps1.3.4.3.2.4.1.2 "><p id="waf_02_0051__p882745213392">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.7960203979602%" headers="mcps1.3.4.3.2.4.1.3 "><ul id="waf_02_0051__ul192591951241"><li id="waf_02_0051__li027963317">If <strong id="waf_02_0051__b14728143241">category</strong> is set to <strong id="waf_02_0051__b9724145245">cookie</strong>, <strong id="waf_02_0051__b47251472411">index</strong> indicates cookie name.</li><li id="waf_02_0051__li5271461831">If <strong id="waf_02_0051__b3675116192415">category</strong> is set to <strong id="waf_02_0051__b66759165241">params</strong>, <strong id="waf_02_0051__b20675131622414">index</strong> indicates param name.</li><li id="waf_02_0051__li427156731">If <strong id="waf_02_0051__b8186145644715">category </strong>is set to <strong id="waf_02_0051__b17186656194715">header</strong>, <strong id="waf_02_0051__b418675612478">index</strong> indicates an option in the header.</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row88321852153910"><td class="cellrowborder" valign="top" width="33.086691330866906%" headers="mcps1.3.4.3.2.4.1.1 "><p id="waf_02_0051__p983495273920">logic</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.117288271172878%" headers="mcps1.3.4.3.2.4.1.2 "><p id="waf_02_0051__p128381352133914">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.7960203979602%" headers="mcps1.3.4.3.2.4.1.3 "><p id="waf_02_0051__p354910311212"><span class="parmvalue" id="waf_02_0051__parmvalue738915820221"><b>contain</b></span>, <span class="parmvalue" id="waf_02_0051__parmvalue143901758112213"><b>not_contain</b></span>, <span class="parmvalue" id="waf_02_0051__parmvalue12391205816226"><b>equal</b></span>, <span class="parmvalue" id="waf_02_0051__parmvalue12392758162219"><b>not_equal</b></span>, <span class="parmvalue" id="waf_02_0051__parmvalue4392758162212"><b>prefix</b></span>, <span class="parmvalue" id="waf_02_0051__parmvalue183932585229"><b>not_prefix</b></span>, <span class="parmvalue" id="waf_02_0051__parmvalue19394558132216"><b>suffix</b></span>, and <span class="parmvalue" id="waf_02_0051__parmvalue153941758152211"><b>not_suffix</b></span> indicate <strong id="waf_02_0051__b3395105819229">Include</strong>, <strong id="waf_02_0051__b15396105812224">Exclude</strong>, <strong id="waf_02_0051__b1739655822211">Equal to</strong>, <strong id="waf_02_0051__b639714584228">Not equal to</strong>, <strong id="waf_02_0051__b143984582227">Prefix is</strong>, <strong id="waf_02_0051__b839820583228">Prefix is not</strong>, <strong id="waf_02_0051__b10399958122216">Suffix is</strong>, and <strong id="waf_02_0051__b2040055872218">Suffix is not</strong> respectively.</p>
|
|
<p id="waf_02_0051__p15275833164210">If <span class="parmname" id="waf_02_0051__parmname13573173220519"><b>category</b></span> is set to <strong id="waf_02_0051__b6574332115112">ip</strong>, <span class="parmname" id="waf_02_0051__parmname1757514325517"><b>logic</b></span> can only be <span class="parmvalue" id="waf_02_0051__parmvalue105751132125117"><b>equal</b></span> or <span class="parmvalue" id="waf_02_0051__parmvalue0576173245116"><b>not_equal</b></span>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="waf_02_0051__row7844115211397"><td class="cellrowborder" valign="top" width="33.086691330866906%" headers="mcps1.3.4.3.2.4.1.1 "><p id="waf_02_0051__p198482052183915">contents</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.117288271172878%" headers="mcps1.3.4.3.2.4.1.2 "><p id="waf_02_0051__p8852155293920">List</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.7960203979602%" headers="mcps1.3.4.3.2.4.1.3 "><p id="waf_02_0051__p3856135214398">Specifies content matching the condition.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><a name="waf_02_0051__table11869252183917"></a><a name="table11869252183917"></a><table cellpadding="4" cellspacing="0" summary="" id="waf_02_0051__table11869252183917" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="waf_02_0051__b736055312815">action</strong></caption><thead align="left"><tr id="waf_02_0051__row108771152153912"><th align="left" class="cellrowborder" valign="top" width="33.086691330866906%" id="mcps1.3.4.4.2.4.1.1"><p id="waf_02_0051__p1088015522391"><strong id="waf_02_0051__b554205913189">Parameter</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="27.117288271172878%" id="mcps1.3.4.4.2.4.1.2"><p id="waf_02_0051__p788305283914"><strong id="waf_02_0051__b1608462298">Type</strong></p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="39.7960203979602%" id="mcps1.3.4.4.2.4.1.3"><p id="waf_02_0051__p888585219398"><strong id="waf_02_0051__b1176818117192">Description</strong></p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="waf_02_0051__row208859523396"><td class="cellrowborder" valign="top" width="33.086691330866906%" headers="mcps1.3.4.4.2.4.1.1 "><p id="waf_02_0051__p888817523397">category</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="27.117288271172878%" headers="mcps1.3.4.4.2.4.1.2 "><p id="waf_02_0051__p3890165216399">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="39.7960203979602%" headers="mcps1.3.4.4.2.4.1.3 "><p id="waf_02_0051__p94858282213">Specifies the protective action.</p>
|
|
<ul id="waf_02_0051__ul1491712301523"><li id="waf_02_0051__li169619511124"><span class="parmvalue" id="waf_02_0051__parmvalue17406748111619"><b>block</b></span>: block.</li><li id="waf_02_0051__li1091753013216"><span class="parmvalue" id="waf_02_0051__parmvalue1489065120161"><b>pass</b></span>: allow.</li></ul>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="waf_02_0051__section74205045519"><h4 class="sectiontitle">Example</h4><p id="waf_02_0051__p1838813506365">Rule ID <strong id="waf_02_0051__b255534345010">7374ad99c6c448e9a9ca35cb46660a39</strong> is used as an example.</p>
|
|
<p id="waf_02_0051__p20758458145512">Response example</p>
|
|
<pre class="screen" id="waf_02_0051__screen43401659207">{
|
|
"id": "7374ad99c6c448e9a9ca35cb46660a39",
|
|
"policy_id": "9tre832yf96784ec8abd8ba61a98064ef",
|
|
"name": "rule1",
|
|
"time": true,
|
|
"start": 1499817600,
|
|
"end": 1567817600,
|
|
"conditions": [{
|
|
"category ": "path",
|
|
"contents": ["/login"],
|
|
"logic": "contain"
|
|
},{
|
|
"category": "ip",
|
|
"logic": "equal",
|
|
"contents": ["X.X.1.1"]
|
|
}, {
|
|
"category": "referer",
|
|
"logic": "prefix",
|
|
"contents": ["https://www.waf.com/xxx"]
|
|
}, {
|
|
"category": "user-agent",
|
|
"logic": "contain",
|
|
"contents": ["Mozilla/5.0"]
|
|
}, {
|
|
"category": "cookie",
|
|
"index": "SID",
|
|
"logic": 3,
|
|
"contents": ["234SDFASR4R32412FSR325S"]
|
|
}, {
|
|
"category": "header",
|
|
"index": "x-language",
|
|
"logic": "equal",
|
|
"contents": ["en-us"]
|
|
}, {
|
|
"category": "params",
|
|
"index": "name",
|
|
"logic": "equal",
|
|
"contents": ["abc"]
|
|
}
|
|
],
|
|
"action": {
|
|
"category": "block"
|
|
},
|
|
"priority": 10,
|
|
"timestamp": 1499817600
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="waf_02_0051__section14528658"><h4 class="sectiontitle">Status Code</h4><div class="p" id="waf_02_0051__waf_02_0012_a652d4922b7df48fca0a65bc1a38ea5f2"><a href="#waf_02_0051__waf_02_0012_t82c3440f3efb42a38b9d4dc4011a33d0">Table 5</a> describes the normal status code returned by the API.
|
|
<div class="tablenoborder"><a name="waf_02_0051__waf_02_0012_t82c3440f3efb42a38b9d4dc4011a33d0"></a><a name="waf_02_0012_t82c3440f3efb42a38b9d4dc4011a33d0"></a><table cellpadding="4" cellspacing="0" summary="" id="waf_02_0051__waf_02_0012_t82c3440f3efb42a38b9d4dc4011a33d0" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Status code</caption><thead align="left"><tr id="waf_02_0051__waf_02_0012_r3d6e2f205c444705bdbb9daaac74e575"><th align="left" class="cellrowborder" valign="top" width="22%" id="mcps1.3.6.2.2.2.4.1.1"><p id="waf_02_0051__waf_02_0012_af3c4073076f24eca88d94e3fa1effdc6">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="19.41%" id="mcps1.3.6.2.2.2.4.1.2"><p id="waf_02_0051__waf_02_0012_en-us_topic_0144911667_p4531342288">Description</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="58.589999999999996%" id="mcps1.3.6.2.2.2.4.1.3"><p id="waf_02_0051__waf_02_0012_ada185614bba24140995b8123b3e9faa8">Meaning</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="waf_02_0051__waf_02_0012_rc7b2adc390904a1ba79e303017797786"><td class="cellrowborder" valign="top" width="22%" headers="mcps1.3.6.2.2.2.4.1.1 "><p id="waf_02_0051__waf_02_0012_a93f3895d44bb4226934cc626ac50e37b">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="19.41%" headers="mcps1.3.6.2.2.2.4.1.2 "><p id="waf_02_0051__waf_02_0012_en-us_topic_0144911667_p7538425819">OK</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="58.589999999999996%" headers="mcps1.3.6.2.2.2.4.1.3 "><p id="waf_02_0051__waf_02_0012_en-us_topic_0144911667_p369874114414">The request has succeeded.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<p id="waf_02_0051__waf_02_0012_en-us_topic_0144911667_p482819399522">For details about error status codes, see <a href="waf_02_0085.html">Status Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="waf_02_0047.html">Precise Protection Rules</a></div>
|
|
</div>
|
|
</div>
|
|
|