[Contents] [Prev] [Next] [Index] [Report an Error]

Handling an Error or Warning

If the NETCONF server encounters an error condition, it emits an <rpc-error> tag element containing tag elements that describe the error:




<rpc-reply xmlns="URN "xmlns:sdx="URL”>

    <rpc-error>
        <error-severity>error-severity</error-severity>

        <error-path>error-path</error-path>

        <error-message>error-message</error-message>

        <error-info>
            <bad-element>command-or-statement</bad-element>

        </error-info>
    </rpc-error>
</rpc-reply>
]]>]]>

<bad-element> identifies the command or configuration statement that was being processed when the error or warning occurred. For a configuration statement, the <error-path> tag element enclosed in the <rpc-error> tag element specifies the statement’s parent hierarchy level.
<error-message> describes the error or warning in a natural-language text string.
<error-path> specifies the path to the configuration hierarchy level at which the error or warning occurred, in the form of the CLI configuration mode banner.
<error-severity> indicates the severity of the event that caused the NETCONF server to return the <rpc-error> tag element. The two possible values are error and warning.

An error can occur while the server is performing any of the following operations, and the server can send a different combination of child tag elements in each case:

Processing an operational request submitted by a client application
Changing, committing, or closing a configuration as requested by a client application
Parsing a configuration submitted by a client application in an <edit-config> tag element

Client applications must be prepared to receive and handle an <rpc-error> tag element at any time. The information in any response tag elements already received and related to the current request might be incomplete. The client application can include logic for deciding whether to discard or retain the information.

When the <error-severity> tag element has the value error, the usual response is for the client application to discard the information and terminate. When the <error-severity> tag element has the value warning, indicating that the problem isless serious, the usual response is for the client application to log the warning or pass it to the user, but to continue parsing the server’s response.

[Contents] [Prev] [Next] [Index] [Report an Error]