Go to main content
Oracle® ZFS Storage Appliance RESTful API ガイド、Release OS8.6.x

印刷ビューの終了

更新: 2016 年 9 月
 
 

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

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