FutureNet

NXR,VXRシリーズ

REST-API編

5. アクセスリスト設定

5-5. IPv4アクセスリストダイナミック設定(acl_dynamic_v4)

 処理概要

IPv4アクセスリストダイナミック設定に関する処理を実行します。

 

URIおよびメソッド

機能 Version URI メソッド
POST PUT GET DELETE
IPv4 ACL_Dynamic v2 /api/v2/acl_dynamic_v4
/api/v2/acl_dynamic_v4/dynamic/
/api/v2/acl_dynamic_v4/dynamic/{NAME}

凡例:

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

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

- : 未対応

 

実行例

IPv4アクセスリストダイナミック設定の作成

メソッド URI
POST /api/v2/acl_dynamic_v4/dynamic/
JSON
リクエスト

POST /api/v2/acl_dynamic_v4/dynamic/
Content-Type: application/json

 

{
"dynamic": {
"name": "DHCP_eth1",
"pettern": "dhcp@ethernet1"
}
}

 

レスポンス

201 Created

 

XML
リクエスト

POST /api/v2/acl_dynamic_v4/dynamic/
Content-Type: application/xml

 

<acl_dynamic_v4>
<dynamic>
<name>DHCP_eth1</name>
<pettern>dhcp@ethernet1</pettern>
</dynamic>
</acl_dynamic_v4>

 

レスポンス

201 Created

 

全IPv4アクセスリストダイナミック設定の取得

メソッド URI
GET /api/v2/acl_dynamic_v4/dynamic/
JSON
リクエスト

GET /api/v2/acl_dynamic_v4/dynamic/
Accept: application/json

 

レスポンス

200 OK
Content-Type: application/json

 

{
"dynamic": [
{
"name": "DHCP_eth1",
"pettern": "dhcp@ethernet1"
},
{
"name": "MAPE_map0",
"pettern": "mape-rule@map0"
}
]
}

 

XML
リクエスト

GET /api/v2/acl_dynamic_v4/dynamic/
Accept: application/xml

 

レスポンス

200 OK
Content-Type: application/xml

 

<acl_dynamic_v4>
<dynamic>
<name>DHCP_eth1</name>
<pettern>dhcp@ethernet1</pettern>
</dynamic>
<dynamic>
<name>MAPE_map0</name>
<pettern>mape-rule@map0</pettern>
</dynamic>
</acl_dynamic_v4>

 

TEXT/PLAIN
リクエスト

GET /api/v2/acl_dynamic_v4/dynamic/
Accept: text/plain

 

レスポンス

200 OK
Content-Type: text/plain

 

ip access-list-dynamic DHCP_eth1 dhcp@ethernet1
ip access-list-dynamic MAPE_map0 mape-rule@map0

 

IPv4アクセスリストダイナミック設定の更新

メソッド URI
PUT /api/v2/acl_dynamic_v4/dynamic/{NAME}
JSON
リクエスト

PUT /api/v2/acl_dynamic_v4/dynamic/DHCP_eth1
Content-Type: application/json

 

{
"name": "DHCP_eth1",
"pettern": "dhcp@ethernet1",
"prefix": "0.0.0.0/29"
}

 

レスポンス

204 No content

 

XML
リクエスト

PUT /api/v2/acl_dynamic_v4/dynamic/DHCP_eth1
Content-Type: application/xml

 

<dynamic>
<name>DHCP_eth1</name>
<pettern>dhcp@ethernet1</pettern>
<prefix>0.0.0.0/29</prefix>
</dynamic>

 

レスポンス

204 No content

 

IPv4アクセスリストダイナミック設定の取得

メソッド URI
GET /api/v2/acl_dynamic_v4/dynamic/{NAME}
JSON
リクエスト

GET /api/v2/acl_dynamic_v4/dynamic/DHCP_eth1
Accept: application/json

 

レスポンス

200 OK
Content-Type: application/json

 

{
"name": "DHCP_eth1",
"pettern": "dhcp@ethernet1",
"prefix": "0.0.0.0/29"
}

 

XML
リクエスト

GET /api/v2/acl_dynamic_v4/dynamic/DHCP_eth1
Accept: application/xml

 

レスポンス

200 OK
Content-Type: application/xml

 

<dynamic>
<name>DHCP_eth1</name>
<pettern>dhcp@ethernet1</pettern>
<prefix>0.0.0.0/29</prefix>
</dynamic>

 

TEXT/PLAIN
リクエスト

GET /api/v2/acl_dynamic_v4/dynamic/DHCP_eth1
Accept: text/plain

 

レスポンス

200 OK
Content-Type: text/plain

 

ip access-list-dynamic DHCP_eth1 dhcp@ethernet1 0.0.0.0/29

 

IPv4アクセスリストダイナミック設定の削除

メソッド URI
DELETE /api/v2/acl_dynamic_v4/dynamic/{NAME}
リクエスト

DELETE /api/v2/acl_dynamic_v4/dynamic/DHCP_eth1

 

レスポンス

204 No content

 

パラメータ

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

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

  • パラメータ表の説明文中のデータタイプについて
    A.B.C.D … IPv4アドレス
    A.B.C.D/M … IPv4プレフィックスおよびマスク長

 

パラメータおよびレベル 説明
Lv.1 Lv.2 Lv.3
acl_dynamic_v4 dynamic name Dynamic ACL名
pattern フィルタパターン(ex. dhcp@ethernet1)
prefix プレフィックス … A.B.C.D/M
host ホスト … A.B.C.D