Limiting The Number Of Table Entries Returned (Count Attribute) - Cisco CRS-1 - Carrier Routing System Router Api Manual

Chapter 5 Cisco CRS-1 Series XML and Native Data Access Techniques
</Get>
</Request>

Limiting the Number of Table Entries Returned (Count Attribute)

The Count attribute is used on any table element within a <Get> operation to specify the maximum
number of table entries to be returned in a response. When the Count attribute is specified, the naming
information within the request is used to identify the starting point within the table, that is, the first table
entry of interest. If no naming information is specified, the response will start at the beginning of the
table.
For a table whose entries are containers, the Count attribute can be used only if the Content attribute is
also specified with a value of Entries. This restriction does not apply to a table whose children are leaf
nodes.
As an alternative to the use of the Count attribute, the Cisco CRS-1 Series XML interface supports the
retrieval of large XML responses in blocks via iterators. For more information on iterators, see
Chapter 7, "Cisco CRS-1 Series XML and Large Data Retrieval (Iterators)."
The following example shows how to use the Count attribute to retrieve the configuration information
for the first five BGP neighbors starting with the address 10.0.101.1:
OL-4596-01
<Naming>
<IPAddress>
<IPV4Address>10.0.101.1</IPV4Address>
</IPAddress>
</Naming>
</Neighbor>
<Neighbor>
<Naming>
<IPAddress>
<IPV4Address>10.0.101.2</IPV4Address>
</IPAddress>
</Naming>
</Neighbor>
<Neighbor>
<Naming>
<IPAddress>
<IPV4Address>10.0.101.3</IPV4Address>
</IPAddress>
</Naming>
</Neighbor>
<Neighbor>
<Naming>
<IPAddress>
<IPV4Address>10.0.101.4</IPV4Address>
</IPAddress>
</Naming>
</Neighbor>
.
.
.
more neighbors returned here
.
.
.
</NeighborTable>
</BGPEntity>
</AS>
</BGP>
</Configuration>
Available Set of Native Data Access Techniques
Cisco CRS-1 Series Carrier Routing System XML API Guide
5-75