Operation Triggering - Cisco CRS-1 - Carrier Routing System Router Api Manual

Native Data Operation Content
<Neighbor>
<Timers>
</Timers>
</Neighbor>
Null values will most often be used for elements that correspond to fields within an XML instance. Any
element that can be set to "nil" in an XML instance will have the attribute "nillable" set to "true" in the
XML schema definition for that element. For example:
<xsd:element name="HoldTime" type="xsd:unsignedInt" nillable="true"/>
Any XML instance document that uses the nil mechanism must declare the "XML Schema for Instance
Documents" namespace, which contains the "xsi:nil" definition. Responses to native data operations
returned from the Cisco CRS-1 Series router will declare this namespace in the operation tag. For
example:
<Get xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

Operation Triggering

When structuring an XML request, the user should remember the following general rule regarding what
to specify in the XML for an operation to take place: As a client XML request is parsed by the Cisco
CRS-1 Series router, the specified operation takes place whenever a closing tag is encountered after a
series of one or more opening tags (but only when the closing tag is not the </Naming> tag).
The following example shows a request to get the BGP timer values for a particular BGP autonomous
system. In this example, the <Get> operation is triggered when the <GlobalTimers/> tag is encountered.
Sample XML Client Request to Trigger a <Get> Operation for BGP Timer Values
<?xml version="1.0" encoding="UTF-8"?>
<Request MajorVersion="1" MinorVersion="0">
<Get>
</Get>
</Request>
Sample XML Response from the Cisco CRS-1 Series Router
<?xml version="1.0" encoding="UTF-8"?>
<Response MajorVersion="1" MinorVersion="0">
<Get>
Cisco CRS-1 Series Carrier Routing System XML API Guide
4-56
<KeepAlive>60</KeepAlive>
<HoldTime xsi:nil="true"/>
<Configuration>
<BGP MajorVersion="1" MinorVersion="0">
<AS>
<Naming>
<AS>3</AS>
</Naming>
<Global>
<GlobalTimers/>
</Global>
</AS>
</BGP>
</Configuration>
<Configuration>
<BGP MajorVersion="1" MinorVersion="0">
<AS>
<Naming>
<AS>1</AS>
</Naming>
Chapter 4 Cisco CRS-1 Series XML and Native Data Operations
OL-4596-01