网络数据链路

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

表 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