[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director

FirewallRule

Describes a Firewall rule.


Properties

string
name Required

Name for the rule.


action Optional

The action to be applied to all the traffic that meets the firewall rule criteria. It determines if the rule permits or blocks traffic. This property is now deprecated and replaced with actionValue. Property is required if actionValue is not set.


array of EntityReference
applicationPortProfiles Optional

The list of application ports where this firewall rule is applicable. Null value or an empty list will be treated as “ANY” which means rule applies to all ports.


appliedTo Optional

Used to limit application of this firewall rule to the specified Org VDC or segment backed external network. Only networks connected as service interfaces are usable.


string
comments Optional

Text for user entered comments on the firewall rule. Length cannot exceed 2048 characters.

Added in 36.2

string
description Optional

array of EntityReference
destinationFirewallGroups Optional

List of source groups for firewall rule. It specifies the destinations of network traffic for the firewall rule. Null value or an empty list will be treated as “ANY” which means traffic to any destination. For Distributed Firewall rules, an entry with an id of urn:vcloud:firewallGroup:internal can be used to specify all internal vDC Group network traffic.


direction Optional

Specifies the direction of the network traffic. Default value is IN_OUT.


boolean
enabled Optional

Whether the firewall rule is enabled.


string
id Optional

The unique id of this firewall rule. If a rule with the ruleId is not already present, a new rule will be created. If it already exists, the rule will be updated.


ipProtocol Optional

Type of IP packet that should be matched while enforcing the rule. Default value is IPV4_IPV6.


boolean
logging Optional

Whether packet logging is enabled for firewall rule.


string
actionValue Optional

The action to be applied to all the traffic that meets the firewall rule criteria. It determines if the rule permits or blocks traffic. Property is required if action is not set. Below are valid values.

  • ALLOW permits traffic to go through the firewall.
  • DROP blocks the traffic at the firewall. No response is sent back to the source.
  • REJECT blocks the traffic at the firewall. A response is sent back to the source.

Added in 35.2

array of EntityReference
networkContextProfiles Optional

The list of layer 7 network context profiles where this firewall rule is applicable. Null value or an empty list will be treated as “ANY” which means rule applies to all applications and domains.


array of EntityReference
sourceFirewallGroups Optional

List of source groups for firewall rule. It specifies the sources of network traffic for the firewall rule. Null value or an empty list will be treated as “ANY” which means traffic from any source. For Distributed Firewall rules, an entry with an id of urn:vcloud:firewallGroup:internal can be used to specify all internal vDC Group network traffic.


version Optional

This property describes the current version of the entity. To prevent clients from overwriting each other’s changes, update operations must include the version which can be obtained by issuing a GET operation. If the version number on an update call is missing, the operation will be rejected. This is only needed on update calls.

JSON Example

{
	"name": "string"
}

Vendor Extensions

This class contains the following vendor extensions defined in the spec:
x-vcloud-property-annotations:
    action:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
        x-vcloud-deprecated-alternative: actionValue
        x-vcloud-deprecated-in: "35.2"
    actionValue:
        x-vcloud-added-in: "35.2"
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    appliedTo:
        x-vcloud-added-in: "37.1"
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    comments:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    description:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    destinationFirewallGroups:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    direction:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    enabled:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    id:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    ipProtocol:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    logging:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    name:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    networkContextProfiles:
        x-vcloud-added-in: "35.0"
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    services:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
    sourceFirewallGroups:
        x-vcloud-constraints:
            - constraint: NonSearchable
            - constraint: NonSortable
[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director
Availability
Added in 34.0
Used By

DfwRule
EdgeFirewallRule

Feedback

Was this page helpful?