Document toolboxDocument toolbox

Relay Agent Filter

Field NameData TypeRequired (Yes/No)Associated GUI FieldAssociated PAPI MethodUsage and Guidelines
Header-RelayAgentFilterStringYes

Example: RelayAgentFilter
nameStringYesNamenameExample: Relay Agent Filter 1
_new_nameStringNo

Add this field to overwrite the name field when you select the overwrite or merge option.
commentStringNoCommentcomment
circuit_id_ruleStringNoCircuit ID: Match Valueis_circuit_idExample: MATCHES_VALUE
circuit_idStringNoCircuit IDcircuit_id_name
remote_id_ruleStringNoRemote ID: Match Valueis_remote_idExample: MATCHES_VALUE
remote_idIntegerNoRemote IDremote_id_nameExample: 50
EA-SiteStringNoExtensible Attribute Siteextensible_ attributesEA-Site is an example of a predefined extensible attribute. You can add other predefined attributes to the data file. For information about data format and examples, see Data Specific Guidelines.
EA-UsersStringNoExtensible Attribute Usersextensible_ attributesEA-Users is an example of a user defined attribute. You can add other user defined attributes to the data file. For information about data format and examples, see Data Specific Guidelines.

Examples

This section contains examples of how to create data files for relay agent filters. All examples use comma as the separator. You can use other supported separators, such as semicolon, space, or tab.

Adding a Relay Agent Filter

This example shows how to import a relay agent filter with a circuit ID and a remote ID.

header-RelayAgentFilter,name*,circuit_id_rule,circuit_id,remote_id_rule,remote_id RelayAgentFilter,relayagent1,MATCHES_VALUE,123456,MATCHES_VALUE,abcd

Overwriting Relay Agent Filter Data

This example shows how to overwrite the circuit ID and remote ID of an existing relay agent filter.

header-RelayAgentFilter,name*,circuit_id_rule,circuit_id,remote_id_rule remote_id RelayAgentFilter,relayagent1,MATCHES_VALUE,336699,MATCHES_VALUE,xyz

Merging Relay Agent Filter Data

This example shows how to merge a comment and extensible attribute Site to an existing relay agent filter.

header-RelayAgentFilter,name*,comment,EA-Site RelayAgentFilter,relayagent1,This is a comment.,USA