1. FutureNet製品活用ガイド
  2. FutureNet NXR,VXRシリーズ
  3. REST-API編

FutureNet

NXR,VXRシリーズ

REST-API編

3. インタフェース設定

3-6. ブリッジインタフェース設定（bridge-interface）

 処理概要

ブリッジインタフェース設定に関する処理を実行します。

 

URIおよびメソッド

機能 Version URI メソッド
POST PUT GET DELETE
bridge interface v2 /api/v2/ovs － － － －
/api/v2/ovs/bridge-interface 〇 － ● －
/api/v2/ovs/bridge-interface/{NUM} － 〇 ● 〇

凡例：

● : 読み取り専用ユーザも含めアクセス可

〇 : 読み取り専用ユーザはアクセス不可

－ : 未対応

 

実行例

ブリッジインタフェース設定の作成

メソッド URI
POST /api/v2/ovs/bridge-interface
JSON
リクエスト

POST /api/v2/ovs/bridge-interface
Content-Type: application/json

 

{
"bridge-interface": {
"number": 0,
"ipv4": {
"ipv4-address": {
"address": "192.168.0.1/24"
}
}
}
}

 

レスポンス

201 Created

 

XML
リクエスト

POST /api/v2/ovs/bridge-interface
Content-Type: application/xml

 

<ovs>
<bridge-interface>
<number>0</number>
<ipv4>
<ipv4-address>
<address>192.168.0.1/24</address>
</ipv4-address>
</ipv4>
</bridge-interface>
</ovs>

 

レスポンス

201 Created

 

全ブリッジインタフェース設定の取得

メソッド URI
GET /api/v2/ovs/bridge-interface
JSON
リクエスト

GET /api/v2/ovs/bridge-interface
Accept: application/json

 

レスポンス

200 OK
Content-Type: application/json

 

