- FutureNet製品活用ガイド
- FutureNet NXR,VXRシリーズ
- REST-API編
FutureNet
NXR,VXRシリーズ
REST-API編
6. NAT設定
6-1. 送信元NAT設定(snat)
処理概要
送信元NAT設定に関する処理を実行します。
URIおよびメソッド
機能 | Version | URI | メソッド | |||
POST | PUT | GET | DELETE | |||
SNAT | v2 | /api/v2/nat/snat | - | - | - | - |
/api/v2/nat/snat/nat-list | 〇 | - | - | - | ||
/api/v2/nat/snat/nat-list/{NAME} | - | 〇 | ● | 〇 |
凡例:
● : 読み取り専用ユーザも含めアクセス可
〇 : 読み取り専用ユーザはアクセス不可
- : 未対応
実行例
SNAT名の定義および設定の作成
メソッド | URI |
POST | /api/v2/nat/snat/nat-list |
JSON
リクエスト
POST /api/v2/nat/snat/nat-list
Content-Type: application/json
{
"nat-list": {
"name": "eth0_SNAT",
"rule": {
"protocol": "ip",
"source": "192.168.1.0/24",
"translation_ip": {
"from": "192.168.0.1"
}
}
}
}
レスポンス
201 Created
XML
リクエスト
POST /api/v2/nat/snat/nat-list
Content-Type: application/xml
<snat>
<nat-list>
<name>eth0_SNAT</name>
<rule>
<protocol>ip</protocol>
<source>192.168.1.0/24</source>
<translation_ip>
<from>192.168.0.1</from>
</translation_ip>
</rule>
</nat-list>
</snat>
レスポンス
201 Created
SNAT設定の追加
メソッド | URI |
PUT | /api/v2/nat/snat/nat-list/{NAME} |
- PUT時は、既存のSNAT名へのルールの追加のみ可能です。
JSON
リクエスト
PUT /api/v2/nat/snat/nat-list/eth0_SNAT
Content-Type: application/json
{
"name": "eth0_SNAT",
"rule": {
"protocol": "tcp",
"source": "192.168.2.0/24",
"src_port": {
"min": "any"
},
"dst_port": {
"min": 80
},
"translation_ip": {
"from": "192.168.0.1"
}
}
}
レスポンス
204 No content
XML
リクエスト
PUT /api/v2/nat/snat/nat-list/eth0_SNAT
Content-Type: application/xml
<nat-list>
<name>eth0_SNAT</name>
<rule>
<protocol>tcp</protocol>
<source>192.168.2.0/24</source>
<src_port>
<min>any</min>
</src_port>
<dst_port>
<min>80</min>
</dst_port>
<translation_ip>
<from>192.168.0.1</from>
</translation_ip>
</rule>
</nat-list>
レスポンス
204 No content
SNAT設定の取得
メソッド | URI |
GET | /api/v2/nat/snat/nat-list/{NAME} |
JSON
リクエスト
GET /api/v2/nat/snat/nat-list/eth0_SNAT
Accept: application/json
レスポンス
200 OK
Content-Type: application/json
{
"name": "eth0_SNAT",
"rule": [
{
"protocol": "ip",
"source": "192.168.1.0/24",
"translation_ip": {
"from": "192.168.0.1"
}
},
{
"protocol": "tcp",
"source": "192.168.2.0/24",
"src_port": {
"min": "any"
},
"dst_port": {
"min": 80
},
"translation_ip": {
"from": "192.168.0.1"
}
}
]
}
XML
リクエスト
GET /api/v2/nat/snat/nat-list/eth0_SNAT
Accept: application/xml
レスポンス
200 OK
Content-Type: application/xml
<nat-list>
<name>eth0_SNAT</name>
<rule>
<protocol>ip</protocol>
<source>192.168.1.0/24</source>
<translation_ip>
<from>192.168.0.1</from>
</translation_ip>
</rule>
<rule>
<protocol>tcp</protocol>
<source>192.168.2.0/24</source>
<src_port>
<min>any</min>
</src_port>
<dst_port>
<min>80</min>
</dst_port>
<translation_ip>
<from>192.168.0.1</from>
</translation_ip>
</rule>
</nat-list>
TEXT/PLAIN
リクエスト
GET /api/v2/nat/snat/nat-list/eth0_SNAT
Accept: text/plain
レスポンス
200 OK
Content-Type: text/plain
ip snat eth0_SNAT ip 192.168.1.0/24 any 192.168.0.1
ip snat eth0_SNAT tcp 192.168.2.0/24 any any 80 192.168.0.1
SNAT設定の削除
メソッド | URI |
DELETE | /api/v2/nat/snat/nat-list/{NAME} |
- Bodyを指定しなかった場合、指定したNAMEのSNAT設定を全て削除します。
JSON
リクエスト
DELETE /api/v2/nat/snat/nat-list/eth0_SNAT
Content-Type: application/json
{
"name": "eth0_SNAT",
"rule": {
"protocol": "ip",
"source": "192.168.1.0/24",
"translation_ip": {
"from": "192.168.0.1"
}
}
}
レスポンス
204 No content
XML
リクエスト
DELETE /api/v2/nat/snat/nat-list/eth0_SNAT
Content-Type: application/xml
<nat-list>
<name>eth0_SNAT</name>
<rule>
<protocol>ip</protocol>
<source>192.168.1.0/24</source>
<translation_ip>
<from>192.168.0.1</from>
</translation_ip>
</rule>
</nat-list>
レスポンス
204 No content
パラメータ
指定可能なパラメータは下記の通りです。
なお、指定可能なパラメータは製品およびファームウェアのバージョンにより異なりますので、各パラメータの詳細については各製品のユーザーズガイド(CLI版)も合わせてご参照ください。
- パラメータ表の説明文中の表記について
< > … 括弧内の値の範囲から選択することを示しています。
[ ] … 括弧内の値のどれかを選択することを示しています。 - パラメータ表の説明文中のデータタイプについて
A.B.C.D … IPv4アドレス
A.B.C.D/M … IPv4プレフィックスおよびマスク長
パラメータおよびレベル | 説明 | |||||
---|---|---|---|---|---|---|
Lv.1 | Lv.2 | Lv.3 | Lv.4 | Lv.5 | Lv.6 | |
nat | snat | nat-list | name | SNAT名 | ||
rule | protocol | プロトコル … [ ip | tcp | udp | <0-255> ] | ||||
destination | 宛先IPv4アドレス …
|
|||||
dst_port | min | 宛先ポート番号 … [ any | <1-65535> ] | ||||
max | 宛先ポート番号 … <1-65535> ※範囲指定時のみ有効 |
|||||
source | 送信元IPv4アドレス …
|
|||||
src_port | min | 送信元ポート番号 … [ any | <1-65535> ] | ||||
max | 送信元ポート番号 … <1-65535> ※範囲指定時のみ有効 |
|||||
translation_ip | from | 変換後送信元IPv4アドレス … A.B.C.D | ||||
to | 変換後送信元IPv4アドレス … A.B.C.D ※範囲指定時のみ有効 |
|||||
translation_port | min | 変換後送信元ポート … <1-65535> | ||||
max | 変換後送信元ポート … <1-65535> ※範囲指定時のみ有効 |
|||||
translation_prefix | 変換後送信元IPv4ネットワークアドレス … A.B.C.D/M |
目次
更新情報
→ 一覧へカテゴリ
タグ
- CRG
- DDNS
- DHCP
- DNAT
- DNSインターセプト
- Ethernet
- IIJモバイル
- IKE Modeconfig
- IKEv2 Configuration Payload
- IPinIP
- IPoE
- IPv6
- KDDI
- L2TPv3
- MAP-E
- NGN
- NTTドコモ
- PBR
- Policy Based IPsec
- PPP
- PPPoE
- QoS
- RADIUS連携
- RAシリーズ
- Route Based IPsec
- SMS
- SNAT
- SoftBank
- UPnP
- URL転送
- VLAN
- VRRP
- Web認証
- WiMAX
- コンフィグロールバック
- ネットイベント
- フィルタ
- ブリッジ
- モニタログ
- ワイモバイル
- 仮想スイッチ
- 冗長化
- 無線LAN