ネットワークインタフェース

表 7-9  ネットワークインタフェースのコマンド

リクエスト パス /api/network/v1 説明 POST /interfaces 新しいネットワークインタフェースを作成します GET /interfaces/<interface> 指定されたネットワークインタフェースのプロパティーを取得します GET /interfaces すべてのネットワークインタフェースオブジェクトを一覧表示します PUT /interfaces/<interface> 指定されたネットワークインタフェースオブジェクトを変更します DELETE /interfaces/<interface> 指定されたインタフェースオブジェクトを破棄します

表 7-10  ネットワークインタフェースのプロパティー

名前 説明 admin このインタフェースで管理が許可されているかどうかを示すフラグ class クラスタイプ (「ip」、「ipmp」) (作成後は変更不可) curaddrs 現在の IP アドレス (変更不可) enable このインタフェースが有効かどうかを示すフラグ label インタフェースのユーザーラベル links このインタフェースのネットワークリンクを選択します state インタフェースの状態 (変更不可) v4addrs IPv4 アドレス v6dhcp IPv4 DHCP フラグ v6addrs IPv6 アドレス v6dhcp IPv6 DHCP フラグ

ネットワークインタフェースの一覧表示

構成済みのすべてのネットワークインタフェースを一覧表示します。

リクエストの例:

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

レスポンスの例:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 369

{
    "interfaces": {[
        "href": "/api/network/v1/interfaces/ixgbe0",
        "v4addrs": ["10.80.231.58/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe1",
        "v4addrs": ["10.80.231.59/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe2",
        "v4addrs": ["10.80.231.60/24"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe3",
        "v4addrs": ["10.80.231.61/24"]
        ...
    }]
}

ネットワークインタフェースの取得

指定されたネットワークインタフェースのプロパティーの完全なリストを取得します。

リクエストの例:

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

レスポンスの例:

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 292

{
    "interface": {
        "admin": true,
        "class": "ip",
        "curaddrs": ["10.80.231.58/24"],
        "enable": true,
        "href": "/api/network/v1/interfaces/ixgbe0",
        "interface": "ixgbe0",
        "label": "Untitled Interface",
        "links": ["ixgbe0"],
        "state": "up",
        "v4addrs": ["10.80.231.58/24"],
        "v4dhcp": false,
        "v6addrs": [],
        "v6dhcp": false
    }
}

ネットワークインタフェースの作成

新しいネットワークインタフェースを作成します。

リクエストの例:

POST /api/network/v1/interfaces HTTP/1.1
Host: zfssa.example.com:215
X-Auth-User: root
X-Auth-Key: letmein
Content-Type: application/json
Content-Length: 78

{
    "class": "ip",
    "links": ["ixgbe3"],
    "v4addrs":"192.168.1.9/24"
}

レスポンスの例:

HTTP/1.1 201 Created
X-Zfssa-Appliance-Api: 1.0
Location: /api/network/v1/interfaces/ixgbe3

ネットワークインタフェースの変更

既存のネットワークインタフェースを変更します。

リクエストの例:

PUT /api/network/v1/interfaces/ixgbe3 HTTP/1.1

{
    "v4addrs": ["192.168.1.99/24"],
    "interface": "Demo Rest"
}

レスポンスの例:

HTTP/1.1 202 Accepted
X-Zfssa-Appliance-Api: 1.0
Content-Type: application/json
Content-Length: 219

{
    "admin": true,
    "class": "ip",
    "curaddrs": ["192.168.1.9/24"],
    "enable": true,
    "href": "/api/network/v1/interfaces/ixgbe3",
    "interface": "ixgbe3",
    "label": "Demo Rest",
    "links": ["ixgbe3"],
    "state": "failed",
    "v4addrs": ["192.168.1.99/24"]
    "v4dhcp": false,
    "v6addrs": [],
    "v6dhcp": false
}

ネットワークインタフェースの削除

既存のネットワークインタフェースを削除します。

リクエストの例:

DELETE /api/network/v1/interfaces/ixgbe3 HTTP/1.1
Authorization: Basic abcd1234MWE=
Host: zfssa.example.com:215

結果例:

HTTP/1.1 204 No Content