网络设备

列出系统上的物理网络设备。物理网络设备上没有可修改的属性。

表 7-7  网络命令

请求 路径 /network/v1 描述 GET /devices/<device> 获取指定的网络设备属性 GET /devices 列出所有网络设备对象

表 7-8  网络设备属性

名称 描述 active 布尔标志指示设备是否处于活动状态 duplex 设备的双工状态 factory_mac 出厂 MAC 地址 media 设备介质 speed 设备速度，单位为兆位/秒 up 指示设备是否可操作的布尔标志

列出网络设备

列出所有网络设备。

请求示例：

GET /api/network/v1/devices HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Host: example.zfssa.com:215
Accept: application/json

结果示例：

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 412
X-Zfssa-Gns-Api: 1.0

{
    "devices": [{
        "href": "/api/network/v1/devices/ixgbe0",
        ....
    }, {
        "href": "/api/network/v1/devices/ixgbe1",
        ...
    }, {
        "href": "/api/network/v1/devices/ixgbe2",
        ...
    }, {
        "href": "/api/network/v1/devices/ixgbe3",
        ...
    }]
}

获取网络设备

获取单个网络设备中的属性。

请求示例：

GET /api/network/v1/devices/ixgbe0 HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Host: example.zfssa.com:215
Accept: application/json

结果示例：

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 178
X-Zfssa-Gns-Api: 1.0

{
    "devices": {
        "active": false,
        "device": "ixgbe0",
        "duplex": "full-duplex",
        "factory_mac": "0:21:28:a1:d9:68",
        "href": "/api/network/v1/devices/ixgbe0",
        "media": "Ethernet",
        "speed": "1000 Mbit/s",
        "up": true
    }
}