{
"bridge-interface": [
{
"number": 0,
"ipv4": {
"ipv4-address": {
"address": "192.168.0.1/24"
}
}
},
{
"number": 1,
・・・・・

 

XML
リクエスト

GET /api/v2/ovs/bridge-interface
Accept: application/xml

 

レスポンス

200 OK
Content-Type: application/xml

 

<ovs>
<bridge-interface>
<number>0</number>
<ipv4>
<ipv4-address>
<address>192.168.0.1/24</address>
</ipv4-address>
</ipv4>
</bridge-interface>
<bridge-interface>
<number>1</number>
・・・・・

 

TEXT/PLAIN
リクエスト

GET /api/v2/ovs/bridge-interface
Accept: text/plain

 

レスポンス

200 OK
Content-Type: text/plain

 

interface bridge 0
ip address 192.168.0.1/24
interface bridge 1
・・・・・

 

ブリッジインタフェース設定の更新

メソッド URI
PUT /api/v2/ovs/bridge-interface/{NUM}
JSON
リクエスト

PUT /api/v2/ovs/bridge-interface/0
Content-Type: application/json

 

{
"number": 0,
"ipv4": {
"ipv4-address": {
"address": "192.168.0.2/24"
}
}
}

 

レスポンス

204 No content

 

XML
リクエスト

PUT /api/v2/ovs/bridge-interface/0
Content-Type: application/xml

 

<bridge-interface>
<number>0</number>
<ipv4>
<ipv4-address>
<address>192.168.0.2/24</address>
</ipv4-address>
</ipv4>
</bridge-interface>

 

レスポンス

204 No content

 

ブリッジインタフェース設定の取得

メソッド URI
GET /api/v2/ovs/bridge-interface/{NUM}
JSON
リクエスト

GET /api/v2/ovs/bridge-interface/0
Accept: application/json

 

レスポンス

200 OK
Content-Type: application/json

 

{
"number": 0,
"ipv4": {
"ipv4-address": {
"address": "192.168.0.1/24"
}
}
}

 

XML
リクエスト

GET /api/v2/ovs/bridge-interface/0
Accept: application/xml

 

レスポンス

200 OK
Content-Type: application/xml

 

<bridge-interface>
<number>0</number>
<ipv4>
<ipv4-address>
<address>192.168.0.1/24</address>
</ipv4-address>
</ipv4>
</bridge-interface>

 

TEXT/PLAIN
リクエスト

GET /api/v2/ovs/bridge-interface/0
Accept: text/plain

 

レスポンス

200 OK
Content-Type: text/plain

 

interface bridge 0
ip address 192.168.0.1/24

 

ブリッジインタフェース設定の削除

メソッド URI
DELETE /api/v2/ovs/bridge-interface/{NUM}
リクエスト

DELETE /api/v2/ovs/bridge-interface/0

 

レスポンス

204 No content

 

パラメータ

指定可能なパラメータは下記の通りです。

なお、指定可能なパラメータは製品およびファームウェアのバージョンにより異なりますので、各パラメータの詳細については各製品のユーザーズガイド（CLI版）も合わせてご参照ください。

  • パラメータ表の説明文中の表記について
    < > … 括弧内の値の範囲から選択することを示しています。
    [ ] … 括弧内の値のどれかを選択することを示しています。
    数字,文字列 … 初期値
  • パラメータ表の説明文中のデータタイプについて
    A.B.C.D … IPv4アドレス
    A.B.C.D/M … IPv4プレフィックスおよびマスク長
    X:X::X:X … IPv6アドレス
    X:X::X:X/M … IPv6プレフィックスおよびプレフィックス長
    XX:XX:XX:XX:XX:XX … MACアドレス

 

ovs

パラメータおよびレベル 説明
Lv.1 Lv.2 Lv.3
ovs bridge-interface number インタフェース番号
description インタフェースの説明
ipv4 IPv4設定
ipv6 IPv6設定
mtu MTU値 … <68-1500>（bytes）
bandwidth 帯域幅 … <1-10000000000>（bits）
pppoe-client PPPoEクライアント … pppX
※Xはインタフェース番号（ex. ppp0）
l2tpv3 L2TPv3設定
shutdown bridgeインタフェースの停止 … [ enable | disable ]
ipsec-policy IPsecローカルポリシ番号
ipsec-policy-ignore ipsec-policy-ignore設定
route-map ルートマップ設定
invalid-status-drop session invalid-status-drop … [ enable | disable ]
bridge-parameter ブリッジパラメータ設定
openflow openflow設定
bond bond設定

 

ipv4

パラメータおよびレベル 説明
Lv.3 Lv.4 Lv.5 Lv.6
ipv4 ipv4-address address  IPv4アドレス …

  • A.B.C.D/M
  • dhcp
  • mape-rule
dhcp-client hostname DHCPホスト名 
option MAP-Eルール名
secondary セカンダリIPv4アドレス … A.B.C.D/M
proxy-arp プロキシARP … [ enable | disable ] 
local-proxy-arp ローカルプロキシARP … [ enable | disable ] 
directed-broadcast ダイレクトブロードキャスト … [ enable | disable ] 
icmp-redirects ICMPリダイレクト … [ enable | disable ] 
icmp-mask-reply ICMPマスク応答 … [ enable | disable ] 
tcp adjust-mss IPv4 TCP MSS調整 … [ enable | disable ] 
mss IPv4 TCP MSS値 … [ auto | <500-1460> ]（bytes） 
strip-options IPv4 TCP ストリップオプション …
[ all | md5 | mss | sack | sack-permitted | timestamp | wscale ]
arp reachable-time ARPの有効期間 … <30000-3600000>（msec）
queue-len ARPキュー長 … <1-1000(30)>
filter ARPフィルタ … [ enable | disable ]
gratuitous attempt GARP送信回数 …  [ 0 | <1-255> ]
※0でdisable。GARP有効時のデフォルト値は1
interval GARP送信間隔 … <1-3600>（sec）
※デフォルト値はGARP有効時の値
delay GARP遅延時間 … <1-600(5)>（sec）
※デフォルト値はGARP有効時の値
filter in IPv4入力フィルタ … ACL名
out IPv4出力フィルタ … ACL名 
forward-in IPv4転送フィルタ（forward-in） … ACL名
forward-out IPv4転送フィルタ（forward-out） … ACL名 
spi IPv4 SPIフィルタ … [ enable | disable ]
spi-log log IPv4 SPIフィルタログ … [ enable | disable ]
limit IPv4 SPIフィルタログ出力数制限 … <0-100(10)>
rebound  IPv4リバウンド … [ enable | disable ]
reassemble-output reassemble-output … [ enable | disable ]
mcast-to-ucast-forward multicast to unicast packet forwarding … [ enable | disable ]
nat masquerade IPマスカレード … [ enable | disable ]
snat 送信元NAT … SNAT名
dnat 宛先NAT … DNAT名
web-auth forward-in IPv4 Web認証フィルタ（forward-in） … ACL名
forward-out IPv4 Web認証フィルタ（forward-out） … ACL名
acl_p2p p2p-list name P2Pアプリケーション … [ any | winny | share | bittorrent ]
deny P2Pパケット破棄 … [ enable | disable ]
log P2Pログ … [ enable | disable ]
dns-intercept number DNSインターセプト設定番号 … <0-3>

 

ipv6

パラメータおよびレベル 説明
Lv.3 Lv.4 Lv.5 Lv.6 Lv.7  Lv.8
ipv6 ipv6-address address  IPv6アドレス …

  • X:X::X:X/M
    ※リンクローカルアドレスの場合 … X:X::X:X
  • autoconfig
  • DHCPv6-PD名
  • dhcp
    ※dhcpv6-naの場合に指定
dhcpv6-pd IPv6アドレス … X:X::X:X/M
dhcpv6-na DHCPv6クライアント名
ra-token インタフェースID … X:X::X:X
map MAP-Eルール名
dhcpv6-client DHCPv6クライアント名
tcp adjust-mss IPv6 TCP MSS調整 … [ enable | disable ]
mss IPv6 TCP MSS値 … [ auto | <500-1440> ]（bytes）
strip-options IPv6 TCP ストリップオプション …
[ all | md5 | mss | sack | sack-permitted | timestamp | wscale ]
ndp ra send-ra RA送信 … [ enable | disable ]
accept-ra accept-ra … [ enable | disable ]
ra-prefix prefix IPv6 Prefix … X:X::X:X/M
valid-lifetime 有効期間 … <0-4294967295(2592000)>（sec）
preferred-lifetime 推奨期間 … <0-4294967295(604800)>（sec）
no-advertise no-advertise … [ enable | disable ]
off-link オフリンク … [ enable | disable ]
no-autoconfig no-autoconfig … [ enable | disable ]
ra-lifetime RAライフタイム … <0-9000(1800)>（sec）
ra-min-interval RA最小間隔 … <3-1350(200)>（sec）
ra-max-interval RA最大間隔 … <4-1800(600)>（sec）
managed-config RA flag(Mフラグ) … [ enable | disable ]
other-config RA flag(Oフラグ) … [ enable | disable ]
router-preference ルータプリファレンス … [ high | low | medium ]
no-advertise-lla no-advertise-lla … [ enable | disable ]
dns server address RDNSS IPv6DNSサーバアドレス … X:X::X:X
dns-add-dhcp RDDNSSインタフェース名（ex. ethernet0）
rs-interval RS間隔 … <1-10>（sec）
rs-count RS送信回数 … <1-2147483647(3)>
reachable-time 隣接ノードの到達性確認間隔 … <0-3600000(30000)>（msec）
ns-interval NS送信間隔 … <1000-3600000>（msec）
dad-attempt DAD送信回数 … <0-600(1)>
accept-redirects ICMPv6 redirects … [ enable | disable ]
queue-len NDキュー長 … <1-1000(30)>
filter in IPv6入力フィルタ … ACL名
out IPv6出力フィルタ … ACL名
forward-in IPv6転送フィルタ（forward-in） … ACL名
forward-out IPv6転送フィルタ（forward-out） … ACL名
spi IPv6 SPIフィルタ … [ enable | disable ]
spi-log log IPv6 SPIフィルタログ … [ enable | disable ]
limit IPv6 SPIフィルタログ出力数制限 … <0-100(10)>
※デフォルト値はIPv6 SPIフィルタログ有効時の値
rebound  IPv6リバウンド … [ enable | disable ]
hop-limit IPv6ホップリミット … <0-255(64)>
web-auth forward-in IPv6 Web認証フィルタ（forward-in） … ACL名
forward-out IPv6 Web認証フィルタ（forward-out） … ACL名

 

l2tpv3

パラメータおよびレベル 説明
Lv.3 Lv.4 Lv.5 Lv.6 Lv.7
l2tpv3 l2rp l2rp-group id L2RP ID … <1-255>
type L2RPマスタタイプ … [ priority | active ]
priority L2RPプライオリティ … <1-255(100)>
preempt L2RPプリエンプト … [ enable | disable ]
block-reset ブロックリセット … [ enable | disable ]
timers advertise L2RP広告間隔 … <1-60>（sec）
delay L2RP遅延時間 … <0-60>（sec）
port-reset ポートリセット … <0-1>
filter in L2TPv3フィルタ（in） … ACL名
out L2TPv3フィルタ（out） … ACL名

 

ipsec-policy-ignore

パラメータおよびレベル 説明
Lv.3 Lv.4
ipsec-policy-ignore input ipsec-policy-ignore（in） … [ enable | disable ]
output ipsec-policy-ignore（out） … [ enable | disable ]

 

route-map

パラメータおよびレベル 説明
Lv.3 Lv.4
route-map input classify input ルートマップ名
output classify output ルートマップ名
policy ip policy ルートマップ名

 

bridge-parameter

パラメータおよびレベル 説明
Lv.3 Lv.4
bridge-parameter hw-address MACアドレス … XX:XX:XX:XX:XX:XX
mac-table-size MACテーブルサイズ … <10-4096(2048)>
mac-aging MACエージング … <15-3600(300)>（sec）
mcast-snooping マルチキャストスヌーピング … [ enable | disable ]
bpdu-forwarding BPDUスヌーピング … [ enable | disable ]
stp STP … [ enable | disable ]
priority STPプライオリティ … <0-65535(32768)>
hello-time STP hello time … <1-10(2)>（sec）
forward-delay STP forward delay … <4-30(15)>（sec）
max-age STP max age … <6-40(20)>（sec）
set-flow flow名

 

openflow

パラメータおよびレベル 説明
Lv.3 Lv.4 Lv.5
openflow controller family アドレスファミリ … ip
address IPv4アドレス … A.B.C.D
port コントロールポート番号 … <1-65535(6653)>
datapath-id データパスID … <1-FFFFFFFFFFFFFFFF>
※未指定時はシステム内部で生成
protocol OpenFlowプロトコル … [ 10 | 11 | 12 | 13 | 14 | 15 ]

 

bond

パラメータおよびレベル 説明
Lv.3 Lv.4 Lv.5 Lv.6
bond bonding number bond番号
mode バランスモード … [ active-backup | balance-slb | balance-tcp ]
lacp mode LACPモード … [ active | passive ]
system-id システムID … XX:XX:XX:XX:XX:XX
system-priority システムプライオリティ … <1-65535(65534)>
time LACPタイム … [ fast | slow ]
fallback-active-backup Fallback to active-backupモード … [ enable | disable ]