Manipulating Grouped AVPs
You can configure rules to manipulate grouped AVPs in two ways: by setting action to group-manip or by using the avp-path parameter.
To manipulate AVPs at the same level within the same grouped AVP, you
configure rules with the group-manip action. This action tells
the SBC to perform rules in the specified diameter-manipulation element within the
context of the specified grouped AVP. You can use multiple subsequent rules with this
action to move down a grouped AVP hierarchy chain, and you can use any action, other
than diameter-manip, in the subsequent rules to manipulate the
AVPs within the final level. For example, you can use the
group-manip action to:
- Duplicate an AVP within a grouped AVP at the same level.
- Delete an AVP from a grouped AVP.
- Replace the value of an AVP within a grouped AVP with a new value, or with the value of another AVP at the same level.
- Add one or more AVPs within a grouped AVP.
To manipulate AVPs at different levels, including within different grouped
AVPs, at different levels within the same grouped AVP, or at root level, you configure
rules with the avp-path parameter. This parameter tells the SBC
the exact path to the AVP to act on, relative to the root level. It is valid for the
store and add actions only. For
example, you can use the avp-path parameter to:
- Copy a root-level AVP to a grouped AVP.
- Copy an AVP from a grouped AVP to root level.
- Copy an AVP from a grouped AVP to a different level within the same grouped AVP.
- Copy an AVP within a grouped AVP to a different grouped AVP.
To manipulate non-grouped AVPs at the root level, you use any of the other actions and do not specify avp-path.
See Diameter Manipulation Examples for example rules for manipulating grouped AVPs using either method.