Revise Rule

Modifies existing firewall rule along with relative position among other firewall rules inside a firewall section. Revising firewall rule in a section modifies parent section entity and simultaneous update (modify) operations on same section are not allowed to prevent overwriting stale contents to firewall section. If a concurrent update is performed, HTTP response code 409 will be returned to the client operating on stale data. That client should retrieve the firewall section again and re-apply its update.

Use the following Policy API -
POST /policy/api/v1/infra/domains/<domain-id>/security-policies/<security-policy-id>/rules/<rule-id>?action=revise

Request

URI

POST

https://nsxmanager.your.domain/api/v1/firewall/sections/{section-id}/rules/{rule-id}?action=revise

COPY

Path Parameters

string

section-id

Required

section-id

string

rule-id

Required

rule-id

Query Parameters

string

Optional

Constraints: maxLength: 64

Identifier of the anchor rule or section. This is a required field in case operation like 'insert_before' and 'insert_after'.

string

operation

Optional

Constraints: default: insert_top

Operation

Possible values are : insert_top, insert_bottom, insert_after, insert_before,

Request Body

FirewallRule of type(s) application/json

Optional

{
    "_links": [
        {
            "action": "string",
            "href": "string",
            "rel": "string"
        }
    ],
    "_schema": "string",
    "_self": {},
    "_revision": 0,
    "_owner": {},
    "description": "string",
    "display_name": "string",
    "id": "string",
    "resource_type": "string",
    "action": "string",
    "applied_tos": [
        {
            "is_valid": false,
            "target_display_name": "string",
            "target_id": "string",
            "target_type": "string"
        }
    ],
    "destinations": [
        {
            "is_valid": false,
            "target_display_name": "string",
            "target_id": "string",
            "target_type": "string"
        }
    ],
    "destinations_excluded": false,
    "direction": "string",
    "disabled": false,
    "ip_protocol": "string",
    "is_default": false,
    "logged": false,
    "notes": "string",
    "priority": 0,
    "rule_tag": "string",
    "sources": [
        {
            "is_valid": false,
            "target_display_name": "string",
            "target_id": "string",
            "target_type": "string"
        }
    ],
    "sources_excluded": false,
    "context_profiles": [
        {
            "is_valid": false,
            "target_display_name": "string",
            "target_id": "string",
            "target_type": "string"
        }
    ],
    "extended_sources": [
        {
            "is_valid": false,
            "target_display_name": "string",
            "target_id": "string",
            "target_type": "string"
        }
    ],
    "section_id": "string",
    "services": [
        {
            "is_valid": false,
            "target_display_name": "string",
            "target_id": "string",
            "target_type": "string",
            "service": {
                "resource_type": "string"
            }
        }
    ]
}

Authentication

This operation uses the following authentication methods.

BasicAuth

Responses

200

Returns FirewallRule of type(s) application/json

This response body class contains all of the following: InlineFirewallRule1

"FirewallRule Object"

400

Returns BadRequest of type(s) application/json