Cisco Cisco Configuration Engine 3.5.3 Guida Dello Sviluppatore
3-7
Cisco Configuration Engine Software Development Kit API Reference and Programmer Guide 3.5.3
OL-17661-04
Chapter 3 Configuration Service
Template File Manager
Limitations
The CE XML DTD has the following limitations:
•
The <path> tag is NOT supported in Cisco Configuration Engine. The <path> tag is ignored and all
template management operations are performed locally on the host file system in the directory
$CISCO_CE_HOME/Templates.
template management operations are performed locally on the host file system in the directory
$CISCO_CE_HOME/Templates.
•
The <url> tag under source tag must be empty, which will signal that the content is in the payload
<content>.
<content>.
•
According to the DTD, multiple files can be specified in each import/export/remove operation;
however, for the Cisco Configuration Engine only a single file is handled in each operation.
however, for the Cisco Configuration Engine only a single file is handled in each operation.
Error Codes
The response XML includes error codes that indicate the status of the requested operation. The codes
are listed in the table below.
are listed in the table below.
Table 3-1
Template File Management Error Codes
Error Code
Error message
Description
200
Success
The request succeeded.
400
Request missing
No data was posted to the
servlet.
servlet.
401
Authentication required
Authentication missing or failed.
403
Deletion denied
The requested file could not be
deleted because it does not exist
or the user has insufficient
permission.
deleted because it does not exist
or the user has insufficient
permission.
404
Contains a list of missing
required parameters
required parameters
Missing required parameter.
405
Not supported or implemented
The request is either not
supported or implemented.
supported or implemented.
406
File with specified filename
already exists
already exists
The parameter passed is not
acceptable because the filename
specified already exists.
acceptable because the filename
specified already exists.
417
File not found
The requested file either does not
exist or the user does not have
access permission.
exist or the user does not have
access permission.
498
Invalid XML request
The XML file posted to the
servlet is either badly formed or
invalid.
servlet is either badly formed or
invalid.
499
Any
Any error other than ones
described above
described above
500
Internal server error
Unexpected internal error.