1. Operations
2. vcenter
3. vm
4. hardware
5. ethernet

## vcenter vm hardware ethernet: list

Returns commonly used information about the virtual Ethernet adapters belonging to the virtual machine.

### Request:

#### HTTP request

GET https://{server}/rest/vcenter/vm/{vm}/hardware/ethernet

#### Path Parameters

Name | Type | Description
--- | --- | ---
Required
vm | string | Virtual machine identifier.

### Response:

#### HTTP Status Code: 200

#### Representations:

- JSON
- XML

{
"value": [
{
"nic": "obj-103"
},
{
"nic": "obj-103"
}
]
}
<?xml version="1.0" ?>
<ns0:List-Result xmlns:ns0="http://vmware.com/vcenter/vm/hardware/ethernet" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value-array>
<array-item>
<nic>obj-103</nic>
</array-item>
<array-item>
<nic>obj-103</nic>
</array-item>
</value-array>
</ns0:List-Result>

#### Response Type:

Name | Type | Description
--- | --- | ---
bold = required
value | summary[] | List of commonly used information about virtual Ethernet adapters.
value[].nic | string | Identifier of the virtual Ethernet adapter. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: `com.vmware.vcenter.vm.hardware.Ethernet`. When operations return a value of this structure as a result, the field will be an identifier for the resource type: `com.vmware.vcenter.vm.hardware.Ethernet`.

#### Errors:

HTTP Status Code | Type | Description
--- | --- | ---
500 | error | if the system reports an error while responding to the request.
404 | not_found | if the virtual machine is not found.
400 | resource_inaccessible | if the virtual machine's configuration state cannot be accessed.
503 | service_unavailable | if the system is unable to communicate with a service to complete the request.
401 | unauthenticated | if the user can not be authenticated.
403 | unauthorized | if the user doesn't have the required privileges.