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.