Document Type Definition - Cisco 4700M Administration Manual

Information About XML
Table 8-1
Return Code
501
505
The following HTTP headers are supported:
•
•
•
•
For example, when an XML error occurs, the HTTP response contains a 200 return code. The portion of
the original XML document with the error is returned with an error element that contains the error type
and description.
The following is a typical example of an XML error response:
<response_xml>
<config_command>
<command>
interface vlan 20
no shut
description xyz
exit
</command>
<status code = '200' text='XML_CMD_FAILURE'>
<error_command> description xyz </error_command>
<error_message> unrecognized element - description </error_message>
</status>
</config_command>
</response_xml>
The returned error codes correspond to the attributes of the configuration element. The possible returned
XML error can include any of the following:
XML_ERR_WELLFORMEDNESS
XML_ERR_ATTR_INVALID
XML_ERR_ELEM_INVALID
XML_ERR_CDL_NOT_FOUN
XML_ERR_INTERNAL
XML_ERR_COMM_FAILURE
XML_ERR_VSH_PARSER
XML_ERR_VSH_CONF_APPLY

Document Type Definition

A DTD is the basis for XML configuration documents that you create using the ACE. The purpose of a
DTD is to define the legal building blocks of an XML document by defining the document structure with
a list of legal elements.
DTD designates an XML list that specifies precisely which elements can appear in a request, query, or
response document. It also specifies the contents and attributes of the elements. A DTD can be declared
inline in your XML document or as an external reference.
Cisco 4700 Series Application Control Engine Appliance Administration Guide
8-4
Supported HTTP Return Codes for XML (continued)
Description
Not Implemented ("POST" not specified)
HTTP Version Not Supported ("1.0" or "1.1" not specified)
Content-Length (nonzero value required for all POSTs)
Connection (close value indicates that a request should not be persistent)
WWW-Authenticate (sent to the client when credentials are required and missing)
Authorization (sent from the client to specify basic credentials in base 64 encoding)
/* not a well formed xml document */
/* found invalid value attribute */
/* found invalid value unrecognized */
/* parser cdl file not found */
/* internal memory or coding error */
/* communication failure */
/* vsh parse error on the given command */
/* vsh unable to apply the configuration */
Chapter 8 Configuring the XML Interface
OL-20823-01