Update firewall rules

put

https://api.linode.com/{apiVersion}/networking/firewalls/{firewallId}/rules

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.

Permissions and scopes

To call this operation, you need permissions, based on the model you're using:

Identity and access permissions. Your user needs a role with these permissions. Learn more.
- Permissions: update_firewall_rules
OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: firewall:read_write

CLI

linode-cli firewalls rules-update 123 \
  --inbound '[{"action":"ACCEPT", "protocol": "TCP", "ports": "22, 80, 8080, 443", "addresses": {"ipv4": ["192.0.2.0/24", "198.51.100.2/32"], "ipv6": ["2001:DB8::/128"]}}]' \
  --outbound '[{"action":"DROP","protocol": "TCP", "ports": "49152-65535", "addresses": {"ipv4": ["192.0.2.0/24", "198.51.100.2/32"], "ipv6": ["2001:DB8::/128`"]}}]'

Learn more

Path Params

apiVersion

string

enum

required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:

firewallId

integer

required

ID of the Firewall to access.

Body Params

The Firewall Rules information to update.

inbound

array of objects

The inbound rules for the firewall, as a JSON array.

inbound

outbound

array of objects

The outbound rules for the firewall, as a JSON array.

outbound

inbound_policy

string

enum

The default behavior for inbound traffic. This setting can be overridden by updating the inbound.action property of the Firewall Rule.

Allowed:

outbound_policy

string

enum

The default behavior for outbound traffic. This setting can be overridden by updating the outbound.action property of the Firewall Rule.

Allowed:

Responses

200Firewall Rules updated successfully.

defaultSee Errors for the range of possible error response codes.