Update a Rule Set

Beta Updates the label, description, and rules for a Rule Set. If the Rule Set is successfully updated, the changes apply to all firewalls that reference it.

  • If the Rule Set's label or description fields are not provided in the update request, the existing values remain unchanged.

  • When updating the rules, you must include the entire final rules expression. This operation replaces all of a Rule Set's inbound and outbound with the values specified in your request.

If the Rule Set was created by a managed service (is_service_defined is true), it can't be updated using a non-service account.

linode-cli firewalls ruleset-update 123 \
  --label ruleset123 \
  --description rulesetABC \
  --rules '[{"action":"ACCEPT", "description":"ABC-NeT-RuleSet", "protocol": "TCP", "ports": "22-24, 80, 443, 6443", "addresses": {"ipv4": ["192.0.2.0/24", "198.51.100.2/32", "pl::vpcs:1234", "pl::vpcs:<current>"], "ipv6": ["2001:DB8::/128", "pl::vpcs:1234", "pl::vpcs:<current>"]}}]'

<https://techdocs.akamai.com/cloud-computing/docs/getting-started-with-the-linode-cli>
firewall:read_write

<https://techdocs.akamai.com/linode-api/reference/get-started#oauth>
Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
integer
required

ID of the Rule Set to access.

Body Params
string
length between 1 and 255

Describes this Rule Set. For display purposes only.

string | null

Filterable Unique, user-defined label for this Rule Set. This label helps you identify and describe your Rule Set.

rules
array of objects

The inbound or outbound access rules for the Rule Set. A Rule Set can have a total of 25 inbound and outbound rules. 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 from the same address, the first rule applies, and inbound traffic from that address is accepted.

rules
Responses

Language
Credentials
Response
Choose an example:
application/json