firewall_info.md

firewall_info

Get info about a Linode Firewall.

• Examples
• Parameters
• Return Values

Examples

- name: Get info about a Firewall by label
  linode.cloud.firewall_info:
    label: 'my-firewall' 

- name: Get info about a Firewall by id
  linode.cloud.firewall_info:
    id: 12345

Parameters

Field	Type	Required	Description
id	int	Optional	The unique id of the Firewall. Optional if label is defined. (Conflicts With: label)
label	str	Optional	The Firewall’s label. Optional if id is defined. (Conflicts With: id)

Return Values

• firewall - The Firewall description in JSON serialized form.

  • Sample Response:

    {
      "created": "2018-01-01T00:01:01",
      "id": 123,
      "label": "firewall123",
      "rules": {
        "inbound": [
          {
            "action": "ACCEPT",
            "addresses": {
              "ipv4": [
                "192.0.2.0/24"
              ],
              "ipv6": [
                "2001:DB8::/32"
              ]
            },
            "description": "An example firewall rule description.",
            "label": "firewallrule123",
            "ports": "22-24, 80, 443",
            "protocol": "TCP"
          }
        ],
        "inbound_policy": "DROP",
        "outbound": [
          {
            "action": "ACCEPT",
            "addresses": {
              "ipv4": [
                "192.0.2.0/24"
              ],
              "ipv6": [
                "2001:DB8::/32"
              ]
            },
            "description": "An example firewall rule description.",
            "label": "firewallrule123",
            "ports": "22-24, 80, 443",
            "protocol": "TCP"
          }
        ],
        "outbound_policy": "DROP"
      },
      "status": "enabled",
      "tags": [
        "example tag",
        "another example"
      ],
      "updated": "2018-01-02T00:01:01"
    }

  • See the Linode API response documentation for a list of returned fields

• devices - A list of Firewall devices JSON serialized form.

  • Sample Response:

    [
      {
        "created": "2018-01-01T00:01:01",
        "entity": {
          "id": 123,
          "label": "my-linode",
          "type": "linode",
          "url": "/v4/linode/instances/123"
        },
        "id": 123,
        "updated": "2018-01-02T00:01:01"
      }
    ]

  • See the Linode API response documentation for a list of returned fields