Cisco CRS-1 - Carrier Routing System Router Specifications Page 96

  • Download
  • Add to my manuals
  • Print
  • Page
    / 132
  • Table of contents
  • BOOKMARKS
  • Rated. / 5. Based on customer reviews
Page view 95
9-96
Cisco CRS-1 Series Carrier Routing System XML API Guide
OL-4596-02
Chapter 9 Cisco CRS-1 Series XML Schema Versioning
Run-Time Use of Version Information
The following example shows the relevant portion of the complex type definition for an element that
carries version information:
<xsd:complexType name="ipv4_/jointfilesconvert/476768/bgp_cfg_BGP_type">
<xsd:annotation>
<xsd:documentation>Global BGP config</xsd:documentation>
<xsd:appinfo>
<MajorVersion>1</MajorVersion>
<MinorVersion>0</MinorVersion>
<TaskIdInfo TaskGrouping="Single">
<TaskName>/jointfilesconvert/476768/bgp</TaskName>
</TaskIdInfo>
</xsd:appinfo>
</xsd:annotation>
.
.
.
<xsd:attributeGroup ref="VersionAttributeGroup"/>
.
.
..
</xsd:complexType>
The attribute group VersionAttributeGroup is defined as follows:
<xsd:attributeGroup name="VersionAttributeGroup">
<xsd:annotation>
<xsd:documentation>
Common version information attributes
</xsd:documentation>
</xsd:annotation>
<xsd:attribute name="MajorVersion" type="xsd:unsignedInt" use="required"/>
<xsd:attribute name="MinorVersion" type="xsd:unsignedInt" use="required"/>
</xsd:attributeGroup>
Run-Time Use of Version Information
Each XML request must contain the clients major and minor version numbers at the appropriate
locations in the XML. These version numbers are compared to the version numbers running on the
router. The request is then accepted or rejected based on the following rules:
If there is a major version discrepancy, then the request fails.
If there is a minor version lag, that is, the client minor version is behind that of the router, then the
request is attempted.
If there is a minor version creep, that is, the client minor version is ahead of that of the router, then
the request fails.
If the version information has not been included in the request, then the request fails.
Each XML response can also contain the version numbers at the appropriate locations in the XML.
Note If the client minor version is behind that of the router, then the response may contain elements that are
not recognized by the client application. The client application must be able to handle these additional
elements.
Page view 95
1 ... 95 96 97 ... 132

Comments to this Manuals

No comments