Modifying The Target Configuration - Cisco CRS-1 - Carrier Routing System Router Api Manual

Chapter 2 Cisco CRS-1 Series XML Router Configuration and Management

Modifying the Target Configuration

The client application modifies the target configuration as needed using <Delete> and <Set> requests.
The client application optionally uses CLI commands encoded within XML tags to modify the target
configuration.
If the operation to modify the target configuration is successful, the response will contain just the
<Delete/> or <Set/> tag. If the operation fails, the response will include the element or object class
hierarchy passed in the request along with one or more ErrorCode and ErrorMsg attributes indicating the
cause of the failure.
A syntax check is performed whenever the client application writes to the target configuration. A
successful write to the target configuration, however, does not guarantee that the configuration change
will succeed when a subsequent commit of the target configuration is attempted. For example, errors
resulting from failed verifications may be returned from the commit. The error information returned
from the XML API is described in more detail in the section
XML
The content and format of <Delete> and <Set> requests are described in additional detail in
"Cisco CRS-1 Series XML and Native Data Operations."
described
The following example shows a simple <Set> request to set the default metric and routing timers for a
particular BGP autonomous system:
Sample XML Client Request to Set Timer Settings in the Target Configuration
<?xml version="1.0" encoding="UTF-8"?>
<Request>
<Set>
</Set>
</Request>
Sample XML Response from the Cisco CRS-1 Series Router
<?xml version="1.0" encoding="UTF-8"?>
<Response>
<Set/>
</Response>
To replace a portion of the configuration, the client application should use a <Delete> operation to
remove the unwanted configuration followed by a <Set> operation to add the new configuration. An
explicit "replace" option is not supported.
OL-4596-01
Responses".
Chapter 6, "Cisco CRS-1 Series XML and Encapsulated CLI Operations."
<Configuration>
<BGP>
<AutonomousSystemTable>
<AutonomousSystem>
<Naming>
<ASNumber>1</ASNumber>
</Naming>
<AddressFamilyIndependent>
<DefaultMetric>150</DefaultMetric>
<Timers>
<KeepAlive>180</KeepAlive>
<HoldTime>600</HoldTime>
</Timers>
</AddressFamilyIndependent>
</AutonomousSystem>
</AutonomousSystemTable>
</BGP>
</Configuration>
"Error Reporting in Cisco CRS-1 Series
Encoding CLI commands within XML tags is
Cisco CRS-1 Series Carrier Routing System XML API Guide
Configuration Operations
Chapter 4,
2-31