policy-stringmap
The following operations can be performed on "policy-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.
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.
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.
Example
i)add stringmap custom_stringmap .This creates a new string map with name custom_stringmap.
show policy stringmap
Displays a list of available string maps.
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.
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
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.
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>
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.
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.
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