FutureNet

NXR,VXRシリーズ

REST-API編

4. ルーティング設定

4-6. IPv6ルートアクセスリスト設定(acl_route_v6)

 処理概要

IPv6ルートアクセスリスト設定に関する処理を実行します。

 

URIおよびメソッド

機能 Version URI メソッド
POST PUT GET DELETE
IPv6 route ACL v2 /api/v2/acl_route_v6
/api/v2/acl_route_v6/access-list
/api/v2/acl_route_v6/access-list/{NAME}

凡例:

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

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

- : 未対応

 

実行例

IPv6ルートアクセスリスト名の定義および設定の作成

メソッド URI
POST /api/v2/acl_route_v6/access-list
JSON
リクエスト

POST /api/v2/acl_route_v6/access-list
Content-Type: application/json

 

{
"access-list": {
"name": "RACL",
"rule": {
"permission": "permit",
"prefix": {
"address": "2001:db8:1::/64"
}
}
}
}

 

レスポンス

201 Created

 

XML
リクエスト

POST /api/v2/acl_route_v6/access-list
Content-Type: application/xml

 

<acl_route_v6>
<access-list>
<name>RACL</name>
<rule>
<permission>permit</permission>
<prefix>
<address>2001:db8:1::/64</address>
</prefix>
</rule>
</access-list>
</acl_route_v6>

 

レスポンス

201 Created

 

IPv6ルートアクセスリスト設定の追加

メソッド URI
PUT /api/v2/acl_route_v6/access-list/{NAME}
  • PUT時は、既存のアクセスリスト名へのルールの追加のみ可能です。

 

JSON
リクエスト

PUT /api/v2/acl_route_v6/access-list/RACL
Content-Type: application/json

 

{
"name": "RACL",
"rule": {
"permission": "permit",
"prefix": {
"address": "2001:db8:2::/64"
}
}
}

 

レスポンス

204 No content

 

XML
リクエスト

PUT /api/v2/acl_route_v6/access-list/RACL
Content-Type: application/xml

 

<access-list>
<name>RACL</name>
<rule>
<permission>permit</permission>
<prefix>
<address>2001:db8:2::/64</address>
</prefix>
</rule>
</access-list>

 

レスポンス

204 No content

 

IPv6ルートアクセスリスト設定の取得

メソッド URI
GET /api/v2/acl_route_v6/access-list/{NAME}

 

JSON
リクエスト

GET /api/v2/acl_route_v6/access-list/RACL
Accept: application/json

 

レスポンス

200 OK
Content-Type: application/json

 

{
"name": "RACL",
"rule": [
{
"permission": "permit",
"prefix": {
"address": "2001:db8:1::/64"
}
},
{
"permission": "permit",
"prefix": {
"address": "2001:db8:2::/64"
}
}
]
}

 

XML
リクエスト

GET /api/v2/acl_route_v6/access-list/RACL
Accept: application/xml

 

レスポンス

200 OK
Content-Type: application/xml

 

<access-list>
<name>RACL</name>
<rule>
<permission>permit</permission>
<prefix>
<address>2001:db8:1::/64</address>
</prefix>
</rule>
<rule>
<permission>permit</permission>
<prefix>
<address>2001:db8:2::/64</address>
</prefix>
</rule>
</access-list>

 

TEXT/PLAIN
リクエスト

GET /api/v2/acl_route_v6/access-list/RACL
Accept: text/plain

 

レスポンス

200 OK
Content-Type: text/plain

 

ipv6 route access-list RACL permit 2001:db8:1::/64
ipv6 route access-list RACL permit 2001:db8:2::/64

 

IPv6ルートアクセスリスト設定の削除

メソッド URI
DELETE /api/v2/acl_route_v6/access-list/{NAME}
  • Bodyを指定しなかった場合、指定したNAMEのIPv6ルートアクセスリスト設定を全て削除します。

 

JSON
リクエスト

DELETE /api/v2/acl_route_v6/access-list/RACL
Content-Type: application/json

 

{
"name": "RACL",
"rule": {
"permission": "permit",
"prefix": {
"address": "2001:db8:1::/64"
}
}
}

 

レスポンス

204 No content

 

XML
リクエスト

DELETE /api/v2/acl_route_v6/access-list/RACL
Content-Type: application/xml

 

<access-list>
<name>RACL</name>
<rule>
<permission>permit</permission>
<prefix>
<address>2001:db8:1::/64</address>
</prefix>
</rule>
</access-list>

 

レスポンス

204 No content

 

パラメータ

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

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

  • パラメータ表の説明文中の表記について
    [ ] … 括弧内の値のどれかを選択することを示しています。
    数字,文字列 … 初期値
  • パラメータ表の説明文中のデータタイプについて
    X:X::X:X/M … IPv6プレフィックスおよびプレフィックス長

 

パラメータおよびレベル 説明
Lv.1 Lv.2 Lv.3 Lv.4 Lv.5
acl_route_v6 access-list name ACL名
rule permission 動作 … [ permit | deny ]
prefix address プレフィックス …

  • any
  • X:X::X:X/M
exact-match exact-math … [ enable | disable ]