fw sam_policy get

Description

The "fw sam_policy get and "fw6 sam_policy get" commands show all the configured Rate Limiting rules.

Also, see the "sam_alert" command in the R80.20 CLI Reference Guide.

Important:

Notes:

  • These commands are interchangeable:

    • For IPv4: "g_fw sam_policy" and "g_fw samp"

    • For IPv6: "g_fw6 sam_policy" and "g_fw6 samp"

  • Security Group Members store the SAM Policy rules in the $FWDIR/database/sam_policy.db file.

  • Security Group Members store the SAM Policy management settings in the $FWDIR/database/sam_policy.mng file.

Best Practice - SAM Policy rules consume some CPU resources on Security Group Members. Set an expiration for rules that gives you time to investigate, but does not affect performance. Keep only the required SAM Policy rules. If you confirm that an activity is risky, edit the Security PolicyClosed Collection of rules that control network traffic and enforce organization guidelines for data protection and access to resources with packet inspection., educate users, or otherwise handle the risk.

Syntax for IPv4

g_fw [-d] sam_policy get [-l] [-u '<Rule UID>'] [-k '<Key>' -t <Type> [+{-v '<Value>'}] [-n]]

Syntax for IPv6

g_fw6 [-d] sam_policy get [-l] [-u '<Rule UID>'] [-k '<Key>' -t <Type> [+{-v '<Value>'}] [-n]]

Parameters

Note - All these parameters are optional.

Parameter

Description

-d

Runs the command in debug mode.

Use only if you troubleshoot the command itself.

Best Practice - If you use this parameter, then redirect the output to a file, or use the script command to save the entire CLI session.

-l

Controls how to print the rules:

-u '<Rule UID>'

Prints the rule specified by its Rule UID or its zero-based rule index.

The quote marks and angle brackets ('<...>') are mandatory.

-k '<Key>'

Prints the rules with the specified predicate key.

The quote marks are mandatory.

-t <Type>

Prints the rules with the specified predicate type.

For Rate Limiting rules, you must always use "-t in".

+{-v '<Value>'}

Prints the rules with the specified predicate values.

The quote marks are mandatory.

-n

Negates the condition specified by these predicate parameters:

  • -k

  • -t

  • +-v

Examples