firewall_rule_versions
Creates, updates, deletes, gets or lists a firewall_rule_versions resource.
Overview
| Name | firewall_rule_versions |
| Type | Resource |
| Id | linode.networking.firewall_rule_versions |
Fields
The following fields are returned by SELECT queries:
- get_firewall_rule_version
- get_firewall_rule_versions
Returns a rule version.
| Name | Datatype | Description |
|---|---|---|
id | integer | Filterable, Read-only The Firewall's unique ID. |
created | string (date-time) | Filterable, Read-only When this Firewall was created. (example: 2018-01-01T00:01:01) |
label | string | 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. (example: firewall123, pattern: ^a-zA-Z+$) |
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 | 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. (example: enabled) |
tags | array | Filterable An array of tags applied to this object. Tags are for organizational purposes only. |
updated | string (date-time) | Filterable, Read-only When this Firewall was last updated. (example: 2018-01-02T00:01:01) |
Returns information for all rule versions for this firewall.
| Name | Datatype | Description |
|---|---|---|
id | integer | Filterable, Read-only The Firewall's unique ID. |
created | string (date-time) | Filterable, Read-only When this Firewall was created. (example: 2018-01-01T00:01:01) |
label | string | 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. (example: firewall123, pattern: ^a-zA-Z+$) |
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 | 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. (example: enabled) |
tags | array | Filterable An array of tags applied to this object. Tags are for organizational purposes only. |
updated | string (date-time) | Filterable, Read-only When this Firewall was last updated. (example: 2018-01-02T00:01:01) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_firewall_rule_version | select | Get a specific firewall rule version for an enabled or disabled firewall.Learn more... Learn more... | ||
get_firewall_rule_versions | select | Lists the current and historical rules of the firewall (that is not deleted), using version. Whenever rules update, the version increments from 1.Learn more... Learn more... |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|
SELECT examples
- get_firewall_rule_version
- get_firewall_rule_versions
Get a specific firewall rule version for an enabled or disabled firewall.
Learn more...
Learn more...
SELECT
id,
created,
label,
rules,
status,
tags,
updated
FROM linode.networking.firewall_rule_versions;
Lists the current and historical rules of the firewall (that is not deleted), using version. Whenever rules update, the version increments from 1.
Learn more...
Learn more...
SELECT
id,
created,
label,
rules,
status,
tags,
updated
FROM linode.networking.firewall_rule_versions;