Create a firewall device

Creates a firewall device, which assigns a firewall to a service (referred to as the device's entity) and applies the firewall's rules to the device.

  • Currently, devices with linode, interface, and nodebalancer entity types are accepted.

    • The linode type is not allowed for Linodes using Linode interfaces.
    • The interface type is not allowed for legacy config interfaces. For VPC and public legacy config profile interfaces, the firewall is applied through the linode device.
  • Firewalls only apply to inbound TCP traffic to NodeBalancers.

  • A firewall can be assigned to multiple services at a time.

  • A service can have one assigned firewall at a time.

  • Assigned Linodes must not have any ongoing live migrations.

  • A firewall_device_add event is generated when the firewall device is added successfully.

LB

linode-cli firewalls device-create 123 \ --id 456 \ --type "linode"
Learn more...
firewall:read_write
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.

Responses

Response body
object
date-time

Filterable, Read-only When this device was created.

entity
object

Read-only The compute service or interface this firewall is assigned to.

integer

The entity's ID.

string

Read-only The entity's label.

string
enum

The entity's type.

linode nodebalancer interface

url

Read-only The API URL path you can use to access this entity.

integer

Filterable The device's unique ID.

date-time

Filterable, Read-only When this device was last updated.

Language
Credentials