14.2. Network Interfaces Sub-Collection

The nics sub-collection represents all network interface devices on a virtual machine. A nics representation contains the following properties:

Element property icons

The icons used in the properties column of this table are described in Table 8.1, “Element property icons”

Element	Type	Description
`name`	string	The name of the guest network device, e.g. `eth0`
`network id`	GUID	A reference to the network which the interface should be connected
`type`	enumerated	The type of driver used for the nic. A list of enumerated values is available in `capabilities`. See Section 7.1.11, “NIC Types”
`mac address`	string	The MAC address of the interface

When adding a new network interface, the name and network id properties are required.

Example 14.5. An XML representation of a network interface

<nic id="7a3cff5e-3cc4-47c2-8388-9adf16341f5e" 
  ref="/rhevm-api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/
  7a3cff5e-3cc4-47c2-8388-9adf16341f5e">
    <name>nic1</name>
    <type>virtio</type>
    <mac address="00:1a:4a:16:84:07"/>
    <network id="00000000-0000-0000-0000-000000000009"
      href="/rhevm-api/networks/00000000-0000-0000-0000-000000000009"/>
    <vm id="cdc0b102-fbfe-444a-b9cb-57d2af94f401"
      href="/rhevm-api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401"/>
</nic>