• Native OpenStack API

noa
  1. Help Center
  2. Native OpenStack API
  3. API Reference
  4. Neutron
  5. Firewall
  6. Inserting a Firewall Rule

Inserting a Firewall Rule

Function

This interface is used to insert a firewall rule to a firewall policy.

URI

PUT /v2.0/fwaas/firewall_policies/{firewall_policy_id}/insert_rule

Request Message

Table 1 Request parameter

Parameter

Type

Mandatory

Description

firewall_policy_id

String

Yes

Specifies the firewall policy ID, which uniquely identifies the firewall policy.

firewall_rule_id

String

Yes

Specifies the firewall rule ID, which uniquely identifies the firewall rule.

insert_after

String

No

The insert_after parameter indicates the firewall rule that has already been associated with the firewall policy. A new firewall rule will be inserted after the firewall rule associated with the firewall policy.

If both the insert_after and insert_before parameters are specified, the insert_after parameter will be ignored.

insert_before

String

No

The insert_before parameter indicates the firewall rule that has already been associated with the firewall policy. A new firewall rule will be inserted before the firewall rule associated with the firewall policy.

If both the insert_after and insert_before parameters are specified, the insert_after parameter will be ignored.

Response Message

Table 2 Response parameter

Parameter

Type

Description

description

String

Provides supplementary information about the firewall policy.

audited

Boolean

Each time the firewall policy or the associated firewall rules are changed, this attribute will be set to False.

firewall_rules

List

Specifies the ID list of the firewall rules associated with the current firewall policy.

id

String

Specifies the firewall policy ID.

name

String

Specifies the firewall policy name.

public

Boolean

If this attribute is set to True, the firewall policy is visible to tenants other than its owner. The firewall policy is not visible to other tenants by default.

tenant_id

String

Specifies the current project ID.

Example:

Example request

PUT /v2.0/fwaas/firewall_policies/afc52ce9-5305-4ec9-9feb-44feb8330341/insert_rule 
{
    "insert_after": "b8243448-cb3c-496e-851c-dadade4c161b", 
    "firewall_rule_id": "0f82b221-8cd6-44bd-9dfc-0e118fa7b6b1", 
    "insert_before": ""
}

Example response

{
    "description": "", 
    "firewall_rules": [
        "b8243448-cb3c-496e-851c-dadade4c161b", 
        "0f82b221-8cd6-44bd-9dfc-0e118fa7b6b1"
    ], 
    "tenant_id": "23c8a121505047b6869edf39f3062712", 
    "public": false, 
    "id": "afc52ce9-5305-4ec9-9feb-44feb8330341", 
    "audited": false, 
    "name": "test-policy",
    "project_id": "23c8a121505047b6869edf39f3062712"
}

Status Codes

For details, see section Status Codes.