beautypg.com

4 exposure options – TANDBERG Gatekeeper/Border Controller API D14172.01 User Manual

Page 22

background image

TANDBERG Gatekeeper/Border Controller API User Guide

D14172.01

page 22 of 84

If the instance number of a given element is omitted, the expression addresses all instances of this
element


Example 2.1

To address the Address sub-element of DNS Server 2:

XPath:

IP/DNS/Server[2]/Address

SimplePath: IP DNS Server 2 Address


To address the Address sub-element of all DNS Server elements:

XPath:

IP/DNS/Server/Address

SimplePath: IP DNS Server Address

2.1.4 Exposure options

By adding an exposure option after the address (XPath or SimplePath) expression, the system can be
instructed to return only parts of the information within an element structure.


Supported exposure options:

“-“ hides all value elements

“--" hides all sub-elements




Example 2.2

Request for Zone 1 element with no exposure option:

xstatus zones zone 1

*s Zones:
Zone 1 (status=Active):
Name: "MyNeighbor"
Gatekeeper (status=Active):
Address: "10.0.0.10"
Port: 1719
Calls: /
Bandwidth:
Total: "Unlimited"
PerCall: "Unlimited"
Used: 0
*s/end

Request for Zone1 element with exposure option “-“:

xstatus zones zone 1 -

*s Zones:
Zone 1 (status=Active):
Gatekeeper (status=Active):
Calls: /
Bandwidth:
*s/end