ietf-network - User documentation

Schema Globals

Global Schema Type
rw_ypbc_RwTopology_IetfNetwork_t_schema
Global Schema Pointer
rw_ypbc_RwTopology_IetfNetwork_g_schema

ietf-network data

This module defines a common base model for a collection of nodes in a network. Node definitions s are further used in network topologies and inventories.

nd:network

Describes a network. A network typically contains an inventory of nodes, topological information (augmented through network-topology model), as well as layering information.

Key Identifiers:
XPath Path
/nd:network
XPath Keyed Path
/nd:network[nd:network-id='STRING']
RW.REST URI Path
/ietf-network:network/STRING

Fields
NameTypeDescription
network-typesCONTAINERServes as an augmentation target. The network type is indicated through corresponding presence containers augmented into this container.
network-idSTRINGIdentifies a network.
server-providedBOOLEANIndicates whether the information concerning this particular network is populated by the server (server-provided true, the general case for network information discovered from the server), or whether it is configured by a client (server-provided true, possible e.g. for service overlays managed through a controller).
supporting-networkLISTAn underlay network, used to represent layered network topologies.
nodeLISTThe inventory of nodes of this network.
linkLISTA Network Link connects a by Local (Source) node and a Remote (Destination) Network Nodes via a set of the nodes' termination points. As it is possible to have several links between the same source and destination nodes, and as a link could potentially be re-homed between termination points, to ensure that we would always know to distinguish between links, every link is identified by a dedicated link identifier. Note that a link models a point-to-point link, not a multipoint link. Layering dependencies on links in underlay topologies are not represented as the layering information of nodes and of termination points is sufficient.
l2-network-attributesCONTAINERContaining L2 network attributes
rw-network-attributesCONTAINERContaining RW network attributes

JSON Sample

XML Sample

nd:network-types

Serves as an augmentation target. The network type is indicated through corresponding presence containers augmented into this container.

Key Identifiers:
XPath Path
/nd:network/nd:network-types
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:network-types
RW.REST URI Path
/ietf-network:network/STRING/network-types

Fields
NameTypeDescription
l2-networkCONTAINERThe presence of the container node indicates L2 Topology

JSON Sample

XML Sample

l2t:l2-network

The presence of the container node indicates L2 Topology

Key Identifiers:
XPath Path
/nd:network/nd:network-types/l2t:l2-network
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:network-types/l2t:l2-network
RW.REST URI Path
/ietf-network:network/STRING/network-types/ietf-l2-topology:l2-network

JSON Sample

XML Sample

nd:supporting-network

An underlay network, used to represent layered network topologies.

Key Identifiers:
XPath Path
/nd:network/nd:supporting-network
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:supporting-network[nd:network-ref='STRING']
RW.REST URI Path
/ietf-network:network/STRING/supporting-network/STRING

Fields
NameTypeDescription
network-refLEAFREFReferences the underlay network.

JSON Sample

XML Sample

nd:node

The inventory of nodes of this network.

Key Identifiers:
XPath Path
/nd:network/nd:node
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']
RW.REST URI Path
/ietf-network:network/STRING/node/STRING

Fields
NameTypeDescription
node-idSTRINGIdentifies a node uniquely within the containing network.
supporting-nodeLISTRepresents another node, in an underlay network, that this node is supported by. Used to represent layering structure.
termination-pointLISTA termination point can terminate a link. Depending on the type of topology, a termination point could, for example, refer to a port or an interface.
l2-node-attributesCONTAINERContaining L2 node attributes
rw-node-attributesCONTAINERContaining RW node attributes

JSON Sample

XML Sample

nd:supporting-node

Represents another node, in an underlay network, that this node is supported by. Used to represent layering structure.

Key Identifiers:
XPath Path
/nd:network/nd:node/nd:supporting-node
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/nd:supporting-node[nd:network-ref='STRING'][nd:node-ref='STRING']
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/supporting-node/STRING,STRING

Fields
NameTypeDescription
network-refLEAFREFReferences the underlay network that the underlay node is part of.
node-refLEAFREFReferences the underlay node itself.

JSON Sample

XML Sample

lnk:termination-point

A termination point can terminate a link. Depending on the type of topology, a termination point could, for example, refer to a port or an interface.

Key Identifiers:
XPath Path
/nd:network/nd:node/lnk:termination-point
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/lnk:termination-point[lnk:tp-id='STRING']
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-network-topology:termination-point/STRING

