forked from docs/doc-exports
qinweiwei
14cbe51752
Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com> Co-authored-by: qinweiwei <qinweiwei@huawei.com> Co-committed-by: qinweiwei <qinweiwei@huawei.com>
408 lines
34 KiB
HTML
408 lines
34 KiB
HTML
<a name="UpdateGeoipRule"></a><a name="UpdateGeoipRule"></a>
|
|
|
|
<h1 class="topictitle1">Updating a Geolocation Access Control Rule</h1>
|
|
<div id="body1708331107508"><div class="section" id="UpdateGeoipRule__topic1661000000"><h4 class="sectiontitle">Function</h4><p id="UpdateGeoipRule__topic1661000002">This API is used to update a geolocation access control rule.</p>
|
|
</div>
|
|
<div class="section" id="UpdateGeoipRule__atuogenerate_1"><h4 class="sectiontitle">URI</h4><p id="UpdateGeoipRule__topic1661000004">PUT /v1/{project_id}/waf/policy/{policy_id}/geoip/{rule_id}</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateGeoipRule__topic1661000005" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Path Parameters</caption><thead align="left"><tr id="UpdateGeoipRule__topic1661000013"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.1"><p id="UpdateGeoipRule__topic1661000015">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.2"><p id="UpdateGeoipRule__topic1661000017">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.2.3.2.5.1.3"><p id="UpdateGeoipRule__topic1661000019">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.2.3.2.5.1.4"><p id="UpdateGeoipRule__topic1661000021">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateGeoipRule__topic1661000023"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="UpdateGeoipRule__topic1661000025">project_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="UpdateGeoipRule__topic1661000027">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="UpdateGeoipRule__topic1661000029">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="UpdateGeoipRule__topic1661000031">Project ID</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000032"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="UpdateGeoipRule__topic1661000034">policy_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="UpdateGeoipRule__topic1661000036">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="UpdateGeoipRule__topic1661000038">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="UpdateGeoipRule__topic1661000040">Policy ID. It can be obtained by calling the <strong id="UpdateGeoipRule__topic1661000041">ListPolicy</strong> API.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000042"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.1 "><p id="UpdateGeoipRule__topic1661000044">rule_id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.2 "><p id="UpdateGeoipRule__topic1661000046">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.2.3.2.5.1.3 "><p id="UpdateGeoipRule__topic1661000048">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.2.3.2.5.1.4 "><p id="UpdateGeoipRule__topic1661000050">ID of the geolocation access control rule. It can be obtained by calling the <strong id="UpdateGeoipRule__topic1661000051">ListGeoipRules</strong> API.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="UpdateGeoipRule__topic1661000052"><h4 class="sectiontitle">Request Parameters</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateGeoipRule__HeaderParameter" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Request header parameters</caption><thead align="left"><tr id="UpdateGeoipRule__topic1661000061"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.1"><p id="UpdateGeoipRule__topic1661000063">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.2"><p id="UpdateGeoipRule__topic1661000065">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.2.2.5.1.3"><p id="UpdateGeoipRule__topic1661000067">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.2.2.5.1.4"><p id="UpdateGeoipRule__topic1661000069">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateGeoipRule__topic1661000071"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="UpdateGeoipRule__topic1661000073">X-Auth-Token</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="UpdateGeoipRule__topic1661000075">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="UpdateGeoipRule__topic1661000077">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="UpdateGeoipRule__topic1661000079">User token</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000080"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.1 "><p id="UpdateGeoipRule__topic1661000082">Content-Type</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.2 "><p id="UpdateGeoipRule__topic1661000084">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.2.2.5.1.3 "><p id="UpdateGeoipRule__topic1661000086">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.2.2.5.1.4 "><p id="UpdateGeoipRule__topic1661000088">Content type</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateGeoipRule__request_UpdateGeoIpRuleRequestBody" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Request body parameters</caption><thead align="left"><tr id="UpdateGeoipRule__topic1661000096"><th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.1"><p id="UpdateGeoipRule__topic1661000098">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.2"><p id="UpdateGeoipRule__topic1661000100">Mandatory</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="20%" id="mcps1.3.3.3.2.5.1.3"><p id="UpdateGeoipRule__topic1661000102">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="40%" id="mcps1.3.3.3.2.5.1.4"><p id="UpdateGeoipRule__topic1661000104">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateGeoipRule__topic1661000106"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateGeoipRule__topic1661000108">geoip</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateGeoipRule__topic1661000110">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateGeoipRule__topic1661000112">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateGeoipRule__topic1661000114">Applicable regions. The value can be the region code.</p>
|
|
<ul id="UpdateGeoipRule__topic1661000115"><li id="UpdateGeoipRule__topic1661000116"><p id="UpdateGeoipRule__topic1661000117"><a name="UpdateGeoipRule__topic1661000116"></a><a name="topic1661000116"></a>CA: Canada</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000118"><p id="UpdateGeoipRule__topic1661000119"><a name="UpdateGeoipRule__topic1661000118"></a><a name="topic1661000118"></a>US: USA</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000120"><p id="UpdateGeoipRule__topic1661000121"><a name="UpdateGeoipRule__topic1661000120"></a><a name="topic1661000120"></a>AU: Australia</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000122"><p id="UpdateGeoipRule__topic1661000123"><a name="UpdateGeoipRule__topic1661000122"></a><a name="topic1661000122"></a>IN: India</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000124"><p id="UpdateGeoipRule__topic1661000125"><a name="UpdateGeoipRule__topic1661000124"></a><a name="topic1661000124"></a>JP: Japan</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000126"><p id="UpdateGeoipRule__topic1661000127"><a name="UpdateGeoipRule__topic1661000126"></a><a name="topic1661000126"></a>UK: United Kingdom</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000128"><p id="UpdateGeoipRule__topic1661000129"><a name="UpdateGeoipRule__topic1661000128"></a><a name="topic1661000128"></a>FR: France</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000130"><p id="UpdateGeoipRule__topic1661000131"><a name="UpdateGeoipRule__topic1661000130"></a><a name="topic1661000130"></a>DE: Germany</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000132"><p id="UpdateGeoipRule__topic1661000133"><a name="UpdateGeoipRule__topic1661000132"></a><a name="topic1661000132"></a>BR: Brazil</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000134"><p id="UpdateGeoipRule__topic1661000135"><a name="UpdateGeoipRule__topic1661000134"></a><a name="topic1661000134"></a>Ukraine: Ukraine</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000136"><p id="UpdateGeoipRule__topic1661000137"><a name="UpdateGeoipRule__topic1661000136"></a><a name="topic1661000136"></a>Pakistan: Pakistan</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000138"><p id="UpdateGeoipRule__topic1661000139"><a name="UpdateGeoipRule__topic1661000138"></a><a name="topic1661000138"></a>Palestine: Palestine</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000140"><p id="UpdateGeoipRule__topic1661000141"><a name="UpdateGeoipRule__topic1661000140"></a><a name="topic1661000140"></a>Israel: Israel</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000142"><p id="UpdateGeoipRule__topic1661000143"><a name="UpdateGeoipRule__topic1661000142"></a><a name="topic1661000142"></a>Iraq: Iraq</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000144"><p id="UpdateGeoipRule__topic1661000145"><a name="UpdateGeoipRule__topic1661000144"></a><a name="topic1661000144"></a>Afghanistan: Afghanistan</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000146"><p id="UpdateGeoipRule__topic1661000147"><a name="UpdateGeoipRule__topic1661000146"></a><a name="topic1661000146"></a>Libya: Libya</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000148"><p id="UpdateGeoipRule__topic1661000149"><a name="UpdateGeoipRule__topic1661000148"></a><a name="topic1661000148"></a>Turkey: Turkey</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000150"><p id="UpdateGeoipRule__topic1661000151"><a name="UpdateGeoipRule__topic1661000150"></a><a name="topic1661000150"></a>Thailand: Thailand</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000152"><p id="UpdateGeoipRule__topic1661000153"><a name="UpdateGeoipRule__topic1661000152"></a><a name="topic1661000152"></a>Singapore: Singapore</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000154"><p id="UpdateGeoipRule__topic1661000155"><a name="UpdateGeoipRule__topic1661000154"></a><a name="topic1661000154"></a>South Africa: South Africa</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000156"><p id="UpdateGeoipRule__topic1661000157"><a name="UpdateGeoipRule__topic1661000156"></a><a name="topic1661000156"></a>Mexico: Mexico</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000158"><p id="UpdateGeoipRule__topic1661000159"><a name="UpdateGeoipRule__topic1661000158"></a><a name="topic1661000158"></a>Peru: Peru</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000160"><p id="UpdateGeoipRule__topic1661000161"><a name="UpdateGeoipRule__topic1661000160"></a><a name="topic1661000160"></a>For more geographical location codes, see "Appendix - Geographic Location Codes."</p>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000162"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateGeoipRule__topic1661000164">white</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateGeoipRule__topic1661000166">Yes</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateGeoipRule__topic1661000168">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateGeoipRule__topic1661000170">Protective action. The value can be:</p>
|
|
<ul id="UpdateGeoipRule__topic1661000171"><li id="UpdateGeoipRule__topic1661000172"><p id="UpdateGeoipRule__topic1661000173"><a name="UpdateGeoipRule__topic1661000172"></a><a name="topic1661000172"></a>0: WAF blocks the requests that hit the rule.</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000174"><p id="UpdateGeoipRule__topic1661000175"><a name="UpdateGeoipRule__topic1661000174"></a><a name="topic1661000174"></a>1: WAF allows the requests that hit the rule.</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000176"><p id="UpdateGeoipRule__topic1661000177"><a name="UpdateGeoipRule__topic1661000176"></a><a name="topic1661000176"></a>2: WAF only logs the requests that hit the rule.</p>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000178"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateGeoipRule__topic1661000180">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateGeoipRule__topic1661000182">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateGeoipRule__topic1661000184">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateGeoipRule__topic1661000186">Rule name. Currently, the console does not support configuring names for geolocation access control rule. Ignore this parameter.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000187"><td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.1 "><p id="UpdateGeoipRule__topic1661000189">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.2 "><p id="UpdateGeoipRule__topic1661000191">No</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="20%" headers="mcps1.3.3.3.2.5.1.3 "><p id="UpdateGeoipRule__topic1661000193">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="40%" headers="mcps1.3.3.3.2.5.1.4 "><p id="UpdateGeoipRule__topic1661000195">Rule description</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="UpdateGeoipRule__topic1661000196"><h4 class="sectiontitle">Response Parameters</h4><p id="UpdateGeoipRule__topic1661000198"><strong id="UpdateGeoipRule__topic1661000199">Status code: 200</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateGeoipRule__response_UpdateGeoIpRuleResponseBody" frame="border" border="1" rules="all"><caption><b>Table 4 </b>Response body parameters</caption><thead align="left"><tr id="UpdateGeoipRule__topic1661000206"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.1"><p id="UpdateGeoipRule__topic1661000208">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.3.2.4.1.2"><p id="UpdateGeoipRule__topic1661000210">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.3.2.4.1.3"><p id="UpdateGeoipRule__topic1661000212">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateGeoipRule__topic1661000214"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000216">id</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000218">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000220">Rule ID.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000221"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000223">policyid</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000225">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000227">Policy ID</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000228"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000230">name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000232">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000234">Rule name. Currently, the console does not support configuring names for geolocation access control rule. Ignore this parameter.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000235"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000237">geoTagList</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000239">Array of strings</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000241">List of geographical locations hit the geolocation access control rule.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000242"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000244">geoip</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000246">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000248">Applicable regions. The value can be the region code.</p>
|
|
<ul id="UpdateGeoipRule__topic1661000249"><li id="UpdateGeoipRule__topic1661000250"><p id="UpdateGeoipRule__topic1661000251"><a name="UpdateGeoipRule__topic1661000250"></a><a name="topic1661000250"></a>CA: Canada</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000252"><p id="UpdateGeoipRule__topic1661000253"><a name="UpdateGeoipRule__topic1661000252"></a><a name="topic1661000252"></a>US: USA</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000254"><p id="UpdateGeoipRule__topic1661000255"><a name="UpdateGeoipRule__topic1661000254"></a><a name="topic1661000254"></a>AU: Australia</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000256"><p id="UpdateGeoipRule__topic1661000257"><a name="UpdateGeoipRule__topic1661000256"></a><a name="topic1661000256"></a>IN: India</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000258"><p id="UpdateGeoipRule__topic1661000259"><a name="UpdateGeoipRule__topic1661000258"></a><a name="topic1661000258"></a>JP: Japan</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000260"><p id="UpdateGeoipRule__topic1661000261"><a name="UpdateGeoipRule__topic1661000260"></a><a name="topic1661000260"></a>UK: United Kingdom</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000262"><p id="UpdateGeoipRule__topic1661000263"><a name="UpdateGeoipRule__topic1661000262"></a><a name="topic1661000262"></a>FR: France</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000264"><p id="UpdateGeoipRule__topic1661000265"><a name="UpdateGeoipRule__topic1661000264"></a><a name="topic1661000264"></a>DE: Germany</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000266"><p id="UpdateGeoipRule__topic1661000267"><a name="UpdateGeoipRule__topic1661000266"></a><a name="topic1661000266"></a>BR: Brazil</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000268"><p id="UpdateGeoipRule__topic1661000269"><a name="UpdateGeoipRule__topic1661000268"></a><a name="topic1661000268"></a>Ukraine: Ukraine</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000270"><p id="UpdateGeoipRule__topic1661000271"><a name="UpdateGeoipRule__topic1661000270"></a><a name="topic1661000270"></a>Pakistan: Pakistan</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000272"><p id="UpdateGeoipRule__topic1661000273"><a name="UpdateGeoipRule__topic1661000272"></a><a name="topic1661000272"></a>Palestine: Palestine</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000274"><p id="UpdateGeoipRule__topic1661000275"><a name="UpdateGeoipRule__topic1661000274"></a><a name="topic1661000274"></a>Israel: Israel</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000276"><p id="UpdateGeoipRule__topic1661000277"><a name="UpdateGeoipRule__topic1661000276"></a><a name="topic1661000276"></a>Iraq: Iraq</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000278"><p id="UpdateGeoipRule__topic1661000279"><a name="UpdateGeoipRule__topic1661000278"></a><a name="topic1661000278"></a>Afghanistan: Afghanistan</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000280"><p id="UpdateGeoipRule__topic1661000281"><a name="UpdateGeoipRule__topic1661000280"></a><a name="topic1661000280"></a>Libya: Libya</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000282"><p id="UpdateGeoipRule__topic1661000283"><a name="UpdateGeoipRule__topic1661000282"></a><a name="topic1661000282"></a>Turkey: Turkey</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000284"><p id="UpdateGeoipRule__topic1661000285"><a name="UpdateGeoipRule__topic1661000284"></a><a name="topic1661000284"></a>Thailand: Thailand</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000286"><p id="UpdateGeoipRule__topic1661000287"><a name="UpdateGeoipRule__topic1661000286"></a><a name="topic1661000286"></a>Singapore: Singapore</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000288"><p id="UpdateGeoipRule__topic1661000289"><a name="UpdateGeoipRule__topic1661000288"></a><a name="topic1661000288"></a>South Africa: South Africa</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000290"><p id="UpdateGeoipRule__topic1661000291"><a name="UpdateGeoipRule__topic1661000290"></a><a name="topic1661000290"></a>Mexico: Mexico</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000292"><p id="UpdateGeoipRule__topic1661000293"><a name="UpdateGeoipRule__topic1661000292"></a><a name="topic1661000292"></a>Peru: Peru</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000294"><p id="UpdateGeoipRule__topic1661000295"><a name="UpdateGeoipRule__topic1661000294"></a><a name="topic1661000294"></a>For more geographical location codes, see "Appendix - Geographic Location Codes."</p>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000296"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000298">white</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000300">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000302">Protective action. The value can be:</p>
|
|
<ul id="UpdateGeoipRule__topic1661000303"><li id="UpdateGeoipRule__topic1661000304"><p id="UpdateGeoipRule__topic1661000305"><a name="UpdateGeoipRule__topic1661000304"></a><a name="topic1661000304"></a>0: WAF blocks the requests that hit the rule.</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000306"><p id="UpdateGeoipRule__topic1661000307"><a name="UpdateGeoipRule__topic1661000306"></a><a name="topic1661000306"></a>1: WAF allows the requests that hit the rule.</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000308"><p id="UpdateGeoipRule__topic1661000309"><a name="UpdateGeoipRule__topic1661000308"></a><a name="topic1661000308"></a>2: WAF only logs the requests that hit the rule.</p>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000310"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000312">status</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000314">Integer</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000316">Rule status. The value can be:</p>
|
|
<ul id="UpdateGeoipRule__topic1661000317"><li id="UpdateGeoipRule__topic1661000318"><p id="UpdateGeoipRule__topic1661000319"><a name="UpdateGeoipRule__topic1661000318"></a><a name="topic1661000318"></a>0: The rule is disabled.</p>
|
|
</li><li id="UpdateGeoipRule__topic1661000320"><p id="UpdateGeoipRule__topic1661000321"><a name="UpdateGeoipRule__topic1661000320"></a><a name="topic1661000320"></a>1: The rule is enabled.</p>
|
|
</li></ul>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000322"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000324">timestamp</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000326">Long</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000328">Time the rule is created. The value is a 13-digit timestamp in ms.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000329"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000331">description</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.3.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000333">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.3.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000335">Rule description</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="UpdateGeoipRule__topic1661000336"><strong id="UpdateGeoipRule__topic1661000337">Status code: 400</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateGeoipRule__response_RestErrorResponse" frame="border" border="1" rules="all"><caption><b>Table 5 </b>Response body parameters</caption><thead align="left"><tr id="UpdateGeoipRule__topic1661000344"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.5.2.4.1.1"><p id="UpdateGeoipRule__topic1661000346">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.5.2.4.1.2"><p id="UpdateGeoipRule__topic1661000348">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.5.2.4.1.3"><p id="UpdateGeoipRule__topic1661000350">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateGeoipRule__topic1661000352"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000354">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000356">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.5.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000358">Error code</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000359"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000361">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.5.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000363">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.5.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000365">Error message</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="UpdateGeoipRule__topic1661000366"><strong id="UpdateGeoipRule__topic1661000367">Status code: 401</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateGeoipRule__response_RestErrorResponse_1" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Response body parameters</caption><thead align="left"><tr id="UpdateGeoipRule__topic1661000374"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.7.2.4.1.1"><p id="UpdateGeoipRule__topic1661000376">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.7.2.4.1.2"><p id="UpdateGeoipRule__topic1661000378">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.7.2.4.1.3"><p id="UpdateGeoipRule__topic1661000380">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateGeoipRule__topic1661000382"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000384">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000386">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.7.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000388">Error code</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000389"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000391">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.7.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000393">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.7.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000395">Error message</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p id="UpdateGeoipRule__topic1661000396"><strong id="UpdateGeoipRule__topic1661000397">Status code: 500</strong></p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateGeoipRule__response_RestErrorResponse_2" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Response body parameters</caption><thead align="left"><tr id="UpdateGeoipRule__topic1661000404"><th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.9.2.4.1.1"><p id="UpdateGeoipRule__topic1661000406">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="25%" id="mcps1.3.4.9.2.4.1.2"><p id="UpdateGeoipRule__topic1661000408">Type</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="50%" id="mcps1.3.4.9.2.4.1.3"><p id="UpdateGeoipRule__topic1661000410">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateGeoipRule__topic1661000412"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.9.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000414">error_code</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.9.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000416">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.9.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000418">Error code</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000419"><td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.9.2.4.1.1 "><p id="UpdateGeoipRule__topic1661000421">error_msg</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="25%" headers="mcps1.3.4.9.2.4.1.2 "><p id="UpdateGeoipRule__topic1661000423">String</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="50%" headers="mcps1.3.4.9.2.4.1.3 "><p id="UpdateGeoipRule__topic1661000425">Error message</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="UpdateGeoipRule__topic1661000426"><h4 class="sectiontitle">Example Requests</h4><pre class="screen" id="UpdateGeoipRule__topic1661000428">PUT https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/geoip/{rule_id}?
|
|
|
|
{
|
|
"white" : 1,
|
|
"geoip" : "BR"
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="UpdateGeoipRule__topic1661000429"><h4 class="sectiontitle">Example Responses</h4><p id="UpdateGeoipRule__topic1661000431"><strong id="UpdateGeoipRule__topic1661000432">Status code: 200</strong></p>
|
|
<p id="UpdateGeoipRule__topic1661000433">Request succeeded.</p>
|
|
<pre class="screen" id="UpdateGeoipRule__topic1661000434">{
|
|
"id" : "02dafa406c4941368a1037b020f15a53",
|
|
"policyid" : "38ff0cb9a10e4d5293c642bc0350fa6d",
|
|
"name" : "demo",
|
|
"description" : "demo",
|
|
"geoTagList" : [ "BR" ],
|
|
"geoip" : "BR",
|
|
"white" : 1
|
|
}</pre>
|
|
</div>
|
|
<div class="section" id="UpdateGeoipRule__topic1661000435"><h4 class="sectiontitle">Status Codes</h4>
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="UpdateGeoipRule__status_code" frame="border" border="1" rules="all"><thead align="left"><tr id="UpdateGeoipRule__topic1661000441"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.7.2.1.3.1.1"><p id="UpdateGeoipRule__topic1661000443">Status Code</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="85%" id="mcps1.3.7.2.1.3.1.2"><p id="UpdateGeoipRule__topic1661000445">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="UpdateGeoipRule__topic1661000447"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpdateGeoipRule__topic1661000449">200</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpdateGeoipRule__topic1661000451">Request succeeded.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000452"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpdateGeoipRule__topic1661000454">400</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpdateGeoipRule__topic1661000456">Request failed.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000457"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpdateGeoipRule__topic1661000459">401</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpdateGeoipRule__topic1661000461">The token does not have required permissions.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="UpdateGeoipRule__topic1661000462"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.7.2.1.3.1.1 "><p id="UpdateGeoipRule__topic1661000464">500</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="85%" headers="mcps1.3.7.2.1.3.1.2 "><p id="UpdateGeoipRule__topic1661000466">Internal server error.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
<div class="section" id="UpdateGeoipRule__topic1661000467"><h4 class="sectiontitle">Error Codes</h4><p id="UpdateGeoipRule__topic1661000469">See <a href="ErrorCode.html">Error Codes</a>.</p>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="topic_300000003.html">Rule Management</a></div>
|
|
</div>
|
|
</div>
|
|
|