<get-configuration>

Usage

<rpc>
    <get-configuration [database="(candidate|committed)"] [format="(text|xml)"]
                                        [inherit="inherit"]/>

    <get-configuration [database="(candidate|committed)"] [format="(text|xml)"]]
                                        [inherit="inherit"]>
        <!-- tag elements representing hierarchy level or object to display -->
    </get-configuration>
</rpc>

Description

Request configuration data from the JUNOScript server. The database, format, and inherit attributes specify the source and formatting of the data to display. To display the entire hierarchy, emit the empty <get-configuration/> tag. To display one hierarchy level or a single configuration object, emit tag elements within the <get-configuration> tag element to represent all levels of the configuration hierarchy from the root (represented by the <configuration> tag element) down to the level or object to display. To represent the requested level, emit it as an empty tag. To represent the requested object, emit its container tag element and identifier tag element only, not any tag elements that represent other characteristics.

Attributes

database—Specifies the configuration hierarchy from which to display data. There are two acceptable values:

• candidate—The current candidate configuration
• committed—The currently active (most recently committed) configuration on the routing platform

format—Specifies the format in which the JUNOScript server returns the configuration data. There are two acceptable values:

• text—Configuration statements are formatted as ASCII text, using the newline character, tabs and other white space, braces, and square brackets to indicate the hierarchical relationships between the statements. This is the format used in configuration files stored on the routing platform and displayed by the CLI show configuration command.
• xml—Configuration statements are represented by the corresponding JUNOScript tag elements. This is the default value if the format attribute is omitted.

inherit—Specifies that the JUNOScript server enclose tag elements that are inherited from configuration groups within the tag elements that are inheriting them, and not display the <groups> tag element. The only acceptable value is inherit.

See Also

<rpc>