Cisco CRS-1 - Carrier Routing System Router Api Manual page 54

Native Data Operation Content
<NeighborTable>, and its child element signifying a particular neighbor is <Neighbor>. To specify the
key, an extension to the basic parent-child hierarchy is used, where a <Naming> element appears under
the child element, containing the key to the table entry.
The following example shows hierarchy tables:
<Configuration>
<BGP>
.
.
.
<BGPEntity>
</BGPEntity>
.
.
.
</BGP>
<ISIS>
.
.
.
</ISIS>
</Configuration>
Use tables to access a specific data item for an entry (for example, getting the remote autonomous system
(AS) number for neighbor 10.0.101.6), or all data for an entry, or even all data for all entries.
Tables also provide the extra feature of allowing the list of entries in the table to be returned (see the
section
Returned entries from tables can be used to show all neighbors configured, for example, without showing
all of their data.
Tables in the operational data model often have a further feature when retrieving their entries. The tables
can be filtered on particular criteria to return just the set of entries that fulfill those criteria. For instance,
the table of BGP neighbors can be filtered on address family or AS number or update group, or all three.
To apply a filter to a table, use another extension to the basic parent-child hierarchy, where a <Filter>
element appears under the table element, containing the criteria to filter on.
The following example shows table filtering:
<Operational>
<BGP>
<NeighborTable>
Cisco CRS-1 Series Carrier Routing System XML API Guide
4-54
<NeighborTable>
<Neighbor>
<Naming>
<IPAddress>
<IPV4Address>10.0.101.6</IPV4Address>
</IPAddress>
</Naming>
<RemoteAS>6</RemoteAS>
</Neighbor>
<Neighbor>
<Naming>
<IPAddress>
<IPV4Address>10.0.101.7</IPV4Address>
</IPAddress>
</Naming>
<RemoteAS>7</RemoteAS>
</Neighbor>
</NeighborTable>
"XML Request Using Operation Scope (Content
<Filter>
<BGP_AFFilter>
Chapter 4 Cisco CRS-1 Series XML and Native Data Operations
Attribute)".
OL-4596-01