Oracle^® ZFS Storage Appliance RESTful API 指南，发行版 OS8.8.0

网络接口

表 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: zfs-storage.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": ["ipaddr-1"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe1",
        "v4addrs": ["ipaddr-2"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe2",
        "v4addrs": ["ipaddr-3"]
        ...
    }, {
        "href": "/api/network/v1/interfaces/ixgbe3",
        "v4addrs": ["ipaddr-4"]
        ...
    }]
}

获取网络接口

此命令获取指定网络接口的完整属性列表。

请求示例：

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

响应示例：

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

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

创建网络接口

此命令创建新的网络接口。

请求示例：

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

{
    "class": "ip",
    "links": ["ixgbe3"],
    "v4addrs":"192.0.2.0/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.0.2.0/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.0.2.0/24"],
    "enable": true,
    "href": "/api/network/v1/interfaces/ixgbe3",
    "interface": "ixgbe3",
    "label": "Demo Rest",
    "links": ["ixgbe3"],
    "state": "failed",
    "v4addrs": ["192.0.2.0/24"]
    "v4dhcp": false,
    "v6addrs": [],
    "v6dhcp": false
}

删除网络接口

此命令删除现有的网络接口。

请求示例：

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

结果示例：

HTTP/1.1 204 No Content