Mgmt‑Interface

NOTE: It’s not supported to do a ‘create’/‘replace’/‘delete’ operation on ‘mgmt-interfaces’ or ‘mgmt-interfaces/mgmt-interface’ container node.

This document provides examples of using NETCONF to manage management interfaces on network devices.

It includes examples of retrieving management interface configurations and modifying them.

Get Mgmt Configuration

Request example to get current mgmt interface configuration via get-config

<filter type="subtree">
  <top>
    <mgmt-interfaces>
      <mgmt-interface/>
    </mgmt-interfaces>
  </top>
</filter>

Response example

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="urn:uuid:c7801c02-0c5c-4515-b8dd-453fd1e105d4">
  <data xmlns="urn:ietf:params:xml:ns:netconf:base:1.0">
    <top>
      <mgmt-interfaces xmlns="http://asterfusion.com/ns/yang/asternos-mgmt-interface">
        <mgmt-interface>
          <name>eth0</name>
          <vrf-enable>false</vrf-enable>
          <address>
            <ip-prefix>192.168.122.42/24</ip-prefix>
            <gwaddr>192.168.122.1</gwaddr>
          </address>
        </mgmt-interface>
      </mgmt-interfaces>
    </top>
  </data>
</rpc-reply>

Modify Mgmt Interface

hint{type=“warning”} NOTE: Use operation=“create” to add a new IP address to the management interface (this operation will remove old mgmt ip).

If you want to modify an mgmt ip’s gwaddr, use operation=“merge” instead.

Request example to create a new IP address on the management interface via edit-config

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="urn:uuid:c7801c02-0c5c-4515-b8dd-453fd1e105d4">
  <config><top>
    <mgmt-interfaces>
      <mgmt-interface>
        <name>eth0</name>
        <address operation="create">
          <ip-prefix>192.168.122.42/24</ip-prefix>
          <gwaddr>192.168.122.1</gwaddr>
        </address>
      </mgmt-interface>
    </mgmt-interfaces>
  </top></config>
</rpc-reply>

Response example

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="urn:uuid:ee0561f1-8170-427c-a5f5-7c6ffbfc309d">
  <ok/>
</rpc-reply>

Get MGMT Interface via RPC show-interface-mgmt

Request example to retrieves the current management interface VRF status via show-interface-mgmt

<show-interface-mgmt/>

Response example

<rpc-reply xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="urn:uuid:8a94da11-87a0-4394-a6a9-aba2208ac361">
  <data xmlns="http://asterfusion.com/ns/yang/asternos-mgmt-interface">
MGMT_VRF_CONFIG is not present.

ManagementVRF : Disabled

MGMT_VRF_CONFIG is not present.

ManagementVRF : Disabled
</data>
</rpc-reply>