policy-stringmap¶
The following operations can be performed on "policy-stringmap":
show| unset| set| add| bind| unbind| rm|
show policy stringmap¶
Displays a list of available string maps.
Synopsis¶
show policy stringmap [
Arguments¶
name Name of the string map to display. If a name is not provided, a list of all the configured string maps is shown.
Output¶
stateflag comment Comments associated with the string map or key-value pair bound to this string map.
key Character string constituting the key to be bound to the string map. The key is matched against the data processed by the operation that uses the string map. The default character set is ASCII. UTF-8 characters can be included if the character set is UTF-8. UTF-8 characters can be entered directly (if the UI supports it) or can be encoded as a sequence of hexadecimal bytes '\xNN'. For example, the UTF-8 character 'ü' can be encoded as '\xC3\xBC'.
value Character string constituting the value associated with the key. This value is returned when processed data matches the associated key. Refer to the key parameter for details of the value character set.
devno count
Example¶
show stringmap custom_stringmap . Displays all the key-value pairs of a string map whose name is custom-stringmap
unset policy stringmap¶
Use this command to remove policy stringmap settings.Refer to the set policy stringmap command for meanings of the arguments.
Synopsis¶
unset policy stringmap
set policy stringmap¶
Modifies the attributes of an existing string map.
Synopsis¶
set policy stringmap
Arguments¶
name Name of the string map to be modified.
comment Comments associated with the string map or key-value pair bound to this string map.
Example¶
i)set stringmap custom_stringmap -comment "custom string map is for URLs." .This updates the comment associated with the string map whose name is custom_stringmap
add policy stringmap¶
Creates a string map. You must use the 'bind policy stringmap' command to bind strings to this string map.
Synopsis¶
add policy stringmap
Arguments¶
name Unique name for the string map. Not case sensitive. Must begin with an ASCII letter or underscore (_) character, and must consist only of ASCII alphanumeric or underscore characters. Must not begin with 're' or 'xp' or be a word reserved for use as an expression qualifier prefix (such as HTTP) or enumeration value (such as ASCII). Must not be the name of an existing named expression, pattern set, dataset, string map, or HTTP callout.
comment Comments associated with the string map or key-value pair bound to this string map.
Example¶
i)add stringmap custom_stringmap .This creates a new string map with name custom_stringmap.
bind policy stringmap¶
Binds a key and its associated value to a string map. If the key already exists and has a different value, the old value is overwritten with the new value.
Synopsis¶
bind policy stringmap
Arguments¶
name Name of the string map to which to bind the key-value pair.
key Character string constituting the key to be bound to the string map. The key is matched against the data processed by the operation that uses the string map. The default character set is ASCII. UTF-8 characters can be included if the character set is UTF-8. UTF-8 characters can be entered directly (if the UI supports it) or can be encoded as a sequence of hexadecimal bytes '\xNN'. For example, the UTF-8 character 'ü' can be encoded as '\xC3\xBC'.
value Character string constituting the value associated with the key. This value is returned when processed data matches the associated key. Refer to the key parameter for details of the value character set.
comment Comments associated with the string map or key-value pair bound to this string map.
Example¶
bind stringmap custom_stringmap "key-string" "value-string" .This adds the key "key-string" and its associated value "value-string" to the string map whose name is custom_stringmap.
unbind policy stringmap¶
Removes a key from the string map.
Synopsis¶
unbind policy stringmap
Arguments¶
name Name of the string map from which to remove a key.
key Key to remove from the string map.
Example¶
unbind stringmap custom_stringmap key1 .This removes the key "key1" and its associated value from the string map whose name is custom_stringmap.
rm policy stringmap¶
Removes a string map. String maps can be removed only if not used in any part of policy, action, or expression.
Synopsis¶
rm policy stringmap
Arguments¶
name Name of the string map to remove.
Example¶
i)rm stringmap custom_stringmap .This removes a string map whose name is custom_stringmap