ADC CLI Commands

policy-stringmap

The following operations can be performed on “policy-stringmap”:

set unbind show add rm bind unset

set policy stringmap

Modifies the attributes of an existing string map.

Synopsis

set policy stringmap -comment

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

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.

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

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 [-comment ]

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

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

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 [-comment ]

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.

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 -comment

policy-stringmap