ListNetworkInterfaces
You can use the ListNetworkInterfaces
method to list information about each network interface on a node. This API method is intended for use on individual nodes; user ID and password authentication is required for access to individual nodes. However, you can use this method on the cluster if the parameter force is given the value true in the method call. When the parameter is used on the cluster, all interfaces are listed.
Parameter
This method has the following input parameter:
Name | Description | Type | Default value | Required |
---|---|---|---|---|
force |
Possible values:
|
boolean |
None |
No |
Return value
This method has the following return value:
Name |
Description |
Type |
interfaces |
A list of configuration information for each network interface of the storage node (or entire storage cluster, if force = |
networkInterface array |
Request example
Requests for this method are similar to the following example:
{ "method": "ListNetworkInterfaces", "params": {}, "id" : 1 }
Response example
This method returns a response similar to the following example:
{ "id": 1, "result": { "nodes": [ { "nodeID": 1, "result": { "interfaces": [ { "address": "10.117.80.32", "addressV6": "::", "broadcast": "10.117.95.255", "macAddress": "90:b1:1c:42:e0:1a", "mtu": 9000, "name": "Bond10G", "namespace": false, "netmask": "255.255.240.0", "status": "UpAndRunning", "type": "BondMaster", "virtualNetworkTag": 0 }, { "address": "10.117.64.32", "addressV6": "::", "broadcast": "10.117.79.255", "macAddress": "90:b1:1c:42:e0:1e", "mtu": 1500, "name": "Bond1G", "namespace": false, "netmask": "255.255.240.0", "status": "UpAndRunning", "type": "BondMaster", "virtualNetworkTag": 0 }, { "address": "0.0.0.0", "addressV6": "::", "broadcast": "0.0.0.0", "macAddress": "90:b1:1c:42:e0:1a", "mtu": 9000, "name": "eth0", "namespace": false, "netmask": "0.0.0.0", "status": "UpAndRunning", "type": "BondSlave", "virtualNetworkTag": 0 }, { "address": "127.0.0.1", "addressV6": "::", "broadcast": "0.0.0.0", "macAddress": "00:00:00:00:00:00", "mtu": 0, "name": "lo", "namespace": false, "netmask": "0.0.0.0", "status": "UpAndRunning", "type": "Loopback", "virtualNetworkTag": 0 } ] } } ] } }
New since version
9.6