网络数据链路

语言：

网络数据链路命令可用于管理设备上的数据链路。您可以列出、修改、创建和删除数据链路资源。

表 7-1 网络数据链路命令

请求	路径 /network/v1	描述
POST	/datalinks	创建新的网络数据链路
GET	/datalinks/<datalink>	获取指定的网络数据链路属性
GET	/datalinks	列出所有网络数据链路对象
PUT	/datalinks/<datalink>	修改指定的网络数据链路对象
DELETE	/datalinks/<datalink>	销毁指定的数据链路对象

表 7-2 物理设备数据链路属性

属性	类型	描述
class	字符串	“device” (“immutable”)
label	NetworkLabel	标签
links	ChooseOne	链路 ["igb1"、"igb0"、"ixgbe2"、"ixgbe3"、"igb4"、"igb3"、"ixgbe1"、"igb2"、"igb5"]
jumbo	布尔型	使用巨型帧 ["true"、"false"] ("deprecated")
mtu	PositiveInteger	最大传输单元 (Max transmission unit, MTU)
speed	ChooseOne	链路速度 ["auto"、"10"、"100"、"1000"、"10000"]
duplex	ChooseOne	链路双工 ["auto"、"half"、"full"]

表 7-3 VNIC 设备数据链路属性

属性	类型	描述
class	字符串	"vnic" ("immutable")
label	NetworkLabel	标签
links	ChooseOne	链路 ["ixgbe0"]
mtu	PositiveInteger	最大传输单元 (Max transmission unit, MTU)
id	VLAN	VLAN ID

表 7-4 VLAN 设备数据链路属性

属性	类型	描述
class	字符串	"vlan" ("immutable")
label	NetworkLabel	标签
links	ChooseOne	链路 ["ixgbe0"]
mtu	PositiveInteger	最大传输单元 (Max transmission unit, MTU)
id	VLAN	VLAN ID

表 7-5 基于聚合的设备数据链路属性

属性	类型	描述
class	字符串	"aggregation" ("immutable")
label	NetworkLabel	标签
links	ChooseN	链路 ["igb1"、"igb0"、"ixgbe2"、"ixgbe3"、"igb4"、"igb3"、"ixgbe1"、"igb2"、"igb5"]
jumbo	布尔型	使用巨型帧 ["true"、"false"] ("deprecated")
mtu	PositiveInteger	最大传输单元 (Max transmission unit, MTU)
policy	ChooseOne	策略 ["L2"、"L3"、"L4"、"L2+L3"、"L2+L4"、"L3+L4"]
mode	ChooseOne	模式 ["active"、"passive"、"off"]
timer	ChooseOne	计时器 ["short"、"long"]
Key	Integer	聚合键 ("immutable")

表 7-6 基于 IP 分区的设备数据链路属性

属性	类型	描述
class	字符串	"partition" ("immutable")
label	NetworkLabel	标签
links	ChooseOne	链路
pkey	Pkey	分区键
linkmode	ChooseOne	链路模式 ["cm"、"ud"]

列出网络数据链路

列出设备上的所有已配置数据链路。数据链路列表中的各个对象都包含用于获取单个数据链路资源的相关操作的 href 属性以及数据链路属性。

请求示例：

GET /api/network/v1/datalinks HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

JSON 数据示例：

{
    "datalinks": [{
        "href": "/api/network/v1/datalinks/ixgbe0",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe1",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe2",
        ...
    }, {
        "href": "/api/network/v1/datalinks/ixgbe3",
        ...
    }]
}

获取网络数据链路

GET 方法会返回一个包含数据链路属性的 JSON 对象以及数据链路对象的列表。

GET /api/network/v1/datalinks/ixgbe0 HTTP/1.1 Host: zfs-storage.example.com

Accept: application/json

JSON 数据示例：

{
    "datalink": {
        "class": "device",
        "datalink": "ixgbe0",
        "duplex": "auto",
        "href": "/api/network/v1/datalinks/ixgbe0",
        "jumbo": false,
        "label": "Untitled Datalink",
        "links": [
            "ixgbe0"
        ],
        "mac": "0:21:28:a1:d9:68",
        "mtu": 1500,
        "speed": "auto"
    }
}

创建网络数据链路

POST 命令可创建新的数据链路。创建新的数据链路时需要的一个额外属性是类属性，此属性定义了要创建的数据链路的类。"Datalinks" 类是在数据链路创建期间定义的，它可以是以下类型之一。

设备－创建基于设备的数据链路
vnic－创建基于 VNIC 的数据链路
vlan－创建基于 VLAN 的数据链路
聚合－创建基于聚合的数据链路
分区－创建 IB 分区数据链路

这些属性映射到 "configuration net datalinks" 菜单中可用的同一个 CLI 属性。

请求示例：

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

{
    "class": "device",
     "jumbo": true,
     "links": ["ixgbe2"],
     "label": "TestDataLink"
}

响应示例：

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

修改网络数据链路

PUT 方法可用于修改数据链路属性。有关设置数据链路的详细信息，请参见 CLI 文档。

请求示例：

PUT /api/network/v1/datalinks/ixgbe2 HTTP/1.1

{"jumbo": true}

响应示例：

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

{
    "datalink": {
        "href": "/api/network/v1/datalinks/ixgbe2",
        "class": "device",
        "label": "MyDataLink",
        "links": ["ixgbe2"],
        "mac": "0:21:28:a1:d9:6a",
        "mtu": 9000,
        "duplex": "auto",
        "jumbo": true,
        "speed": "auto"
    }
}

删除网络数据链路

此命令可从系统中删除数据链路。使用 href 路径删除指定的数据链路。

请求示例：

DELETE /api/network/v1/datalinks/ixgbe2 HTTP/1.1

响应示例：

HTTP/1.1 204 No Content