doc-exports/docs/vpc/api-ref/vpc_firewall_0012.html
Qin Ying, Fan 310d2d9eb1 VPC API 20230106 version
Reviewed-by: Sarda, Priya <prsarda@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-authored-by: Qin Ying, Fan <fanqinying@huawei.com>
Co-committed-by: Qin Ying, Fan <fanqinying@huawei.com>
2024-02-06 08:38:37 +00:00

133 lines
10 KiB
HTML

<a name="vpc_firewall_0012"></a><a name="vpc_firewall_0012"></a>
<h1 class="topictitle1">Removing a <span id="text35531332103913">Firewall</span> Rule</h1>
<div id="body1495598977068"><div class="section" id="vpc_firewall_0012__section9946367132633"><h4 class="sectiontitle">Function</h4><p id="vpc_firewall_0012__p35198315132633">This API is used to remove a <span id="vpc_firewall_0012__text179701044124815"></span><span id="vpc_firewall_0012__text1997094454810">firewall</span> rule from a <span id="vpc_firewall_0012__text51211415287"></span><span id="vpc_firewall_0012__text214124192812">firewall</span> policy.</p>
</div>
<div class="section" id="vpc_firewall_0012__section17986671132633"><h4 class="sectiontitle">URI</h4><p id="vpc_firewall_0012__p97601654527">PUT /v2.0/fwaas/firewall_policies/{firewall_policy_id}/remove_rule</p>
</div>
<div class="section" id="vpc_firewall_0012__section27028167132633"><h4 class="sectiontitle">Request Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="vpc_firewall_0012__table48893916132633" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Request parameter</caption><thead align="left"><tr id="vpc_firewall_0012__row19661564132633"><th align="left" class="cellrowborder" valign="top" width="23.47%" id="mcps1.3.3.2.2.5.1.1"><p id="vpc_firewall_0012__p4257277132633">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="14.149999999999999%" id="mcps1.3.3.2.2.5.1.2"><p id="vpc_firewall_0012__p2994165132633">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="19.52%" id="mcps1.3.3.2.2.5.1.3"><p id="vpc_firewall_0012__p47550467132633">Mandatory</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="42.86%" id="mcps1.3.3.2.2.5.1.4"><p id="vpc_firewall_0012__p38031689132633">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_firewall_0012__row26905318132633"><td class="cellrowborder" valign="top" width="23.47%" headers="mcps1.3.3.2.2.5.1.1 "><p id="vpc_firewall_0012__p23736314132633">firewall_rule_id</p>
</td>
<td class="cellrowborder" valign="top" width="14.149999999999999%" headers="mcps1.3.3.2.2.5.1.2 "><p id="vpc_firewall_0012__p25366437132633">String</p>
</td>
<td class="cellrowborder" valign="top" width="19.52%" headers="mcps1.3.3.2.2.5.1.3 "><p id="vpc_firewall_0012__p36656390132633">Yes</p>
</td>
<td class="cellrowborder" valign="top" width="42.86%" headers="mcps1.3.3.2.2.5.1.4 "><p id="vpc_firewall_0012__p48236351132633">Specifies the <span id="vpc_firewall_0012__text1243515538481"></span><span id="vpc_firewall_0012__text6435105344819">firewall</span> rule ID, which uniquely identifies the <span id="vpc_firewall_0012__text158569817297"></span><span id="vpc_firewall_0012__text1985618862914">firewall</span> rule.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="vpc_firewall_0012__section1296183918492"><h4 class="sectiontitle">Example Request</h4><p id="vpc_firewall_0012__p733710371251">Remove ACL rule 0f82b221-8cd6-44bd-9dfc-0e118fa7b6b1 from the ACL policy whose ID is afc52ce9-5305-4ec9-9feb-44feb8330341.</p>
<pre class="screen" id="vpc_firewall_0012__screen721715095018">PUT https://{Endpoint}/v2.0/fwaas/firewall_policies/afc52ce9-5305-4ec9-9feb-44feb8330341/remove_rule
{
"firewall_rule_id": "0f82b221-8cd6-44bd-9dfc-0e118fa7b6b1"
}</pre>
</div>
<div class="section" id="vpc_firewall_0012__section14889742132633"><h4 class="sectiontitle">Response Parameters</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="vpc_firewall_0012__table7711269132633" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Response parameter</caption><thead align="left"><tr id="vpc_firewall_0012__row40961108132633"><th align="left" class="cellrowborder" valign="top" width="23.169999999999998%" id="mcps1.3.5.2.2.4.1.1"><p id="vpc_firewall_0012__p53016887132633">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="25.61%" id="mcps1.3.5.2.2.4.1.2"><p id="vpc_firewall_0012__p45522129132633">Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="51.22%" id="mcps1.3.5.2.2.4.1.3"><p id="vpc_firewall_0012__p31582377132633">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="vpc_firewall_0012__row18215720132633"><td class="cellrowborder" valign="top" width="23.169999999999998%" headers="mcps1.3.5.2.2.4.1.1 "><p id="vpc_firewall_0012__p64319710132633">description</p>
</td>
<td class="cellrowborder" valign="top" width="25.61%" headers="mcps1.3.5.2.2.4.1.2 "><p id="vpc_firewall_0012__p20101354132633">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.22%" headers="mcps1.3.5.2.2.4.1.3 "><p id="vpc_firewall_0012__p41635977132633">Provides supplementary information about the firewall policy.</p>
</td>
</tr>
<tr id="vpc_firewall_0012__row7244977132633"><td class="cellrowborder" valign="top" width="23.169999999999998%" headers="mcps1.3.5.2.2.4.1.1 "><p id="vpc_firewall_0012__p35103306132633">audited</p>
</td>
<td class="cellrowborder" valign="top" width="25.61%" headers="mcps1.3.5.2.2.4.1.2 "><p id="vpc_firewall_0012__p14021835132633">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="51.22%" headers="mcps1.3.5.2.2.4.1.3 "><p id="vpc_firewall_0012__p34631936132633">Each time the firewall policy or the associated firewall rules are changed, this attribute will be set to <strong id="vpc_firewall_0012__b8423527061137">False</strong>.</p>
</td>
</tr>
<tr id="vpc_firewall_0012__row21094728132633"><td class="cellrowborder" valign="top" width="23.169999999999998%" headers="mcps1.3.5.2.2.4.1.1 "><p id="vpc_firewall_0012__p50715789132633">firewall_rules</p>
</td>
<td class="cellrowborder" valign="top" width="25.61%" headers="mcps1.3.5.2.2.4.1.2 "><p id="vpc_firewall_0012__p56483400132633">Array of strings</p>
</td>
<td class="cellrowborder" valign="top" width="51.22%" headers="mcps1.3.5.2.2.4.1.3 "><p id="vpc_firewall_0012__p3804581132633">Specifies the ID list of the firewall rules associated with the current firewall policy.</p>
</td>
</tr>
<tr id="vpc_firewall_0012__row27264529132633"><td class="cellrowborder" valign="top" width="23.169999999999998%" headers="mcps1.3.5.2.2.4.1.1 "><p id="vpc_firewall_0012__p47093833132633">id</p>
</td>
<td class="cellrowborder" valign="top" width="25.61%" headers="mcps1.3.5.2.2.4.1.2 "><p id="vpc_firewall_0012__p45736328132633">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.22%" headers="mcps1.3.5.2.2.4.1.3 "><p id="vpc_firewall_0012__p46737820132633">Specifies the firewall policy ID.</p>
</td>
</tr>
<tr id="vpc_firewall_0012__row46882287132633"><td class="cellrowborder" valign="top" width="23.169999999999998%" headers="mcps1.3.5.2.2.4.1.1 "><p id="vpc_firewall_0012__p28861411132633">name</p>
</td>
<td class="cellrowborder" valign="top" width="25.61%" headers="mcps1.3.5.2.2.4.1.2 "><p id="vpc_firewall_0012__p36587630132633">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.22%" headers="mcps1.3.5.2.2.4.1.3 "><p id="vpc_firewall_0012__p14824904132633">Specifies the firewall policy name.</p>
</td>
</tr>
<tr id="vpc_firewall_0012__row64601479132633"><td class="cellrowborder" valign="top" width="23.169999999999998%" headers="mcps1.3.5.2.2.4.1.1 "><p id="vpc_firewall_0012__p61245310132633">public</p>
</td>
<td class="cellrowborder" valign="top" width="25.61%" headers="mcps1.3.5.2.2.4.1.2 "><p id="vpc_firewall_0012__p21782173132633">Boolean</p>
</td>
<td class="cellrowborder" valign="top" width="51.22%" headers="mcps1.3.5.2.2.4.1.3 "><p id="vpc_firewall_0012__p9188558132633">If this attribute is set to <strong id="vpc_firewall_0012__b52671116122119">true</strong>, the <span id="vpc_firewall_0012__text983811810491"></span><span id="vpc_firewall_0012__text783878124916">firewall</span> policy is visible to tenants other than its owner. The <span id="vpc_firewall_0012__text19302131812309"></span><span id="vpc_firewall_0012__text8302318143019">firewall</span> policy is not visible to other tenants by default.</p>
</td>
</tr>
<tr id="vpc_firewall_0012__row31674173132633"><td class="cellrowborder" valign="top" width="23.169999999999998%" headers="mcps1.3.5.2.2.4.1.1 "><p id="vpc_firewall_0012__p49506560132633">tenant_id</p>
</td>
<td class="cellrowborder" valign="top" width="25.61%" headers="mcps1.3.5.2.2.4.1.2 "><p id="vpc_firewall_0012__p50877818132633">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.22%" headers="mcps1.3.5.2.2.4.1.3 "><p id="vpc_firewall_0012__p10487112">Specifies the project ID.</p>
</td>
</tr>
<tr id="vpc_firewall_0012__row9718201825319"><td class="cellrowborder" valign="top" width="23.169999999999998%" headers="mcps1.3.5.2.2.4.1.1 "><p id="vpc_firewall_0012__p12424739135216">project_id</p>
</td>
<td class="cellrowborder" valign="top" width="25.61%" headers="mcps1.3.5.2.2.4.1.2 "><p id="vpc_firewall_0012__p1433100105317">String</p>
</td>
<td class="cellrowborder" valign="top" width="51.22%" headers="mcps1.3.5.2.2.4.1.3 "><p id="vpc_firewall_0012__p83360145317">Specifies the project ID.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="vpc_firewall_0012__section48445237132633"><h4 class="sectiontitle">Example Response</h4><pre class="screen" id="vpc_firewall_0012__screen196238184504">{
"description": "",
"firewall_rules": [
"b8243448-cb3c-496e-851c-dadade4c161b"
],
"tenant_id": "23c8a121505047b6869edf39f3062712",
"public": false,
"id": "afc52ce9-5305-4ec9-9feb-44feb8330341",
"audited": false,
"name": "test-policy",
"project_id": "23c8a121505047b6869edf39f3062712"
}</pre>
</div>
<div class="section" id="vpc_firewall_0012__section10470352390"><h4 class="sectiontitle">Status Code</h4><p id="vpc_firewall_0012__p18112112662914">See <a href="vpc_api_0002.html">Status Codes</a>.</p>
</div>
<div class="section" id="vpc_firewall_0012__section85821649202813"><h4 class="sectiontitle">Error Code</h4><p id="vpc_firewall_0012__p7233105282813">See <a href="vpc_api_0003.html">Error Codes</a>.</p>
</div>
<p id="vpc_firewall_0012__p8060118"></p>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="vpc_firewall_0000.html">Firewall</a></div>
</div>
</div>