Get vCloud Network Interface Details

To view the details of a network interface, use the following request:

1
2
GET /virtual_machines/:virtual_server_id/network_interfaces/:id.xml
GET /virtual_machines/:virtual_server_id/network_interfaces/:id.json

XML Request Example

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

JSON Request Example

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

XML Output Example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
<network_interfaces type="array">
  <vcloud_network_interface>
    <connected type="boolean">true</connected>
    <created_at type="datetime">2015-07-20T13:54:31+00:00</created_at>
    <default_firewall_rule>ACCEPT</default_firewall_rule>
    <id type="integer">5</id>
    <identifier>moq2607eyhz8vo</identifier>
    <label>Network adapter 0</label>
    <mac_address>00:50:56:01:01:1c</mac_address>
    <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>
    <adapter_type>VMXNET3</adapter_type>
  </vcloud_network_interface>
</network_interfaces>

Where:

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

primary - true 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
VMXNET
VMXNET2
VMXNET3
FLEXIBLE