这些命令管理网络路由。
|
|
各个路由的 href 路径都使用在 CLI 中设置的路由 ID 集,但当修改路由时,这些值也会发生变化。API 支持使用路由中的唯一属性选择单个路由。语法为 routes/name=value,对应于 routes/route-###。
列出在设备上创建的所有网络路由。
请求示例:
GET /api/network/v1/routes 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: 192 { "routes": [{ "destination": "ipaddr-0", "family": "IPv4", "gateway": "ipaddr-1", "href": "/api/network/v1/routing/route-000", "interface": "ixgbe0", "mask": 0, "route": "route-000", "type": "static" }, { "destination": "ipaddr-2", "family": "IPv4", "gateway": "ipaddr-3", "href": "/api/network/v1/routes/route-001", "interface": "ixgbe0", "mask": 24, "route": "route-001", "type": "system" }] }
获取单个路由的属性。
请求示例:
GET /api/network/v1/routes/destination=ipaddr-1 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: 192 { "route": { "destination": "ipaddr-1", "family": "IPv4", "gateway": "ipaddr-2", "href": "/api/network/v1/routes/route-001", "interface": "ixgbe0", "mask": 24, "route": "route-001", "type": "system" } }
创建新的网络路由。如果向系统添加其他路由,则路由 href 值会发生更改。创建路由时将不会返回路由信息,因为返回的属性将与输入属性相同。成功创建路由后会返回 HTTP 状态 204 (Created)。
创建静态路由的请求示例:
POST /api/network/v1/routes HTTP/1.1 Authorization: Basic abcd1234MWE= Host: zfs-storage.example.com:215 Content-Type: application/json Content-Length: 164 { "family": "IPv4", "destination": "ipaddr-0", "mask": "0", "gateway": "ipaddr-1", "interface": "ixgbe0" }
结果示例:
HTTP/1.1 201 Created
删除现有网络路由。
请求示例:
DELETE /api/network/v1/routes/route-001 HTTP/1.1 Authorization: Basic abcd1234MWE= Host: zfs-storage.example.com:215
结果示例:
HTTP/1.1 204 No Content