Get List of vCloud Network Interfaces

To view the list of network interfaces, use the following request:

GET /virtual_machines/:virtual_server_id/network_interfaces.xml
GET /virtual_machines/:virtual_server_id/network_interfaces.json

XML Request Example 

curl -i -X GET http://onapp.test/virtual_machines/157/network_interfaces.xml -u user:userpass

JSON Request Example 

curl -i -X GET http://onapp.test/virtual_machines/157/network_interfaces.json -u user:userpass

XML Output Example 

<network_interfaces type="array">
    <connected type="boolean">true</connected>
    <created_at type="datetime">2015-07-20T13:54:31+00:00</created_at>
    <id type="integer">5</id>
    <label>Network adapter 0</label>
    <network_join_id type="integer">13</network_join_id>
    <primary type="boolean">true</primary>
    <rate_limit type="integer">0</rate_limit>
    <updated_at type="datetime">2015-07-20T13:54:31+00:00</updated_at>
    <usage nil="true"/>
    <usage_last_reset_at nil="true"/>
    <usage_month_rolled_at nil="true"/>
    <virtual_machine_id type="integer">157</virtual_machine_id>


connected - whether the network interface is connected to the VS or not

created_at - the timestamp in the database when this network interface was created

default_firewall_rule - not relevant to network interfaces

id - the ID of this network interface

identifier - the identifier in the database of this network interface

label - network interface name

mac_address - network interface MAC address

network_join_id - the ID of the network join to which this network interface belongs

primarytrue if this network interface is primary, otherwise false

rate_limit - port speed in Mbps

updated_at - the timestamp in the database when this network interface was updated

usage - not relevant to network interfaces

usage_last_reset_at - not relevant to network interfaces

usage_month_rolled_at - not relevant to network interfaces

virtual_machine_id - the ID of a virtual server to which this network interface is attached

adapter_type - the network adapter type provided for the VS that can be one of the following values: 

  • Vlance

  • E1000

  • E1000E