ネットワークデバイス

システムの物理ネットワークデバイスを一覧表示します。物理ネットワークデバイスに変更可能なプロパティーはありません。

表 7-7  ネットワークのコマンド

リクエスト パス /network/v1 説明 GET /devices/<device> 指定されたネットワークデバイスのプロパティーを取得します GET /devices すべてのネットワークデバイスオブジェクトを一覧表示します

表 7-8  ネットワークデバイスのプロパティー

名前 説明 active デバイスがアクティブかどうかを示すブール型フラグ duplex デバイスの全二重/半二重 factory_mac 工場出荷時の MAC アドレス media デバイスのメディア speed デバイス速度 (M ビット/秒) 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
    }
}