1. Operations
2. appliance
3. networking
4. interfaces

## appliance networking interfaces: list

Get list of available network interfaces, including those that are not yet configured.

### Request:

#### HTTP request

GET https://{server}/rest/appliance/networking/interfaces
No request parameters

### Response:

#### HTTP Status Code: 200

#### Representations:

- JSON
- XML

{
"value": [
{
"mac": "string",
"name": "string",
"status": "down"
},
{
"mac": "string",
"name": "string",
"status": "down"
}
]
}
<?xml version="1.0" ?>
<ns0:List-Result xmlns:ns0="http://vmware.com/appliance/networking/interfaces" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value-array>
<array-item>
<status>down</status>
<name>string</name>
<mac>string</mac>
</array-item>
<array-item>
<status>down</status>
<name>string</name>
<mac>string</mac>
</array-item>
</value-array>
</ns0:List-Result>

#### Response Type:

Name | Type | Description
--- | --- | ---
bold = required
value | interface_info[] | List of InterfaceInfo structures.
value[].name | string | Interface name, for example, "nic0", "nic1".
value[].status | string | Interface status. Defines interface status Value is one of: down: The interface is down. up: The interface is up.
value[].mac | string | MAC address. For example 00:0C:29:94:BB:5A.

#### Errors:

HTTP Status Code | Type | Description
--- | --- | ---
500 | error | Generic error