firewall_rules

Creates, updates, deletes, gets or lists a firewall_rules resource.

Overview

Name	firewall_rules
Type	Resource
Id	linode.networking.firewall_rules

Fields

The following fields are returned by SELECT queries:

get

The requested Firewall Rules.

Name	Datatype	Description
fingerprint	string	Read-only The fingerprint is a 32-bit hash. It represents the firewall rules as an 8 character hex string. You can use fingerprint to compare rule versions. (example: 997dd135)
inbound	array	The inbound rules for the firewall, as a JSON array. (x-linode-cli-format: json)
inbound_policy	string	The default behavior for inbound traffic. This setting can be overridden by updating the inbound.action property of the Firewall Rule. (ACCEPT, DROP) (example: DROP)
outbound	array	The outbound rules for the firewall, as a JSON array. (x-linode-cli-format: json)
outbound_policy	string	The default behavior for outbound traffic. This setting can be overridden by updating the outbound.action property of the Firewall Rule. (ACCEPT, DROP) (example: ACCEPT)
version	integer	Read-only The firewall's rule version. The first version is 1. The version number is incremented when the firewall's rules change.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	firewallId		Returns the inbound and outbound Rules for a Firewall. Learn more... Learn more...
update	replace	firewallId		Updates the inbound and outbound Rules for a Firewall. - Assigned Linodes must not have any ongoing live migrations. - Note. This operation replaces all of a Firewall's inbound and outbound rulesets with the values specified in your request. Learn more... Learn more...

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
firewallId	string	ID of the Firewall to access.

SELECT examples

get

Returns the inbound and outbound Rules for a Firewall.

Learn more...

Learn more...

SELECT
fingerprint,
inbound,
inbound_policy,
outbound,
outbound_policy,
version
FROM linode.networking.firewall_rules
WHERE firewallId = '{{ firewallId }}' -- required
;

REPLACE examples

update

Updates the inbound and outbound Rules for a Firewall.

- Assigned Linodes must not have any ongoing live migrations.

- Note. This operation replaces all of a Firewall's inbound and outbound rulesets with the values specified in your request.

Learn more...

Learn more...

REPLACE linode.networking.firewall_rules
SET 
inbound = '{{ inbound }}',
outbound = '{{ outbound }}',
inbound_policy = '{{ inbound_policy }}',
outbound_policy = '{{ outbound_policy }}'
WHERE 
firewallId = '{{ firewallId }}' --required
RETURNING
fingerprint,
inbound,
inbound_policy,
outbound,
outbound_policy,
version;