policy-stringmap¶
The following operations can be performed on "policy-stringmap":
add| rm| set| unset| bind| unbind| show|
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 <name> [-comment <string>]
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.
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 <name>
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
set policy stringmap¶
Modifies the attributes of an existing string map.
Synopsis¶
set policy stringmap <name> -comment <string>
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
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 <name> -comment
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 <name> <key> <value> [-comment <string>]
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 <name> <key>
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.
show policy stringmap¶
Displays a list of available string maps.
Synopsis¶
show policy stringmap [<name>]
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