Fields
NameTypeDescription
tp-idSTRINGTermination point identifier.
supporting-termination-pointLISTThe leaf list identifies any termination points that the termination point is dependent on, or maps onto. Those termination points will themselves be contained in a supporting node. This dependency information can be inferred from the dependencies between links. For this reason, this item is not separately configurable. Hence no corresponding constraint needs to be articulated. The corresponding information is simply provided by the implementing system.
l2-termination-point-attributesCONTAINERContaining L2 TP attributes
rw-termination-point-attributesCONTAINERContaining RW TP attributes

JSON Sample

XML Sample

lnk:supporting-termination-point

The leaf list identifies any termination points that the termination point is dependent on, or maps onto. Those termination points will themselves be contained in a supporting node. This dependency information can be inferred from the dependencies between links. For this reason, this item is not separately configurable. Hence no corresponding constraint needs to be articulated. The corresponding information is simply provided by the implementing system.

Key Identifiers:
XPath Path
/nd:network/nd:node/lnk:termination-point/lnk:supporting-termination-point
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/lnk:termination-point[lnk:tp-id='STRING']/lnk:supporting-termination-point[lnk:network-ref='STRING'][lnk:node-ref='STRING'][lnk:tp-ref='STRING']
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-network-topology:termination-point/STRING/supporting-termination-point/STRING,STRING,STRING

Fields
NameTypeDescription
network-refLEAFREFThis leaf identifies in which topology the supporting termination point is present.
node-refLEAFREFThis leaf identifies in which node the supporting termination point is present.
tp-refLEAFREFReference to the underlay node, must be in a different topology

JSON Sample

XML Sample

l2t:l2-termination-point-attributes

Containing L2 TP attributes

Key Identifiers:
XPath Path
/nd:network/nd:node/lnk:termination-point/l2t:l2-termination-point-attributes
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/lnk:termination-point[lnk:tp-id='STRING']/l2t:l2-termination-point-attributes
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-network-topology:termination-point/STRING/ietf-l2-topology:l2-termination-point-attributes

Fields
NameTypeDescription
descriptionSTRINGPort description
maximum-frame-sizeUINT32Maximum frame size
mac-addressSTRINGInterface MAC address
eth-encapsulationIDREFEncapsulation type of this ternimation point.
port-vlan-idUINT16Port VLAN ID
vlan-id-nameLISTInterface configured VLANs
encapsulationIDREFEncapsulation type of this termination point.
tp-stateENUMState of the termination point

JSON Sample

XML Sample

l2t:vlan-id-name

Interface configured VLANs

Key Identifiers:
XPath Path
/nd:network/nd:node/lnk:termination-point/l2t:l2-termination-point-attributes/l2t:vlan-id-name
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/lnk:termination-point[lnk:tp-id='STRING']/l2t:l2-termination-point-attributes/l2t:vlan-id-name[l2t:vlan-id='0']
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-network-topology:termination-point/STRING/ietf-l2-topology:l2-termination-point-attributes/vlan-id-name/0

Fields
NameTypeDescription
vlan-idUINT16VLAN ID
vlan-nameSTRINGVLAN Name

JSON Sample

XML Sample

rw-topology:rw-termination-point-attributes

Containing RW TP attributes

Key Identifiers:
XPath Path
/nd:network/nd:node/lnk:termination-point/rw-topology:rw-termination-point-attributes
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/lnk:termination-point[lnk:tp-id='STRING']/rw-topology:rw-termination-point-attributes
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-network-topology:termination-point/STRING/rw-topology:rw-termination-point-attributes

Fields
NameTypeDescription
descriptionSTRINGPort description
ip-attributesCONTAINERL2 termination points containing IP addresses

JSON Sample

XML Sample

rw-topology:ip-attributes

L2 termination points containing IP addresses

Key Identifiers:
XPath Path
/nd:network/nd:node/lnk:termination-point/rw-topology:rw-termination-point-attributes/rw-topology:ip-attributes
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/lnk:termination-point[lnk:tp-id='STRING']/rw-topology:rw-termination-point-attributes/rw-topology:ip-attributes
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-network-topology:termination-point/STRING/rw-topology:rw-termination-point-attributes/ip-attributes

Fields
NameTypeDescription
ip-addressesLIST

JSON Sample

XML Sample

rw-topology:ip-addresses

