Get Next Operation Tag; Xml Request Batching - Cisco CRS-1 - Carrier Routing System Router Api Manual

Chapter 1 Cisco CRS-1 Series XML API Overview

Get Next Operation Tag

The <GetNext> tag is used to retrieve the next portion of a large response. It can be used as required to
retrieve an oversize response following a request using one of the other operation types. The GetNext
operation tag is provided in
Table 1-5
Tags
<GetNext>
The XML schema definition for the <GetNext> operation type tag is contained in the schema file
Note
common_types.xsd (see
The get next operation is described further in
Note
Retrieval (Iterators)."

XML Request Batching

The Cisco CRS-1 Series XML interface supports the combining of several requests or operations into a
single request. When multiple operations are specified in a single request, the response will contain the
same operation tags and in the same order as they appeared in the request.
Batched requests are performed "best effort." For example, if there are operations 1 through 3 in the
request and operation 2 fails, then operation 3 will still be attempted.
If a <Get> operation could return a large amount of data (potentially more than the size of one iterator
chunk), then it is advisable to place any subsequent operations into a new request because as soon as an
iterator boundary is reached, any subsequent operations in the request will automatically fail.
The following example shows a simple request containing six different operations:
Sample XML Client Batched Requests
<?xml version="1.0" encoding="UTF-8"?>
<Request MajorVersion="1" MinorVersion="0">
<Lock/>
<Get>
</Get>
<Set>
OL-4596-01
Table
GetNext Operation Tag
Chapter 13, "Cisco CRS-1 Series XML
<Configuration>
.
.
.
Get operation content goes here
...
</Configuration>
<Configuration>
.
.
.
Set operation content goes here
.
1-5.
Description
Get the next portion of a response. Supports iterators for large
requests.
Chapter 7, "Cisco CRS-1 Series XML and Large Data
Cisco CRS-1 Series Carrier Routing System XML API Guide
Cisco CRS-1 Series XML API Tags
Schemas").
1-23