List a Linode's firewalls

get

https://api.linode.com/{apiVersion}/linode/instances/{linodeId}/firewalls

View Firewall information for Firewalls assigned to this Linode.

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: list_linode_firewalls
OAuth scopes. Your user needs these scopes assigned. Learn more.
- Scopes: linodes:read_only

CLI

linode-cli linodes firewalls-list 123

Learn more

Responses

Response body

object

data

array of objects

data

object

created

date-time

Filterable, Read-only When this Firewall was created.

entities

array of objects

Read-only The Linodes, NodeBalancers, and Linode interfaces this firewall is assigned to.

entities

object

integer

The entity's ID.

label

string | null

Read-only The entity's label.

parent_entity

object | null

Read-only The Linode this linode_interface is assigned to. Returns null when the entity type is linode or nodebalancer.

type

string

enum

The entity's type.

linode linode_interface nodebalancer

url

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

integer

Filterable, Read-only The Firewall's unique ID.

label

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.

rules

object

The inbound and outbound access rules to apply to the Firewall.

A Firewall may have up to 25 rules across its inbound and outbound rulesets.

Multiple rules are applied in order. If two rules conflict, the first rule takes precedence. For example, if the first rule accepts inbound traffic from an address, and the second rule drops inbound traffic the same address, the first rule applies and inbound traffic from that address is accepted.

status

string

enum

Read-only The status of this Firewall.

When a Firewall is first created its status is enabled.
Run the Update a firewall operation to set a Firewall's status to enabled or disabled.
Run the Delete a firewall operation to delete a Firewall.

enabled disabled deleted

tags

updated

date-time

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

page

integer

Read-only The current page.

pages

integer

Read-only The total number of pages.

results

integer

Read-only The total number of results.

Language

Credentials


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.linode.com/v4/linode/instances/linodeId/firewalls \
3
     --header 'accept: application/json'


xxxxxxxxxx
75
}
1
{
2
  "data": [
3
    {
4
      "created": "2025-01-01T00:01:01",
5
      "entities": [
6
        {
7
          "id": 123,
8
          "label": "my-linode",
9
          "parent_entity": {
10
            "id": 5000,
11
            "label": "linode5000",
12
            "parent_entity": null,
13
            "type": "linode",
14
            "url": "/v4/linode/instances/5000"
15
          },
16
          "type": "linode_interface",
17
          "url": "/v4/linode/instances/123"
18
        }
19
      ],
20
      "id": 123,
21
      "label": "firewall123",
22
      "rules": {
23
        "fingerprint": "997dd135",
24
        "inbound": [
25
          {
26
            "action": "ACCEPT",
27
            "addresses": {
28
              "ipv4": [
29
                "192.0.2.0/24",
30
                "198.51.100.2/32"
31
              ],
32
              "ipv6": [
33
                "2001:DB8::/128"
34
              ]
35
            },
36
            "description": "An example firewall rule description.",
37
            "label": "firewallrule123",
38
            "ports": "22-24, 80, 443",
39
            "protocol": "TCP"
40
          }
41
        ],
42
        "inbound_policy": "DROP",
43
        "outbound": [
44
          {
45
            "action": "ACCEPT",
46
            "addresses": {
47
              "ipv4": [
48
                "192.0.2.0/24",
49
                "198.51.100.2/32"

200Returns a paginated list of Firewalls assigned to this Linode.

defaultSee Errors for the range of possible error response codes.