Key Identifiers:
XPath Path
/nd:network/nd:node/lnk:termination-point/rw-topology:rw-termination-point-attributes/rw-topology:ip-attributes/rw-topology:ip-addresses
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/lnk:termination-point[lnk:tp-id='STRING']/rw-topology:rw-termination-point-attributes/rw-topology:ip-attributes/rw-topology:ip-addresses[rw-topology:ip='UNION_VALUE']
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-network-topology:termination-point/STRING/rw-topology:rw-termination-point-attributes/ip-attributes/ip-addresses/UNION_VALUE

Fields
NameTypeDescription
ipUNIONIPv4 or IPv6 address

JSON Sample

XML Sample

l2t:l2-node-attributes

Containing L2 node attributes

Key Identifiers:
XPath Path
/nd:network/nd:node/l2t:l2-node-attributes
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/l2t:l2-node-attributes
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-l2-topology:l2-node-attributes

Fields
NameTypeDescription
nameSTRINGNode name
descriptionSTRINGNode description
management-addressLEAF_LISTSystem management address
management-vidUINT16System management VID
nick-nameLEAF_LISTNickname of the RBridge
flagLEAF_LISTNode operational flags

JSON Sample

XML Sample

l2t:management-address

System management address

Key Identifiers:
XPath Path
/nd:network/nd:node/l2t:l2-node-attributes/l2t:management-address
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/l2t:l2-node-attributes/l2t:management-address
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-l2-topology:l2-node-attributes/management-address

JSON Sample

XML Sample

l2t:nick-name

Nickname of the RBridge

Key Identifiers:
XPath Path
/nd:network/nd:node/l2t:l2-node-attributes/l2t:nick-name
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/l2t:l2-node-attributes/l2t:nick-name
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-l2-topology:l2-node-attributes/nick-name

JSON Sample

XML Sample

l2t:flag

Node operational flags

Key Identifiers:
XPath Path
/nd:network/nd:node/l2t:l2-node-attributes/l2t:flag
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/l2t:l2-node-attributes/l2t:flag
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/ietf-l2-topology:l2-node-attributes/flag

JSON Sample

XML Sample

rw-topology:rw-node-attributes

Containing RW node attributes

Key Identifiers:
XPath Path
/nd:network/nd:node/rw-topology:rw-node-attributes
XPath Keyed Path
/nd:network[nd:network-id='STRING']/nd:node[nd:node-id='STRING']/rw-topology:rw-node-attributes
RW.REST URI Path
/ietf-network:network/STRING/node/STRING/rw-topology:rw-node-attributes

Fields
NameTypeDescription
nameSTRINGNode name
ovs-bridge-nameSTRINGName of OVS bridge

JSON Sample

XML Sample

l2t:l2-network-attributes

Containing L2 network attributes

Key Identifiers:
XPath Path
/nd:network/l2t:l2-network-attributes
XPath Keyed Path
/nd:network[nd:network-id='STRING']/l2t:l2-network-attributes
RW.REST URI Path
/ietf-network:network/STRING/ietf-l2-topology:l2-network-attributes

Fields
NameTypeDescription
nameSTRINGName of the L2 network
flagLEAF_LISTL2 network flags

JSON Sample

XML Sample

l2t:flag

L2 network flags

Key Identifiers:
XPath Path
/nd:network/l2t:l2-network-attributes/l2t:flag
XPath Keyed Path
/nd:network[nd:network-id='STRING']/l2t:l2-network-attributes/l2t:flag
RW.REST URI Path
/ietf-network:network/STRING/ietf-l2-topology:l2-network-attributes/flag

JSON Sample

XML Sample

rw-topology:rw-network-attributes

Containing RW network attributes

Key Identifiers:
XPath Path
/nd:network/rw-topology:rw-network-attributes
XPath Keyed Path
/nd:network[nd:network-id='STRING']/rw-topology:rw-network-attributes
RW.REST URI Path
/ietf-network:network/STRING/rw-topology:rw-network-attributes

Fields
NameTypeDescription
nameSTRINGName of the RW Topology network
sdn-account-nameSTRINGName of the SDN account from which topology is got

JSON Sample

XML Sample

ietf-network-topology - User documentation

Schema Globals

Global Schema Type
rw_ypbc_RwTopology_IetfNetworkTopology_t_schema
Global Schema Pointer
rw_ypbc_RwTopology_IetfNetworkTopology_g_schema

rw-topology - User documentation

Schema Globals

Global Schema Type
rw_ypbc_RwTopology_RwTopology_t_schema
Global Schema Pointer
rw_ypbc_RwTopology_RwTopology_g_schema