Document URL: 

https://docs.openshift.com/container-platform/4.5/networking/multiple_networks/attaching-pod.html#nw-multus-advanced-annotations_attaching-pod

Section Number and Name: 

Networking --> Multiple networks --> Attaching a Pod to an additional network --> Specifying Pod-specific addressing and routing options

Describe the issue: 

The "macvlan CNI plug-in JSON configuration object using static IP and MAC address" example lacks the 'name' field in the CNI JSON configuration. This causes the multus admission webhook to reject the network and the example never works.

Suggestions for improvement: 

Making it look similar to this:
~~~
{
  "cniVersion": "0.3.1",
  "name": "<name>",
  "plugins": [{ 
      "type": "macvlan",
      "capabilities": { "ips": true }, 
      "master": "eth0", 
      "mode": "bridge",
      "ipam": {
        "type": "static"
      }
    }, {
      "capabilities": { "mac": true }, 
      "type": "tuning"
    }]
}
~~~

Note the additional `"name": "<name>"` field.

Additional information: 

Other examples I have seen do not have this issue (e.g. https://docs.openshift.com/container-platform/4.5/networking/multiple_networks/configuring-macvlan.html)