Mapping For Objects That Have An Identifier - Juniper JUNOS OS 10.3 - XML MANAGEMENT PROTOCOL GUIDE 6-30-2010 Manual

Junos 10.3 Junos XML Management Protocol Guide

Mapping for Objects That Have an Identifier

16
At some hierarchy levels, the same kind of configuration object can occur multiple times.
Each instance of the object has a unique identifier to distinguish it from the other instances.
In the CLI notation, the parent statement for such an object consists of a keyword and
identifier of the following form:
keyword identifier {
... configuration statements for individual characteristics ...
}
keyword is a fixed string that indicates the type of object being defined, and
the unique name for this instance of the type. In the Junos XML API, the tag element
corresponding to the keyword is a container tag element for child tag elements that
represent the object's characteristics. The container tag element's name generally
matches the string.
keyword
The Junos XML API differs from the CLI in its treatment of the identifier. Because the
Junos XML API does not allow container tag elements to contain both other tag elements
and untagged character data such as an identifier name, the identifier must be enclosed
in a tag element of its own. Most frequently, identifier tag elements for configuration
objects are called
<name>
names other than <name>
configuration object, consult the entry for the object in the Junos XML API Configuration
Reference.
NOTE: The Junos OS reserves the prefix
defined within the
junos-defaults
start with the string junos-
Identifier tag elements also constitute an exception to the general XML convention that
tag elements at the same level of hierarchy can appear in any order; the identifier tag
element always occurs first within the container tag element.
The configuration for most objects that have identifiers includes additional leaf
statements, which represent other characteristics of the object. For example, each BGP
group configured at the [edit protocols bgp group]
(the identifier) and can have leaf statements for other characteristics such as type, peer
autonomous system (AS) number, and neighbor address. For information about the
. Some objects have multiple identifiers, which usually have
. To verify the name of each identifier tag element for a
for the identifiers of configuration groups
junos-
configuration group. User-defined identifiers cannot
.
hierarchy level has an associated name
identifier
Copyright © 2010, Juniper Networks, Inc.
is