Oracle^® ZFS Storage Appliance RESTful API ガイド、Release OS8.8.x

ネットワークデバイス

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

表 22  ネットワークデバイスのコマンド

リクエスト パス /network/v{1|2} の後ろに追加 説明 GET /devices/device 指定されたネットワークデバイスのプロパティーを取得します GET /devices すべてのネットワークデバイスオブジェクトを一覧表示します

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

プロパティー 説明 active デバイスがアクティブかどうかを示すブール型フラグ duplex デバイスの全二重/半二重 factory_mac 工場出荷時の MAC アドレス media デバイスのメディア speed デバイス速度 (M ビット/秒) up デバイスが動作可能かどうかを示すブール型フラグ

ネットワークデバイスの一覧表示

このコマンドは、すべてのネットワークデバイスを一覧表示します。

リクエストの例:

GET /api/network/v1/devices HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.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",
        ...
    }]
}

ネットワークデバイスの取得

このコマンドは、1 つのネットワークデバイスからプロパティーを取得します。

リクエストの例:

GET /api/network/v1/devices/ixgbe0 HTTP/1.1
Authorization: Basic Tm8gcGVla2luZyE=
Host: zfs-storage.example.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
    }
}