Configuring ARP

This section contains payload examples and CLIs to demonstrate how to use the NX-API REST API to configure ARP settings on Cisco Nexus 3000 and 9000 Series switches and to show how the REST APIs correspond to the CLI commands. For more information about ARP, see the Cisco Nexus 9000 Series NX-OS Security Configuration Guide, Release 7.x.

https://www.cisco.com/c/en/us/support/switches/nexus-9000-series-switches/products-installation-and-configuration-guides-list.html/

Configuring Global ARP Settings

Configuring Global ARP Settings

POST http://<IP_Address>/api/node/mo/sys/arp/inst.json

{
  "arpInst": {
    "attributes": {
      "allowStaticArpOutsideSubnet": "disabled",
      "cacheLimit": "174080",
      "offListTimeout": "180",
      "rarpFabricFwding": "disabled",
      "rarpFabricFwdingRate": "200",
      "timeout": "1500"
    }
  }
}

This example configures global ARP settings.

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

Configuring ARP Interface Settings

Configuring ARP Interface Settings

POST http://<IP_Address>/api/mo/sys/arp/inst/dom-default/if-[eth1/2].json

{
  "arpIf": {
    "attributes": {
      "gratuitousHsrpDup": "enabled",
      "gratuitousRequest": "enabled",
      "gratuitousUpdate": "enabled",
      "localProxyArp": "disabled",
      "proxyArp": "disabled",
      "timeout": "1500"
    }
  }
}

This example configures ARP settings for an interface

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

Configuring Static Adjacency

Configuring Static Adjacency

POST http://<IP_Address>/api/mo/sys/arp/inst/dom-default/if-[eth4/2]/sadj-[192.0.20.123].json

{
  "arpStAdjEp": {
    "attributes": {
      "ip": "192.0.20.123",
      "mac": "00:01:00:01:00:01"
    }
  }
}

This example configures a static adjacent endpoint.

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

Configuring Glean Throttling

Configuring Glean Throttling

POST http://<IP_Address>/api/mo/sys/arp/inst/ipgleanthrottle.json

{
  "arpIpv4Throttle": {
    "attributes": {
      "adminSt": "enabled",
      "maxPacket": "1000",
      "syslog": "10000",
      "timeout": "300"
    }
  }
}

When forwarding an incoming IP packet in a line card, if the ARP request for the next hop is not resolved, the line card forwards the packets to the supervisor. The supervisor resolves the MAC address for the next hop and programs the hardware. You can enable glean throttling rate limiters to protect the supervisor from the glean traffic.

This example configures glean throttling.

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

Configuring ARP Event Logging

Configuring ARP Event Logging

POST http://<IP_Address>/api/mo/sys/arp/inst/evtLogs-cli.json.json

{
  "arpEventLogs": {
    "attributes": {
      "eventType": "cli",
      "logSize": "large"
    }
  }
}

This example configures logging of ARP CLI events

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/

Configuring ARP Synchronize for VPC

Configuring ARP Synchronize for VPC

POST http://<IP_Address>/api/mo/sys/arp/inst/vpc.json

{
  "arpVpc": {
    "attributes": {
      "arpSync": "enabled"
    },
    "children": [
      {
        "arpVpcDom": {
          "attributes": {
            "arpSync": "enabled"
          }
        }
      }
    ]
  }
}

Enabling IP ARP synchronization allows faster convergence of address tables between the VPC peers.

See the NX-API DME Model Reference for detailed information about classes and attributes described in the payload: https://developer.cisco.com/site/nx-os/docs/nexus-model-reference/