Техническое Руководство для Cisco Cisco Security Manager 4.0

 

 

 

  

15 

XML request is invalid. (This error is caused if the XML request does not adhere to 
the published XML schema or if the XML is illformed or invalid. Though this is a 
system wide error, this error is usually set inside a specific response object if the 
application is able to parse the request method that is being called)  

17 

protVersion is optional and if an unsupported version is specified the this error is 
returned. Supported version is 1.0 in this release. 

21 

Internal Error 

25 

API Service is disabled 

26 

API license is not applied 

Additional method specific errors codes are defined in the respective sections. All response objects extend from the 
Base Error object. The error content is set in cases the CSM API encounters any error when servicing a method. 

The error messages returned are of two general types: 

1. 

Common/System wide errors : As defined in the table above. These errors are generally due to some 

unrecoverable errors encountered by the application. These errors can occur when servicing any request. 

2. 

Method Specific errors : These are application errors that are specific to method being processed. 

 

The system wide errors return the Base Error content as the only response: 

 

<?xml

 

version

="1.0" 

encoding

="UTF-8"?> 

<

ns1:baseError

 xmlns:ns1="csm"> 

 

<

code

>1</

code

> 

 

<

description

>General Failure</

description

> 

</

ns1:baseError

> 

 

Method specific errors encode the Base Error content inside the response object. Following is an example of an error 
encountered when servicing a login request: 

<

?xml

 

version

="1.0" 

encoding

="UTF-8"?> 

<

ns1:loginResponse

 

xmlns:ns1

="csm"> 

 

<

protVersion

>1.0</

protVersion

> 

 

<

error

> 

 

 

<

code

>7</

code

> 

 

 

<

description

> Authentication Failure: Invalid username and/or password specified.</

description

> 

 

</

error

> 

 

<

serviceVersion

>1.0</

serviceVersion

> 

 

<

sessionTimeoutInMins

>15</

sessionTimeoutInMins

> 

</

ns1:loginResponse

>