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.
label	str	Optional	The Firewall’s label. Optional if id is defined.

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