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

## <get-config>

#### Usage

`

    <rpc>
    <get-config>
            <source>
                <candidate/>
            </source>
    </get-config>

    <get-config>
            <source>
                <candidate/>
            </source>
            <filter type="subtree">
                <configuration>
                    <!- - tag elements for each configuration element to return - ->
                </configuration>
            </filter>
    </get-config>
    </rpc>
    ]]>]]>

`

#### Description

Request configuration data from the NETCONF server. The child tag elements <source> and <filter> specify the source and scope of data to display:

- To display the entire candidate configuration, enclose the <source> tag element and <candidate/> tag in the <get-config> tag element.
- To display one or more sections of the configuration hierarchy (hierarchy levels or configuration objects), enclose the appropriate child tag elements in the <source> and <filter> tag elements.

<candidate/>—Represents the candidate configuration.

<configuration>—Encloses tag elements that specify which configuration elements to return.

<filter>—Encloses the <configuration> tag element. The mandatory type attribute indicates the kind of syntax used to represent the requested configuration elements; the only acceptable value is subtree.

To specify the configuration elements to return, include within the <filter> tag element the XML tag elements that represent all levels of the configuration hierarchy from the root (represented by the <configuration> tag element) down to each element to display. For information about the syntax for representing each kind of element, see Specifying the Scope of Configuration Information to Return. For information about the configuration elements available in the current version of the SRC software, see the SRC XML API Configuration Reference.

<source>—Encloses the tag that specifies the source of the configuration data. To specify the candidate configuration, include the <candidate/>tag.

#### Usage Guidelines

See Requesting Configuration Information.

#### Related Topics

]]>]]>, <data>, <rpc>

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