Update a firewall

Updates information for a firewall.

  • Assigned Linodes must not have any ongoing live migrations.

  • If this operation changes a firewall's status, it generates a corresponding firewall_enable or firewall_disable event.

This operation doesn't affect some parts of a firewall's configuration:

  • This operation doesn't set a firewall's devices. Instead, run the Create a firewall device and Delete a firewall device operations to assign and remove this firewall from services.

  • A firewall's rules can't be changed with this operation. Instead, run the Update firewall rules operation to update your rules.

  • Use this operation to set a firewall's status to enabled or disabled. But to set it to deleted, run the Delete a firewall operation.

  • An assigned default firewall can't be disabled.

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
  • OAuth scopes. Your user needs these scopes assigned. Learn more.

    • Scopes: firewall:read_write

CLI

linode-cli firewalls update 123 \
  --status disabled

Learn more

Path Params
string
enum
required

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

Allowed:
integer
required

ID of the Firewall to access.

Body Params
string
length between 3 and 32

Filterable The Firewall's label, for display purposes only.

Firewall labels have the following constraints:

  • Must begin and end with an alphanumeric character.
  • May only consist of alphanumeric characters, hyphens (-), underscores (_) or periods (.).
  • Cannot have two hyphens (--), underscores (__) or periods (..) in a row.
  • Must be between 3 and 32 characters.
  • Must be unique.
string
enum

The status to be applied to this Firewall.

  • When a Firewall is first created its status is enabled.
  • An assigned default firewall can't be disabled.
  • Run the Delete a firewall operation to delete a Firewall.
Allowed:
tags
array of strings

Filterable An array of tags applied to this object. Tags are for organizational purposes only.

tags
Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json