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
| Name | Type | Description |
|---|---|---|
| network-types | CONTAINER | Serves as an augmentation target. The network type is indicated through corresponding presence containers augmented into this container. |
| network-id | STRING | Identifies a network. |
| server-provided | BOOLEAN | Indicates 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-network | LIST | An underlay network, used to represent layered network topologies. |
| node | LIST | The inventory of nodes of this network. |
| link | LIST | A 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-attributes | CONTAINER | Containing L2 network attributes |
| rw-network-attributes | CONTAINER | Containing 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
| Name | Type | Description |
|---|---|---|
| l2-network | CONTAINER | The 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
| Name | Type | Description |
|---|---|---|
| network-ref | LEAFREF | References 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
| Name | Type | Description |
|---|---|---|
| node-id | STRING | Identifies a node uniquely within the containing network. |
| supporting-node | LIST | Represents another node, in an underlay network, that this node is supported by. Used to represent layering structure. |
| termination-point | LIST | 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. |
| l2-node-attributes | CONTAINER | Containing L2 node attributes |
| rw-node-attributes | CONTAINER | Containing 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
| Name | Type | Description |
|---|---|---|
| network-ref | LEAFREF | References the underlay network that the underlay node is part of. |
| node-ref | LEAFREF | References 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
| Name | Type | Description |
|---|---|---|
| tp-id | STRING | Termination point identifier. |
| supporting-termination-point | LIST | 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. |
| l2-termination-point-attributes | CONTAINER | Containing L2 TP attributes |
| rw-termination-point-attributes | CONTAINER | Containing 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
| Name | Type | Description |
|---|---|---|
| network-ref | LEAFREF | This leaf identifies in which topology the supporting termination point is present. |
| node-ref | LEAFREF | This leaf identifies in which node the supporting termination point is present. |
| tp-ref | LEAFREF | Reference 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
| Name | Type | Description |
|---|---|---|
| description | STRING | Port description |
| maximum-frame-size | UINT32 | Maximum frame size |
| mac-address | STRING | Interface MAC address |
| eth-encapsulation | IDREF | Encapsulation type of this ternimation point. |
| port-vlan-id | UINT16 | Port VLAN ID |
| vlan-id-name | LIST | Interface configured VLANs |
| encapsulation | IDREF | Encapsulation type of this termination point. |
| tp-state | ENUM | State 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
| Name | Type | Description |
|---|---|---|
| vlan-id | UINT16 | VLAN ID |
| vlan-name | STRING | VLAN 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
| Name | Type | Description |
|---|---|---|
| description | STRING | Port description |
| ip-attributes | CONTAINER | L2 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
| Name | Type | Description |
|---|---|---|
| ip-addresses | LIST |
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
| Name | Type | Description |
|---|---|---|
| ip | UNION | IPv4 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
| Name | Type | Description |
|---|---|---|
| name | STRING | Node name |
| description | STRING | Node description |
| management-address | LEAF_LIST | System management address |
| management-vid | UINT16 | System management VID |
| nick-name | LEAF_LIST | Nickname of the RBridge |
| flag | LEAF_LIST | Node 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
| Name | Type | Description |
|---|---|---|
| name | STRING | Node name |
| ovs-bridge-name | STRING | Name of OVS bridge |
JSON Sample
XML Sample
lnk:link
A 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.
Key Identifiers:| XPath Path | /nd:network/lnk:link |
| XPath Keyed Path | /nd:network[nd:network-id='STRING']/lnk:link[lnk:link-id='STRING'] |
| RW.REST URI Path | /ietf-network:network/STRING/ietf-network-topology:link/STRING |
Fields
| Name | Type | Description |
|---|---|---|
| source | CONTAINER | This container holds the logical source of a particular link. |
| destination | CONTAINER | This container holds the logical destination of a particular link. |
| link-id | STRING | The identifier of a link in the topology. A link is specific to a topology to which it belongs. |
| supporting-link | LIST | Identifies the link, or links, that this link is dependent on. |
| l2-link-attributes | CONTAINER | Containing L2 link attributes |
| rw-link-attributes | CONTAINER | Containing RW link attributes |
JSON Sample
XML Sample
lnk:source
This container holds the logical source of a particular link.
Key Identifiers:| XPath Path | /nd:network/lnk:link/lnk:source |
| XPath Keyed Path | /nd:network[nd:network-id='STRING']/lnk:link[lnk:link-id='STRING']/lnk:source |
| RW.REST URI Path | /ietf-network:network/STRING/ietf-network-topology:link/STRING/source |
Fields
| Name | Type | Description |
|---|---|---|
| source-node | LEAFREF | Source node identifier, must be in same topology. |
| source-tp | LEAFREF | Termination point within source node that terminates the link. |
JSON Sample
XML Sample
lnk:destination
This container holds the logical destination of a particular link.
Key Identifiers:| XPath Path | /nd:network/lnk:link/lnk:destination |
| XPath Keyed Path | /nd:network[nd:network-id='STRING']/lnk:link[lnk:link-id='STRING']/lnk:destination |
| RW.REST URI Path | /ietf-network:network/STRING/ietf-network-topology:link/STRING/destination |
Fields
| Name | Type | Description |
|---|---|---|
| dest-node | LEAFREF | Destination node identifier, must be in the same network. |
| dest-tp | LEAFREF | Termination point within destination node that terminates the link. |
JSON Sample
XML Sample
lnk:supporting-link
Identifies the link, or links, that this link is dependent on.
Key Identifiers:| XPath Path | /nd:network/lnk:link/lnk:supporting-link |
| XPath Keyed Path | /nd:network[nd:network-id='STRING']/lnk:link[lnk:link-id='STRING']/lnk:supporting-link[lnk:network-ref='STRING'][lnk:link-ref='STRING'] |
| RW.REST URI Path | /ietf-network:network/STRING/ietf-network-topology:link/STRING/supporting-link/STRING,STRING |
Fields
| Name | Type | Description |
|---|---|---|
| network-ref | LEAFREF | This leaf identifies in which underlay topology supporting link is present. |
| link-ref | LEAFREF | This leaf identifies a link which is a part of this link's underlay. Reference loops, in which a link identifies itself as its underlay, either directly or transitively, are not allowed. |
JSON Sample
XML Sample
l2t:l2-link-attributes
Containing L2 link attributes
Key Identifiers:| XPath Path | /nd:network/lnk:link/l2t:l2-link-attributes |
| XPath Keyed Path | /nd:network[nd:network-id='STRING']/lnk:link[lnk:link-id='STRING']/l2t:l2-link-attributes |
| RW.REST URI Path | /ietf-network:network/STRING/ietf-network-topology:link/STRING/ietf-l2-topology:l2-link-attributes |
Fields
| Name | Type | Description |
|---|---|---|
| name | STRING | Link name |
| flag | LEAF_LIST | Link flags |
| rate | DECIMAL64 | Link rate |
| delay | UINT32 | Link delay in microseconds |
| srlg | LEAF_LIST | List of Shared Risk Link Groups this link belongs to. |
JSON Sample
XML Sample
l2t:flag
Link flags
Key Identifiers:| XPath Path | /nd:network/lnk:link/l2t:l2-link-attributes/l2t:flag |
| XPath Keyed Path | /nd:network[nd:network-id='STRING']/lnk:link[lnk:link-id='STRING']/l2t:l2-link-attributes/l2t:flag |
| RW.REST URI Path | /ietf-network:network/STRING/ietf-network-topology:link/STRING/ietf-l2-topology:l2-link-attributes/flag |
JSON Sample
XML Sample
l2t:srlg
List of Shared Risk Link Groups this link belongs to.
Key Identifiers:| XPath Path | /nd:network/lnk:link/l2t:l2-link-attributes/l2t:srlg |
| XPath Keyed Path | /nd:network[nd:network-id='STRING']/lnk:link[lnk:link-id='STRING']/l2t:l2-link-attributes/l2t:srlg |
| RW.REST URI Path | /ietf-network:network/STRING/ietf-network-topology:link/STRING/ietf-l2-topology:l2-link-attributes/srlg |
JSON Sample
XML Sample
rw-topology:rw-link-attributes
Containing RW link attributes
Key Identifiers:| XPath Path | /nd:network/lnk:link/rw-topology:rw-link-attributes |
| XPath Keyed Path | /nd:network[nd:network-id='STRING']/lnk:link[lnk:link-id='STRING']/rw-topology:rw-link-attributes |
| RW.REST URI Path | /ietf-network:network/STRING/ietf-network-topology:link/STRING/rw-topology:rw-link-attributes |
Fields
| Name | Type | Description |
|---|---|---|
| name | STRING | Link name |
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
| Name | Type | Description |
|---|---|---|
| name | STRING | Name of the L2 network |
| flag | LEAF_LIST | L2 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
| Name | Type | Description |
|---|---|---|
| name | STRING | Name of the RW Topology network |
| sdn-account-name | STRING | Name 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 |